$ show Anduin2017/HowToCook
Anduin2017/HowToCook 是一个由社区驱动的中文菜谱仓库,旨在为程序员提供形式化、可量化的烹饪指南。该仓库包含超过 700 个 Markdown 菜谱文件,按照菜系(素菜、荤菜、水产、早餐、主食等)组织,每个菜谱都遵循严格的模板格式,包含精确的计量、步骤和卡路里预估。仓库还包含辅助工具如自动 README 生成器(readme-generate.js)、Markdown 质量检查脚本(manual_lint.js)以及 GitHub Actions CI 流程,确保菜谱的一致性和可读性。虽然本质上是一个文档/数据仓库,但其组织方式、质量控制工具和社区协作模式使其成为一个高质量的开源数据项目,方便被其他应用(如菜谱API、小程序)消费。
The LLM identified 3 files worth highlighting for reuse:
一个用于检查菜谱 Markdown 文件格式和规范的自定义 linter。它验证标题格式、必需章节、计量单位(如禁止使用“适量”、“勺”等模糊单位)、图片引用存在性、烹饪难度和卡路里字段等。这个脚本可以轻松提取并应用于任何基于 Markdown 的菜谱仓库,确保数据质量。它展示了非平凡的验证逻辑和正则表达式使用,是高内聚低耦合的实用工具。
一个自动生成 README.md 菜谱索引的 Node.js 脚本。它遍历 dishes 目录,按分类(素菜、荤菜等)收集所有 .md 文件,并生成带超链接的目录。该脚本是可配置的(通过 ignorePaths),并能与 CI 工作流集成。对于任何需要自动维护文档索引的文档项目来说,这是一个可复用的模式。
菜谱的标准模板文件。它定义了严格的格式:标题、图片、简介、烹饪难度、卡路里、必备原料、计算部分(带份数调整)、操作步骤(有序列表)、附加内容。这个模板是确保所有菜谱一致性和机器可读性的核心。它本身即可被其他菜谱项目作为最佳实践复用。