在项目目录运行 bash scripts/preview.sh,然后打开 http://localhost:3000/,首页显示序文,可通过食单中的菜系链接进入相应页面。例如:
- 川菜入口:http://127.0.0.1:3000/sichuan/intro.html
- 鸡类食单:http://127.0.0.1:3000/sichuan/鸡类/index.html
- 宫保鸡丁:http://127.0.0.1:3000/sichuan/鸡类/宫保鸡丁.html
脚本会使用 .mdbook-version 指定的 mdBook(首次下载到 .tools/),生成全站页面并启动自动刷新预览。终端按 Ctrl+C 停止。
手机局域网预览:先停止正在运行的预览,再运行 MENU_PREVIEW_HOST=0.0.0.0 bash scripts/preview.sh。手机连接同一局域网,在浏览器中打开 http://电脑的局域网IP:3000/;页面同样支持自动刷新。
全站统一使用菜系入口、分类食单和菜谱阅读布局。目录默认全部展开,也可手动收起,上级条目随滚动逐级悬停;搜索时隐藏目录树,结果直接显示在搜索框下方。修改 src/assets/layout.css、src/assets/navigation.js 或页面内容后,浏览器自动刷新。按来源版本跳转后,可通过地址中的锚点分享具体段落。
顶部与侧栏共用已加载的目录数据,按菜名或分类标题进行子串查找,不扫描正文,不加载全文索引。两处每次最多显示 50 条结果,并显示菜系与分类路径。顶部支持 / 或 s 打开、方向键选择、Enter 跳转、Esc 关闭,也支持 ?search=关键词 链接;中文输入法组合期间暂缓更新。
页面由 scripts/build_pages.py 生成,分类和菜名读取 src/SUMMARY.md。Notebook 的生成流程也共用这些模板。可运行 python3 scripts/build_pages.py --check 检查页面是否已同步;构建后运行 python3 scripts/validate_book.py 检查页面、链接和资源。生成过程保留菜谱各来源版本的原文,已有的空白菜谱保持为空。
推送 master 分支后,GitHub Actions 会生成页面、构建并检查链接,再部署到 GitHub Pages。
原始字体保存在 fonts/,网页通过三份 WOFF2 子集加载原有字形,继续使用 font-display: block。原始 TTF 不会复制到网站发布目录。
每次 mdbook build 或 mdbook serve 都会在 include 展开后自动统计正文、标题、目录及固定界面的用字,生成 src/assets/fonts/ 和 src/assets/fonts.css。新增文字会自动更新相应字体;没有变化的字体复用缓存。预览也会监测 fonts/ 与 scripts/ 的变化。字体文件名包含内容哈希,字体更新后会使用新的 URL。
预览脚本会检查固定版本的依赖,必要时在 .tools/font-env 创建隔离环境。手工构建时,可先在项目目录执行 source scripts/font_env.sh,再运行 mdBook;也可在自己的 Python 环境中安装 requirements-fonts.txt。
构建后运行 python3 scripts/build_fonts.py --check 可检查字体文件及字符覆盖;scripts/validate_book.py 也包含此校验,并检查发布目录中不再包含 TTF。src/assets/fonts/manifest.json 记录各字体的体积、字符覆盖和原字库未收录的字符,后者继续使用原有备用字体。生成文件已加入 .gitignore,无需手工修改或提交。
- 北京饭店名菜谱
- 上海家常菜_李伯荣
- 上海菜图文全解百例_李伯荣
- 京帮菜150款_胡丽妹
- 北京清真菜谱
- 安徽风味_方乃根
- 成都锦江宾馆菜谱_张德善
- 正宗川菜160种_陈松如
中餐的大菜系,指代那些具有完整技法系统、全面味型体系、成熟宴席传统、可以处理山河湖海中广博食材的技法传承。每个大菜系都有丰富的独创技法,可以对其它菜系产生相当程度的影响。大菜系虽起源于特定地区,但因其技法全面、技艺精湛,早在清末便开始通过有序的师徒传承向全国流转,成为中餐饮食文化的中坚力量。
中餐的小菜系,指代那些具有丰富多样的宴席和家常菜式、但食材选择和技法特点都相对局限于特定地理风俗的菜品集合。小菜系的技法不如大菜系全面,但往往有专精的技法独树一帜。
中餐的地方特色菜式,或地方自发,抑或吸收大菜系和小菜系中的成熟技法、因地制宜、顺应当地风俗而成。它既反映了中国地大物博带来的民生百态,也揭示了多元统一历史传统下的文化交融。
中餐的官府菜,是中餐私宴传统的写照。相比于地方特色菜式更偏向市井烟火,官府菜则勾勒了中国各地的特色宴席。与今天市民消费主导的餐厅文化不同,中餐的发展史中私宴传统与之并驾齐驱。它不只发展了中餐的技法、丰富了中餐的菜式,更让席间雅致的趣味润物无声地融入了中餐文化。