Chowdown 组件化食谱进阶指南：3 步组合复用你的经典配方

Chowdown 组件化食谱进阶指南：3 步组合复用你的经典配方

【免费下载链接】chowdownSimple recipes in Markdown format项目地址: https://gitcode.com/gh_mirrors/ch/chowdown

Chowdown 是一个用 Markdown 格式编写、基于 Jekyll 构建的纯文本食谱库，而它最迷人的地方，是支持「组件化食谱」：把饼底、馅料、顶料这类经典配方拆成独立组件，再像搭积木一样组合出全新菜品。这份指南将用 3 个简单步骤，带你掌握 Chowdown 组件化食谱的组合复用技巧，让辛苦整理的家传配方一份顶十份。

什么是 Chowdown 组件化食谱？

传统食谱把原料和步骤写死在同一个文件里，一旦「香草卡仕达馅」被三个甜品用到，就得复制三遍。Chowdown 的做法恰恰相反：它把「能被复用的部分」抽成组件（Component），存放在_components/目录；而_recipes/目录里的正式食谱，只需要声明自己用了哪些组件，页面就会自动把各部分渲染出来。

项目自带的红莓挞（Red Berry Tart）就是最标准的例子——它本身几乎没有原料列表，而是组合了三个组件：全麦饼干饼底、香草卡仕达馅、红莓顶料。

官方结构非常简单，核心只有两个目录、一个字段：

• _components/：存放可复用的组件配方
• _recipes/：存放组合后的正式食谱
• components字段：食谱 frontmatter 中声明组合关系的「胶水」

第 1 步：拆分经典配方，搭建你的组件库

组件化食谱的第一步，是找出你食谱里「可复用的部分」。比如 graham-cracker-crust.md 这样的全麦饼干饼底，既是红莓挞的底座，也能直接用于芝士蛋糕；vanilla-custard-filling.md 的香草卡仕达馅，单独盛一碗就是一道甜品。

拆分的规则很简单：把这类小配方放进_components/目录，frontmatter 保留常规的ingredients（原料）和directions（步骤），与普通食谱写法完全一致，不需要任何特殊标记。

这样做的收益立竿见影：饼底烤法改进后，所有用到它的组合食谱自动跟着升级，再也不用逐个文件修改。这正是「经典配方复用」的精髓。

第 2 步：新建组合配方，声明 components 字段

组件准备好之后，在_recipes/目录新建正式食谱，frontmatter 里不再写ingredients，改用components字段列出组件标题，并补上组装步骤。以官方示例 red-berry-tart.md 为例：

--- layout: recipe title: "Red Berry Tart" image: red-berry-tart.jpg components: - Graham Cracker Crust - Vanilla Custard Filling - Red Berry Dessert Topping directions: - 烤好饼底并放凉 - 制作卡仕达，倒入饼底 - 铺上红莓顶料 ---

注意一个关键点：components里的标题必须与组件文件中的title字段完全一致，大小写也不能错，这是组合能否生效的前提。正文区域则可以写一段介绍，交代这道菜的来历和亮点。

第 3 步：保存预览，自动渲染组合结果

组合关系写好之后，渲染完全交给模板完成。Jekyll 构建时，_layouts/recipe.html 会遍历site.components集合，按标题匹配每个组件，把原料、步骤、图片逐一渲染到页面上；_config.yml 中collections配置已经声明了components和recipes两个集合，无需额外改动。

在终端运行jekyll serve，访问本地地址即可预览：组合食谱的页面会先展示组装步骤，再依次渲染每个组件的完整配方，读者甚至可以照着单个组件单独制作。匹配不上的标题则会被静默跳过，所以第 2 步的命名规范格外重要。

组件化食谱进阶技巧

• 命名即契约：组件title是唯一的关联键，建议用小写连字符命名文件、用英文大写标题，避免复制粘贴时出现空格差异。
• 组件也能有图片：每个组件文件都可以通过 frontmatter 的image字段关联images/目录下的图片，渲染时会自动展示，观感大幅提升。
• 层层组合：组件本身也可以是组合食谱，比如「挞皮」先由「饼底 + 馅料」组成，再作为「红莓挞」的组件，实现多层复用。
• 善用营养数据：需要展示热量、碳水等信息时，可在食谱中加入nutrition字段，模板会调用 _includes/nutritional-information.html，字段定义见 _data/nutrients.yml。

总结：让经典配方真正沉淀下来

Chowdown 组件化食谱的本质，是把「配方」从一次性文档升级为可组合的资产：_components/是原料库，_recipes/是产品目录，components字段是连接两者的桥梁。按这 3 步拆解经典配方、声明组合关系、交给模板自动渲染，你就能用最少的重复劳动，把一个人的私藏变成整个家庭的菜谱系统。下次再想出新菜品，不妨先看看组件库里有什么——也许你离一道新招牌菜，只差一次「组合」而已。

【免费下载链接】chowdownSimple recipes in Markdown format项目地址: https://gitcode.com/gh_mirrors/ch/chowdown