diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 5ebb850fd7..87a29f57a2 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -14,4 +14,4 @@ jobs: - name: Install packages run: sudo gem install mdl - name: Lint markdown files - run: mdl *.md -r ~MD029,~MD036,~MD024 + run: mdl *.md -r ~MD009,~MD029,~MD036,~MD024 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 500e3fc273..3282004be2 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,7 +1,76 @@ -# 如何贡献 +# CONTRIBUTING Guide -直接修改\添加做菜指南并提交 Pull request 即可。 +## 如何贡献 + +直接修改/添加做菜指南并提交 Pull request 即可。 在写新菜谱时,请复制并修改已有的模板: [示例菜](./dishes/template/示例菜/示例菜.md)。 记得在提交 Pull Request 前同样更新一下 Readme.md 里的引用。 + +## 内容规范 + +**菜谱提交者无需阅读此内容规范。以下内容已经以简明易懂的方式包含在示例模板中。项目的维护者会在你的PR中提出建议, 并协助修改。** + +本项目的 Motivation 要求菜谱满足以下规范,不符合规范的菜谱将不会被合并到代码库中。项目的维护者维护此文档, 作为正式的标准与共识。 + +1. 每一道菜谱至少应包含`原材料与工具`, `计算`, `操作`三部分内容。 + +`原材料与工具`应列出本菜品需要的除`假想已准备好的物品`外的所有原材料与厨具。 +`计算`应定量列出本菜品所需的原材料的量。(无论与人数是否相关) +`操作`应说明菜品的制作步骤。 + +2. 菜品的制作步骤应当明确(无歧义,non-ambiguous),并尽可能准确(accurate)。有歧义(ambiguous)的描述是不可接受的,而不准确(inaccurate)或不精确(imprecise)的描述是可以接受的。 + +> 不准确的菜谱会导致菜品口味有少许偏差,不明确的菜谱会导致做菜人的心态有明显不安。 + +举例:有歧义的描述 + +``` +# 解释:此处对于盐量的描述是有歧义的。 +# 因为对于某个数量的盐,用户无法得出确定的客观结论:此数量是否属于"少量"。 +加入少量盐 + +加入几滴耗油 +将锅加热至八分热 +撒上少许葱花 +煮至鸡肉断生 +``` + +举例:无歧义的描述 + +``` +# 解释:此处对于锅的温度的描述是不准确的(可能是200摄氏度左右的任何温度),但这个描述是无歧义的。 +# 因为对于锅的某个状态,用户可以进行水滴测试,并得出确定的客观结论:此状态要么符合要求,要么不符合要求。 +加热锅,直至"滴入几滴水时,水珠能够在锅上迅速滚动而不吸附" +加热锅,直至观察到莱顿弗罗斯特现象 + +加入5ml酱油 +等到水沸腾后 +继续煮,直到汤汁剩下二分之一 +煎至表面呈金黄色 +继续翻炒两分钟 + +# 食材所可能粘附的蛋液的量是确定的 +裹上蛋液 + +# 在'计算'中已提及将用到葱花的量 +撒上葱花 +``` + +考虑到现实因素,对于某些在家庭厨房中确实难以明确描述的因素,可以作为特例排除。例如 + +``` +# 在描述燃气灶火焰强度时 +文火, 小火, 中火, 大火 等 +# 在描述颜色时 +金黄色 等 +# 在描述硬度时 +变软 变硬 +``` + +3. 菜品的`制作步骤`应当完整(complete)。这意味着, 在执行完所有操作步骤后, 菜品已经被完成。 + +4. 菜品的`原材料与工具`应当完整(complete)。这意味着, 在执行操作步骤时, 没有用到`原材料与工具`中未提到的物品。 + + diff --git a/README.md b/README.md index adf74fae98..e4faa56db0 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ ## 如何贡献 -直接修改\添加做菜指南并提交 Pull request 即可。 +直接修改/添加做菜指南并提交 Pull request 即可。 在写新菜谱时,请复制并修改已有的模板: [示例菜](./dishes/template/示例菜/示例菜.md)。 @@ -49,6 +49,7 @@ * [清蒸生蚝](./dishes/home-cooking/清蒸生蚝.md) * [尖椒炒牛肉](./dishes/home-cooking/尖椒炒牛肉.md) * [小炒肉](./dishes/home-cooking/小炒肉.md) +* [洋葱炒猪肉](./dishes/home-cooking/洋葱炒猪肉.md) ### 早餐 @@ -57,6 +58,7 @@ * [果酱土司](./dishes/breakfast/吐司果酱.md) * [溏心蛋](./dishes/breakfast/溏心蛋.md) * [水煮玉米](./dishes/breakfast/水煮玉米.md) +* [微波炉蛋糕](./dishes/breakfast/微波炉蛋糕.md) ### 主食 @@ -67,11 +69,15 @@ * [炒方便面](./dishes/staple/炒方便面.md) * [老干妈拌面](./dishes/staple/老干妈拌面.md) * [醪糟小汤圆](./dishes/staple/醪糟小汤圆.md) -* [凉皮](./dishes/staple/凉皮.md) * [炒河粉](./dishes/staple/炒河粉.md) * [炸酱面](./dishes/staple/炸酱面.md) -* [速冻水饺](./dishes/home-cooking/速冻水饺.md) -* 手工饺子(等待大佬编写中……) +* 手工饺子(等待大佬编写中…… + +### 半成品加工 + +* [速冻汤圆](./dishes/semi-finished/速冻汤圆/速冻汤圆.md) +* [速冻水饺](./dishes/semi-finished/速冻水饺.md) +* [凉皮](./dishes/semi-finished/凉皮.md) ### 红烧菜系 @@ -82,7 +88,8 @@ * [米粥](./dishes/porridge/米粥.md) * [皮蛋瘦肉粥](./dishes/porridge/皮蛋瘦肉粥.md) -* [西红柿鸡蛋汤](./dishes/porridge/西红柿鸡蛋汤.md) +* [西红柿鸡蛋汤](./dishes/soup/西红柿鸡蛋汤.md) +* [金针菇汤](./dishes/soup/金针菇汤.md) ### 饮料 diff --git a/dishes/breakfast/3.8cm_spoon.jpg b/dishes/breakfast/3.8cm_spoon.jpg new file mode 100644 index 0000000000..37d53159f3 Binary files /dev/null and b/dishes/breakfast/3.8cm_spoon.jpg differ diff --git "a/dishes/breakfast/\345\276\256\346\263\242\347\202\211\350\233\213\347\263\225.md" "b/dishes/breakfast/\345\276\256\346\263\242\347\202\211\350\233\213\347\263\225.md" new file mode 100644 index 0000000000..a9de3af956 --- /dev/null +++ "b/dishes/breakfast/\345\276\256\346\263\242\347\202\211\350\233\213\347\263\225.md" @@ -0,0 +1,59 @@ +# 微波炉"叮"蛋糕 + +不必慌张, 你有十分充足的时间来准备, 可以根据心情加料, 大约需要 2min + +## 必备原料和工具 +- 微波炉 +- 能放进微波炉的容器 +- 黄油 +- 面粉 +- 泡打粉(不加吃着像饼) +- 鸡蛋 + +## 计算 + +- 鸡蛋🥚 1 个 +- 面粉🍚 2 凸勺 +- 泡打粉🍚 半平勺 +- 白(红)糖🍬 2 勺 +- 盐🧂 1/5 平勺 + +(口味可选) +- 咖啡粉☕ +- 巧克力🍫 +- 麦片🍿 +- 牛奶🥛 +- 坚果🥜 +- 饼干屑🍪 +- 香蕉🍌 +- 非黑暗料理🍆 + +## 操作 + +> **以下食材不要超过容器的3/4** +- 挖半个鸡蛋大的黄油放进容器, 在微波炉**加热15秒左右**至融化 +- 将**巧克力/香蕉** 融化/搅碎成 **颗粒/糊状** +- 打入一个鸡蛋并打散搅和 +- 2 凸勺白(红)糖(甜党可以多加些) (见附 4) +- 加入 1/5 平勺盐 (**如果后续的口味食材含盐需自己斟酌**) +- 加入半平勺泡打粉 +- 加入两大凸勺面粉(筋度没太大影响) + +- **加入任何喜欢的口味食材!**(坚果与饼干等干食材不是现在放) + +- 搅和至看不见干粉的稠酸奶状 +- 加入可选的干燥食材(不包括冲泡粉)在顶端 +> **以上食材不要超过容器的3/4** + +- 夸赞一下自己🥰 +- 微波炉(高火)加热 **1分钟** (至蓬松蛋糕形态) +- 取出杯子(烫手啊啊啊啊↑)并拍朋友圈就可以吃了 + +## 附加内容 + +- 在夸赞自己之前的操作可以重复多遍做出更大的蛋糕 +- 泡打粉用来让蛋糕更蓬松 大多不含铝 几块钱一包 可以买了在家备着 +- **食材不要超过容器的3/4!!** +- 此指南勺子标准大小宽 4 厘米尖勺 +![勺子](./3.8cm_spoon.jpg) +- 如果您遵循本指南的制作流程而发现有问题或可以改进的流程,请提出 Issue 或 Pull request。 diff --git "a/dishes/condiment/\346\262\271\346\263\274\350\276\243\345\255\220.md" "b/dishes/condiment/\346\262\271\346\263\274\350\276\243\345\255\220.md" index bfb0ca4ad1..552ff8da7b 100644 --- "a/dishes/condiment/\346\262\271\346\263\274\350\276\243\345\255\220.md" +++ "b/dishes/condiment/\346\262\271\346\263\274\350\276\243\345\255\220.md" @@ -20,7 +20,8 @@ - 拿出蒜头掰 2 个小蒜头去皮 - 拿出砧板剁碎小蒜头、小米椒 - 拿出碗倒入花生油 -- 拿出铁锅将碗内的油放入加热 2 分钟 +- 拿出铁锅将碗内的油放入加热 2 分钟(菜籽油烧至冒烟) - 此时是空碗 -- 往空碗加入干辣椒面、白芝麻、蒜末、小米椒、盐 -- 关火将锅内热油倒入碗内并用勺搅拌即可 +- 往空碗加入干辣椒面、白芝麻、蒜末、小米椒、盐作为"调料" +- 关火将油温冷却至 210 摄氏度 +- 将锅内热油倒入碗内并用勺搅拌即可(可以在 165 摄氏度时加入同样"调料"的碗最后进行混合进行增辣) diff --git "a/dishes/home-cooking/\346\264\213\350\221\261\347\202\222\347\214\252\350\202\211.md" "b/dishes/home-cooking/\346\264\213\350\221\261\347\202\222\347\214\252\350\202\211.md" new file mode 100644 index 0000000000..088cea2142 --- /dev/null +++ "b/dishes/home-cooking/\346\264\213\350\221\261\347\202\222\347\214\252\350\202\211.md" @@ -0,0 +1,55 @@ +# 洋葱炒猪肉的做法 + +咸中带甜 +简单上手 +一不小心可能让你多吃一碗饭 +一般只需 15 分钟即可完成 + +## 必备原料和工具 + +- 洋葱 +- 猪肉片 +- 蕃茄酱 +- 麻油 + +## 计算 + +每份: + +食材 + +- 洋葱 一颗 (是主角,喜欢吃洋葱可以多半颗~一颗) +- 猪肉 (250g) +- 蒜头 (3 瓣) + +调味料 + +- 食用油 (15ml) +- 黑胡椒 (1.25g) +- 酱油 (30ml) +- 糖 (15g) +- 麻油 (5ml) +- 番茄酱 (15ml) +- 料酒 (15ml) + +备注:可以考虑购买[茶匙,大匙](https://www.sohu.com/a/127293243_570657)来精准确定用料的量。 + +## 操作 + +- 洋葱切片,猪肉,蒜头拍碎,以及混合上述调味料备用 +- 炒锅内倒入 1 大匙食用油(等待 10 秒让油温升高),倒入猪肉 +- 炒至变色后下蒜头炒香盛起备用 +- 原锅下洋葱翻炒 3~4 分钟后加入调味料炒匀 +- 下刚盛起备用的猪肉翻炒至猪肉熟后 +- 带猪肉熟后再翻炒 1、2 分钟即可起锅 + + +## 附加内容 + +- 猪肉可选猪肩肉片或是切好的肉丝看个人喜好 + +### 参考资料 + +- [爱料理](https://icook.tw/) + +如果您遵循本指南的制作流程而发现有问题或可以改进的流程,请提出 Issue 或 Pull request 。 diff --git "a/dishes/staple/\345\207\211\347\232\256.md" "b/dishes/semi-finished/\345\207\211\347\232\256.md" similarity index 100% rename from "dishes/staple/\345\207\211\347\232\256.md" rename to "dishes/semi-finished/\345\207\211\347\232\256.md" diff --git "a/dishes/home-cooking/\351\200\237\345\206\273\346\260\264\351\245\272.md" "b/dishes/semi-finished/\351\200\237\345\206\273\346\260\264\351\245\272.md" similarity index 96% rename from "dishes/home-cooking/\351\200\237\345\206\273\346\260\264\351\245\272.md" rename to "dishes/semi-finished/\351\200\237\345\206\273\346\260\264\351\245\272.md" index 18a81a0702..e3a4789b3c 100644 --- "a/dishes/home-cooking/\351\200\237\345\206\273\346\260\264\351\245\272.md" +++ "b/dishes/semi-finished/\351\200\237\345\206\273\346\260\264\351\245\272.md" @@ -19,11 +19,20 @@ ### 烧开水 * 中火,将水倒入锅中,静候水煮沸。 + +### 下水饺 + * 将饺子倒入锅中。 * 倒入锅前可以适当用水过一下。 + +### 搅拌 + * 倒入饺子后,抓住锅柄轻轻摇晃锅使饺子移动以避免粘锅上撕破皮。 * 如果饺子太多可以用铲子搅水,但要注意不要铲到饺子上。 * 频率不需要太高,平均每 `30` 秒摇 `3` 秒,饺子浮起后不需要再做此步。 + +### 盛饺子 + * 所有饺子浮起后用铲子把饺子铲入盘或碗中,装盘后即可食用。 ## 附加内容 diff --git "a/dishes/semi-finished/\351\200\237\345\206\273\346\261\244\345\234\206/\351\200\237\345\206\273\346\261\244\345\234\206.jpg" "b/dishes/semi-finished/\351\200\237\345\206\273\346\261\244\345\234\206/\351\200\237\345\206\273\346\261\244\345\234\206.jpg" new file mode 100644 index 0000000000..d1badaf7de Binary files /dev/null and "b/dishes/semi-finished/\351\200\237\345\206\273\346\261\244\345\234\206/\351\200\237\345\206\273\346\261\244\345\234\206.jpg" differ diff --git "a/dishes/semi-finished/\351\200\237\345\206\273\346\261\244\345\234\206/\351\200\237\345\206\273\346\261\244\345\234\206.md" "b/dishes/semi-finished/\351\200\237\345\206\273\346\261\244\345\234\206/\351\200\237\345\206\273\346\261\244\345\234\206.md" new file mode 100644 index 0000000000..d436377984 --- /dev/null +++ "b/dishes/semi-finished/\351\200\237\345\206\273\346\261\244\345\234\206/\351\200\237\345\206\273\346\261\244\345\234\206.md" @@ -0,0 +1,31 @@ +# 速冻汤圆的做法 + +![速冻汤圆](./速冻汤圆.jpg) + +速冻汤圆是一道简单易做的菜。一般初学者只需要 6 分钟即可完成。 + +## 必备原料和工具 + +- 速冻汤圆 +- 微波炉 + +## 计算 + +每份: + +- 速冻汤圆:11 个。数量取决于碗的大小。保证放入的汤圆最高不超过碗高度 - 5mm。 + +## 操作 + +- 取出速冻汤圆,放入碗中。 +- 倒入开水,直至浸没汤圆。 +- 微波炉高火 4 分钟。 +- 假如汤圆均已吸水膨胀,则已熟。 +- 如果没熟,再加热 1 分钟。 + +## 附加内容 + +- 注意先加汤圆再加热水,不要颠倒,不然汤圆倒入热水可能会溅出烫伤。以及无法控制水面高度可能溢出。 +- 假如微波炉里碗太烫无法取出,可以用毛巾,或者某些微波炉可以连托盘一起取出。 + +如果您遵循本指南的制作流程而发现有问题或可以改进的流程,请提出 Issue 或 Pull request 。 diff --git "a/dishes/porridge/\350\245\277\347\272\242\346\237\277\351\270\241\350\233\213\346\261\244.md" "b/dishes/soup/\350\245\277\347\272\242\346\237\277\351\270\241\350\233\213\346\261\244.md" similarity index 94% rename from "dishes/porridge/\350\245\277\347\272\242\346\237\277\351\270\241\350\233\213\346\261\244.md" rename to "dishes/soup/\350\245\277\347\272\242\346\237\277\351\270\241\350\233\213\346\261\244.md" index 716fc5f529..221c7b9e1b 100644 --- "a/dishes/porridge/\350\245\277\347\272\242\346\237\277\351\270\241\350\233\213\346\261\244.md" +++ "b/dishes/soup/\350\245\277\347\272\242\346\237\277\351\270\241\350\233\213\346\261\244.md" @@ -33,4 +33,4 @@ 味素可加可不加。 -如果您遵循本指南的制作流程而发现有问题或可以改进的流程,请提出 Issue 或 Pull request 。 \ No newline at end of file +如果您遵循本指南的制作流程而发现有问题或可以改进的流程,请提出 Issue 或 Pull request 。 diff --git "a/dishes/soup/\351\207\221\351\222\210\350\217\207\346\261\244.md" "b/dishes/soup/\351\207\221\351\222\210\350\217\207\346\261\244.md" new file mode 100644 index 0000000000..22ce98ce5d --- /dev/null +++ "b/dishes/soup/\351\207\221\351\222\210\350\217\207\346\261\244.md" @@ -0,0 +1,27 @@ +# 金针菇汤的做法 + +## 必备原料和工具 + +- 金针菇 +- 鸡蛋(如需要) + +## 计算 + +每份: + +- 金针菇 400-500 克 (市场里面售卖的一袋即可) +- 食盐 15 克 +- 味精 5 克 + +## 操作 +1. 金针菇徒手掰散,越散越好**不然容易藏牙**,洗净备用。 +2. 用菜刀或者水果刀将上述金针菇段段切,可依据个人喜好,但长度不宜超过 5 cm。 +3. 将金针菇放入锅中,加水没过约食材总高度 1.1 倍,沸腾后**等待 3 分钟**。 +4. 加入味精和食盐并搅拌。 +5. 继续加热约 30 秒,关火装盘。 + +## 附加内容 +- 如果喜欢在汤里加入鸡蛋,可在步骤 3 中水沸腾之后将打散的鸡蛋液倒入锅中。 +- 出锅后可加入 3-4 滴香油(或者麻油)增香。 + +如果您遵循本指南的制作流程而发现有问题或可以改进的流程,请提出 Issue 或 Pull request 。 diff --git "a/dishes/staple/\347\203\231\351\245\274/\347\203\231\351\245\274.md" "b/dishes/staple/\347\203\231\351\245\274/\347\203\231\351\245\274.md" index 9ae70e9e98..d85cc7ce70 100644 --- "a/dishes/staple/\347\203\231\351\245\274/\347\203\231\351\245\274.md" +++ "b/dishes/staple/\347\203\231\351\245\274/\347\203\231\351\245\274.md" @@ -4,7 +4,7 @@ * 油 * 面粉 -* 电饼档 +* 电饼铛 ## 计算 @@ -19,10 +19,10 @@ * 将 400g 面粉倒入盆中,一半用凉水和面,一半用热水和面,搅拌成面絮,用手揉成团。用保鲜膜封起来,醒面 40 分钟 * 离醒面完成时间还有 10 分钟时,请查看[小技巧](../../condiment/油酥.md)中的油酥做法(热油酥效果更好) * 醒好的面不用揉,稍微摁一下,用一横刀一竖刀将其分成四份。 -* 搓圆,擀开,擀成与电饼档大小差不多的饼,取 1/4 的油酥,将饼表面涂抹均匀 +* 搓圆,擀开,擀成与电饼铛大小差不多的饼,取 1/4 的油酥,将饼表面涂抹均匀 * 沿饼的半径切开,从外圈将其卷成圆锥形,然后将圆锥尾部捏好,防止油酥外漏。 -* 按压面饼圆锥尖的地方,将其压扁,然后再次擀成与电饼档大小差不多的面饼(厚度约为 3mm) -* 将电饼档预热,涂上凉油(热锅凉油),将擀好的饼放入电饼档中,将饼的上方也刷点油,涂抹均匀(锁住水分),盖上盖子 +* 按压面饼圆锥尖的地方,将其压扁,然后再次擀成与电饼铛大小差不多的面饼(厚度约为 3mm) +* 将电饼铛预热,涂上凉油(热锅凉油),将擀好的饼放入电饼铛中,将饼的上方也刷点油,涂抹均匀(锁住水分),盖上盖子 * 大火烙一分钟,打开盖子,将饼翻个面再烙一分钟 * 重复以上动作,完成饼的烙制 diff --git "a/tips/learn/\347\202\222\344\270\216\347\205\216.md" "b/tips/learn/\347\202\222\344\270\216\347\205\216.md" index 92511b61cf..19b323cee8 100644 --- "a/tips/learn/\347\202\222\344\270\216\347\205\216.md" +++ "b/tips/learn/\347\202\222\344\270\216\347\205\216.md" @@ -8,7 +8,7 @@ ### 注意事项 * 使用普通金属锅存在食材粘锅的风险。炒菜时倒入足量的油并及时翻炒菜品可以避免粘锅。菜品翻炒时加入少量水也可避免粘锅。 -* 使用不粘锅煎炒食物不会粘锅。不粘锅的功能来源于其内壁上的涂层。**金属锅铲会划伤涂层。使用不粘锅时应使用木制锅铲以避免损坏涂层。** +* 使用不粘锅煎炒食物不会粘锅。不粘锅的功能来源于其内壁上的涂层。**金属锅铲会划伤涂层。使用不粘锅时应使用木制或硅胶锅铲以避免损坏涂层。** ### 流程 diff --git "a/tips/learn/\350\222\270.md" "b/tips/learn/\350\222\270.md" index e4a13db9dd..19a8f4cc72 100644 --- "a/tips/learn/\350\222\270.md" +++ "b/tips/learn/\350\222\270.md" @@ -11,3 +11,5 @@ #### 注意事项 * 由于热源为水蒸气,较低的蒸屉中的食物底部可能被水浸湿。可将蒸笼布放在食物底下以避免这种情况。用筷子搭个放食物的简易支架也可以。 +* 可以利用智能设备设置 计时器,提醒关火,以防忘记以致烧干。 +* 在使用蒸笼制作食品的过程中,需要注意底部区域的剩余水量,避免干锅从而造成安全问题。 diff --git "a/tips/learn/\351\253\230\345\216\213\345\212\233\351\224\205.md" "b/tips/learn/\351\253\230\345\216\213\345\212\233\351\224\205.md" index 25681bff5f..0ecd573127 100644 --- "a/tips/learn/\351\253\230\345\216\213\345\212\233\351\224\205.md" +++ "b/tips/learn/\351\253\230\345\216\213\345\212\233\351\224\205.md" @@ -1,12 +1,14 @@ # 蒸(米)/炖(使用电饭煲/高压锅/电压力锅) -## (6)流程 +## 流程 * 食材和水放入内胆后盒盖,**确保锅体密封**,加热。 * 切换至保温状态后,**通过排气阀将锅内蒸汽排空方可开盖** -### e.注意事项 +### 注意事项 * **水蒸气很烫,不要凑到排气阀上。** * 烹饪**流质食物**的过程中,**不要手动排气**,小心喷溅。 -* 开盖前需确认蒸气已排空。开盖时小心蒸气烫伤。 +* 烹饪部分菜系(如汤类)手动放气**可能会影响食物的味道以及口感**。 +* 开盖前需确认蒸气已排空。开盖时请勿一次性全部打开,尤其是**不要对着人正面开盖**,以免蒸气烫伤。 +* tips:从侧面开盖是一种不错的选择。