HowToCook 菜谱模板编写指南：基于示例菜模板构建精准可复现的菜谱

文档教程【免费下载链接】HowToCookProgrammers guide about how to cook at home.项目地址https://gitcode.com/GitHub_Trending/ho/HowToCook点击查看免费下载本篇指南以开源仓库 HowToCook程序员做饭指南中的 示例菜模板 为核心系统讲解该仓库菜谱文件的统一结构、五星难度分级体系、原料计量规范与操作步骤的措辞约束并结合仓库内真实菜谱与配套文档印证每一条规则的落地方式。读完本文你将掌握 HowToCook 的菜谱编写范式能够按同一套形式语言提交一份结构完整、可复现、可被社区审查的新菜谱。模板在项目中的定位HowToCook 的 README 明确说明了项目动机传统菜谱写法千奇百怪经常中间莫名出来一些材料对习惯形式语言的程序员极不友好。因此项目主张用更清晰精准的描述整理常见菜的做法并把菜谱文件组织为Markdown 文档、按分类目录存放的纯文本仓库。对于贡献者README 给出的核心路径是针对发现的问题直接修改并提交 Pull request写新菜谱时复制并修改已有的菜谱模板即本指南的主角 dishes/template/示例菜/示例菜.md。也就是说示例菜模板并不是一道真实的菜而是一份菜谱的形式规范 示例填充仓库中 200 道菜谱如 日式咖喱饭、温泉蛋都是它的实例化产物。模板内部大量!-- 注释 --承载着规范说明提交 Pull request 前必须全部删除只保留正文结构。模板的整体结构一览一份合格的菜谱由以下章节按固定顺序组成标题菜名的做法成品图与菜品简介可选配图预估烹饪难度、预估卡路里## 必备原料和工具## 计算## 操作## 附加内容结尾固定的贡献提示语句模板通过 HTML 注释给出了每条规则的约束与示例下面逐章拆解。编写总则标题、空格与空行规范模板开头的注释规定了三条全局性硬约束标题必须是菜名的做法且与文件名一致。例如模板文件名为示例菜.md标题即# 示例菜的做法真实菜谱 日式咖喱饭.md 的标题为# 日式咖喱饭的做法一一对应。这一约定保证了菜谱目录索引与文档标题的可机械校验。中文与英文或数字之间必须有且仅有一个空格。如预估卡路里1265 大卡、等待 10 秒、原料咖喱块 115g中英文之间均以单空格分隔保证渲染排版与检索的一致性。标题与正文之间必须有且仅有一个空行维持 Markdown 解析与阅读体验的稳定。难度与基础信息要素五星烹饪难度分级模板要求每道菜给出预估烹饪难度其含义由模板注释中的 1 至 5 星定义表明确规定星级定位预计完成时长适用人群★无特别困难步骤原料简单混合烹饪即可约 5 分钟完全没有做饭经验的人也能做出像模像样的效果★★步骤非常简单不太需要烹饪经验约 10 分钟无经验者可照步骤完成追求完美效果需一定练习★★★步骤不算太复杂需一定烹饪经验约 15 分钟有经验的厨师不难完成完美效果需经验与练习★★★★含很多复杂步骤需精妙掌握火候、时间、材料组合40 分钟以内有经验的厨师也需较多时间准备熟练后可做出美味效果★★★★★含很多复杂步骤需精妙技巧且非常容易出现失误可能 40 分钟以上即使有经验的厨师也需大量时间准备模板示例菜标注为预估烹饪难度★★★★与它土豆 咖喱块的多段炖煮流程相匹配温泉蛋 则标注★★★体现步骤简单但需温度控制的定位。难度等级应与下方操作章节的实际复杂度一致供读者快速判断是否适合当前经验水平。卡路里与简介模板还要求填写预估卡路里示例菜为1265 大卡并在标题后写一段简介说明菜的特点、营养价值、难度和预计制作时长。例如模板的示例文案示例菜是一道简单易做的菜。富含 DHA 和蛋白质。一般初学者只需要 3 小时即可完成。还有美容效果哦~。真实菜谱 温泉蛋.md 的简介则详细描述了口感蛋白半流动、蛋黄温润凝固、营养优质蛋白、卵磷脂、维生素与制作要点70℃ 水温、约半小时可作为更完整的简介范例。必备原料和工具与公共厨房约定对齐该章节用于列出必需原料让读者快速判断手边材料是否足够。模板注释强调了一条关键约定某些原料已经在厨房采购部分提及这里不要重复提及燃气灶、饮用水、锅、食用油、碗与盘子、筷子、炒勺、洗涤剂、抹布、钢丝球、菜刀。这里厨房采购部分指的是仓库顶层文档 tips/厨房准备.md它把燃气灶、饮用水、各类锅具、食用油、洗涤剂、案板、菜刀等视为每个厨房的默认基础设施把大葱、生姜、大蒜、花椒、八角、生抽、蚝油等列为高频使用、建议常备的材料。因此菜谱的原料清单只需列这道菜专属的原料避免重复与噪声。模板还给出了原料书写的三类技巧品牌推荐辅助决策如咖喱块推荐品牌好侍为不熟悉品类的读者降低选择成本可选原料显式标注如藤椒油可选明确非必需项原料粒度清晰逐项列出不混入操作过程才出现的材料。计算从模糊配方到可量化配比## 计算章节是精准可复现理念的核心。模板注释定义了两种情形大批量场景如食堂给全校学生做菜给出以人数/份数为自变量的计算公式固定菜量场景每份容量恒定直接给出一份的量。模板以第二种情形示范每份正好够 2 个人吃并列出咖喱块 115g土豆 2 个每个约 120g共约 240g食用油 10-15ml同时模板注释规定了三条计量硬约束大小不一的食材必须给出质量参考如土豆标注单重与总重可自行斟酌加量的食材必须给出建议范围如食用油 10-15ml禁止使用有大有小的容器作为单位一律使用毫升等固定单位避免一勺半碗这类不可复现的表述。真实菜谱 日式咖喱饭.md 正是以半盒好侍咖喱块115g为基准推算洋葱、土豆、胡萝卜、蒜头与肉的配比可直接印证模板的以主料定基准、其余成比例写法。操作面向可复现的步骤描述规范## 操作章节要求详细描述全部流程模板注释给出了三条措辞级约束禁止使用不精准词汇适量、少量、中量、适当等一律不允许出现必须给出数值或可验证的状态部分食材必须指明若步骤只用部分食材而非全部食材必须显式说明否则默认指全部准备好的原料等待步骤必须有判断标准凡需等待的步骤必须给出等待时间计算公式或结束步骤的判断标准。模板示例菜的 8 步操作完整示范了上述规则土豆去皮、切成不超过 4cm 的大块备用咖喱块切碎增加接触面积加速溶解备用热锅锅内放入 10ml - 15ml 食用油等待 10 秒让油温升高放入土豆保持翻炒至土豆变软可以用筷子确认加水没过所有食材沸腾后将火调小等待 15 - 20 分钟关火加咖喱并搅拌等待直至咖喱融化再开火缓慢搅拌 10 分钟防止糊锅在外观呈粘稠状态后关火盛盘注意每个状态判据土豆变软、外观呈粘稠状态都伴随可执行的操作筷子确认、目视判断每个时长都是具体数字且步骤间通过关火再开火明确切换火候——这正是模板所追求的形式语言式描述。对比 日式咖喱饭.md 的快速翻炒至肉表面变白翻炒至洋葱变透明状等表述可见同一套状态判据体系在真实菜谱中的延续。附加内容与结尾固定语句## 附加内容用于补充注意事项、参考资料、安全须知等。模板给出了一个典型的安全示例操作时需注意观察沸腾的水位线如发现低于 2/3 的食材应加热水至没过食材。真实菜谱 日式咖喱饭.md 同样沿用了这条水位线规则并额外补充了冷藏后加热的两种方法微波炉高火 2-3 分钟、锅加热需额外加 50ml 水并保持搅拌、可选的配菜做法以及指向仓库内其他菜谱的交叉链接如 太阳蛋、电饭煲蒸米饭——交叉引用同一仓库内的既有菜谱是增强菜谱间复用价值的推荐做法。模板还要求每篇菜谱必须保留下面的文字作为结尾如果您遵循本指南的制作流程而发现有问题或可以改进的流程请提出 Issue 或 Pull request 。这句话将读者反馈与仓库的 Issue / Pull request 协作机制闭环是所有菜谱的固定收尾。模板到真实菜谱一次实战对照以仓库中与模板原料几乎同源的 日式咖喱饭.md 为对照可以看到模板要素在真实菜谱中的完整落地模板要素日式咖喱饭的实现标题与文件名一致日式咖喱饭的做法 ↔日式咖喱饭.md简介描述口感、营养、耗时约 1 小时、冷藏后风味更佳难度与卡路里★★★★/730 大卡必备原料咖喱块推荐好侍、土豆、胡萝卜、洋葱、肉、蒜头副食材单列可选计算以半盒咖喱块115g为基准给出各食材定量操作分食材准备 / 烧煮 / 冷藏加热三小节每步带状态判据附加内容水位线提醒、流程 Mermaid 图、成品图、参考资料、固定结尾提交前的检查清单综合模板注释与 README 的贡献流程提交一份新菜谱前应逐项核对删除全部 HTML 注释模板中的规范说明注释在 Pull request 前必须清除仅保留正文标题与文件名一致且为菜名的做法格式格式合规中文与英文/数字之间有且仅有一个空格标题与正文之间有且仅有一个空行章节齐全必备原料和工具、计算、操作、附加内容、结尾固定语句完整措辞精准无适量、少量等模糊词原料有质量参考或建议范围等待步骤有明确判据与公共约定对齐不在原料清单中重复 厨房准备 已默认的基础设施交叉链接使用仓库根相对路径如从菜谱链接到 如何洗碗、电饭煲蒸米饭 等既有文档确保仓库内链接可解析。按照这套规范产出的菜谱既是照着做就能复现的烹饪指南也是可被社区持续审查、修正和复用的结构化文档——这正是 HowToCook 将菜谱视为代码、用形式语言约束烹饪描述的核心设计。赞分享文档教程【免费下载链接】HowToCookProgrammers guide about how to cook at home.项目地址https://gitcode.com/GitHub_Trending/ho/HowToCook点击查看免费下载相关推荐告别授权费焦虑一条从零到能用SolidWorks的完整路线告别授权费焦虑一条从零到能用SolidWorks的完整路线 你是不是也遇到过这样的场景课程作业或公司项目需要三维建模同学同事都在用SolidWorks你从一份烤茄子菜谱看 RAG 菜谱数据集的结构模板与父子分块设计从一份烤茄子菜谱看 RAG 菜谱数据集的结构模板与父子分块设计 在 Datawhale all in rag 仓库的「尝尝咸淡 RAG 系统」实战项目中 da教程人工智能大模型RAGHowToCook 菜谱实战香干芹菜炒肉的家常小炒标准化指南HowToCook 菜谱实战香干芹菜炒肉的家常小炒标准化指南 香干芹菜炒肉是 HowToCook 仓库中收录于荤菜 meat_dish https://li文档教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考