Merge branch 'Anduin2017:master' into master

.github/manual_lint.js

@@ -23,6 +23,10 @@ async function main() {
             dataLines.filter(line => line.includes('吧勺')).length) {
             errors.push(`文件 ${filePath} 不符合仓库的规范！勺 不是一个精准的单位！`);
         }
+        if (dataLines.filter(line => line.includes(' 杯')).length > 
+            dataLines.filter(line => line.includes('杯子')).length) {
+            errors.push(`文件 ${filePath} 不符合仓库的规范！杯 不是一个精准的单位！`);
+        }
         if (dataLines.filter(line => line.includes('适量')).length > 0) {
             errors.push(`文件 ${filePath} 不符合仓库的规范！适量 不是一个精准的描述！请给出克 g 或毫升 ml。`);
         }
@@ -74,7 +78,7 @@ async function main() {
         var mustHave = '如果您遵循本指南的制作流程而发现有问题或可以改进的流程，请提出 Issue 或 Pull request 。';
         var mustHaveIndex = dataLines.indexOf(mustHave);
         if (mustHaveIndex < 0) {
-            errors.push(`文件 ${filePath} 不符合仓库的规范！ 它没有包含必需的附加内容！`);
+            errors.push(`文件 ${filePath} 不符合仓库的规范！ 它没有包含必需的附加内容！，需要在最后一行添加模板中的【如果您遵循本指南的制作流程而发现有……】`);
         }
     }
 

.github/templates/mkdocs_template.yml

@@ -14,19 +14,20 @@ theme:
     - content.code.annotate
     # - content.tabs.link
     # - header.autohide
-    #- navigation.expand
-    #- navigation.indexes
+    # - navigation.expand
+    # - navigation.indexes
     - navigation.instant
     - navigation.sections
     - navigation.tabs
     - navigation.tabs.sticky
     - navigation.top
+    - navigation.footer
     - navigation.tracking
     - search.highlight
     - search.share
     - search.suggest
     - toc.follow
-    # # - toc.integrate
+    # - toc.integrate
   search_index_only: true
   palette:
     - media: "(prefers-color-scheme: light)"

.github/templates/readme_template.md

@@ -4,6 +4,7 @@
 [![License](https://img.shields.io/github/license/Anduin2017/HowToCook)](./LICENSE)
 [![GitHub contributors](https://img.shields.io/github/contributors/Anduin2017/HowToCook)](https://github.com/Anduin2017/HowToCook/graphs/contributors)
 [![npm](https://img.shields.io/npm/v/how-to-cook)](https://www.npmjs.com/package/how-to-cook)
+![Man hours](https://manhours.aiursoft.cn/r/github.com/anduin2017/howtocook.svg)
 
 最近在家隔离，出不了门。只能宅在家做饭了。作为程序员，我偶尔在网上找找菜谱和做法。但是这些菜谱往往写法千奇百怪，经常中间莫名出来一些材料。对于习惯了形式语言的程序员来说极其不友好。
 

.github/workflows/build.yml

@@ -23,7 +23,7 @@ jobs:
       - run: node ./.github/readme-generate.js
       # Lint issues first. (Without node_modules)
       - name: Lint markdown files
-        run: mdl . -r ~MD036,~MD024,~MD004,~MD029
+        run: mdl . -r ~MD036,~MD024,~MD004,~MD029,~MD013,~MD007
       - run: pip install -r requirements.txt
       - run: mkdocs build --strict
       # Do textlint fix.

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Install packages
         run: sudo gem install mdl
       - name: Lint markdown files
-        run: mdl . -r ~MD036,~MD024,~MD004,~MD029
+        run: mdl . -r ~MD036,~MD024,~MD004,~MD029,~MD013,~MD007
       - run: pip install -r requirements.txt
       - run: mkdocs build --strict
       - run: npm install

CODE_OF_CONDUCT.md

@@ -43,3 +43,9 @@
 HowToCook 将永远不插入广告，尽可能避免菜谱中的材料耦合特定品牌，尽可能使用容易取得的原材料。
 
 HowToCook 将永远不讨论变现问题。并且永远由社区驱动的维护下去。
+
+## 衍生产物
+
+目前社区中有许多基于 HowToCook 二次开发的小程序、App、网站等。
+
+HowToCook 仓库与任何衍生产物没有任何合作关系和知情义务。所有衍生产物的行为准则并不受 HowToCook 的行为准则约束，也不代表 HowToCook 仓库的价值观。

build.sh

@@ -7,16 +7,16 @@ tput setaf 2; echo "Cleaning up..."; tput sgr0
 rm ./node_modules -rf
 
 tput setaf 2; echo "Installing markdown lint"; tput sgr0
-gem install mdl
+gem install mdl || sudo gem install mdl
 
 tput setaf 2; echo "Generating new readme and mkdocs"; tput sgr0
 node ./.github/readme-generate.js
 
 tput setaf 2; echo "Running markdown lint to check issues."; tput sgr0
-mdl ./dishes ./tips -r ~MD036,~MD024,~MD004,~MD029
+mdl ./dishes ./tips -r ~MD036,~MD024,~MD004,~MD029,~MD013,~MD007
 
 tput setaf 2; echo "Installing python requirements..."; tput sgr0
-pip install -r requirements.txt
+pip install -r requirements.txt --break-system-packages
 
 tput setaf 2; echo "Builidng mkdocs and checking links..."; tput sgr0
 mkdocs build --strict

dishes/aquatic/干煎阿根廷红虾/干煎阿根廷红虾.md

@@ -0,0 +1,57 @@
+# 干煎阿根廷红虾的做法
+
+![示例菜成品](./干煎阿根廷红虾.jpg)
+
+平常所见到虾，只有赴“汤”蹈“火”后，才能红！阿根廷虾很任性，一红就红一辈子！跟它住在北极的亲戚，北极虾一样，天生红。
+
+阿根廷红虾，之所以这么红，是因为它生活在深海中，使得它体内含有丰富的碘、磷及珍贵的虾青素等微量元素，能够增强人体免疫力，还对心脏活动具有重要调节作用，可以减少血液中的胆固醇含量。
+
+阿根廷红虾，不仅个大肥美，虾肉白如凝脂，细腻腴滑，口感鲜嫩，味道甜香浓郁，是虾类料理界的宠儿，看着真让人垂(chao)涎(ji)欲(xiang)滴(chi)，快享受这大快朵颐的欢愉吧！
+
+## 必备原料和工具
+
+- 阿根廷红虾（选用了 Costco 的速冻虾）
+- 地中海海盐（研磨装）
+- 黑胡椒（研磨装）
+- 白葡萄酒
+- 生抽
+- 香菜
+- 柠檬
+- 洋葱
+- 生姜
+- 大蒜
+
+## 计算
+
+- 阿根廷红虾 2-3 只
+- 地中海海盐 5g
+- 黑胡椒（研磨装）
+- 白葡萄酒 20ml
+- 生抽 1ml
+- 香菜 3 片
+- 柠檬 1 片
+- 洋葱 10g
+- 生姜 10g
+- 大蒜 10g
+
+## 操作
+
+- 阿根廷红虾解冻，最好是提前一天从速冻取出放到冷藏里自然解冻，能更好保持风味和口感。Costco 买的是已经开背去虾线的，节省了不少时间
+- 解冻好的红虾洗净擦干备用，注意这里一定要沥干水分，赶时间可以用厨房用纸吸干水分
+- 生姜切片，洋葱切小方块，香菜洗干净后，叶茎分离，把香菜叶切碎，大蒜压碎切成小块碎末
+- 大火热锅，热锅后倒入两调羹橄榄油，等油温升高后，放入生姜片，洋葱块和香菜茎煸炒
+- 约一分钟后取出生姜，洋葱和香菜茎，弃用
+- 调中大火，放入红虾开始煎，注意所有虾需要单面都完整接触平底锅，煎约 2 分钟，同时给每只虾刷上一层油
+- 待底面虾壳有微微焦黄时翻面，并撒入大蒜碎末，轻微晃动平底锅使得受热均匀
+- 约 1 分钟后添加 20ml 白葡萄酒
+- 再煎 1 分钟后调中小火，均匀撒上一层盐和黑胡椒
+- 给每只虾滴上一滴生抽
+- 撒上香菜叶，装盘
+- 切好柠檬片，摆放到盘边即可
+
+## 附加内容
+
+- 柠檬可提升虾的口感，但偏酸，可以根据喜好添加，也可以不用
+- 趁热吃
+
+如果您遵循本指南的制作流程而发现有问题或可以改进的流程，请提出 Issue 或 Pull request 。

dishes/aquatic/微波葱姜黑鳕鱼.md

@@ -50,12 +50,12 @@
 
 ### 使用海鲈鱼、罗非鱼、大比目鱼或者龙脷鱼
 
-| 鱼类 | 是否切片 | 重量 | 微波时间 |
-| - | - | - | - |
-| 海鲈鱼 | 整条 | 450g | 6.5 分钟 |
-| 罗非鱼 | 整条 | 800g | 6 分钟 |
-| 大比目鱼 | 切片 | 170g | 2.25 分钟 |
-| 龙脷鱼 | 切片 | 170g | 1.5 分钟 |
+| 鱼类     | 是否切片 | 重量 | 微波时间  |
+|----------|----------|------|-----------|
+| 海鲈鱼   | 整条     | 450g | 6.5 分钟  |
+| 罗非鱼   | 整条     | 800g | 6 分钟    |
+| 大比目鱼 | 切片     | 170g | 2.25 分钟 |
+| 龙脷鱼   | 切片     | 170g | 1.5 分钟  |
 
 ### 其他变化
 

dishes/aquatic/水煮鱼.md

@@ -0,0 +1,59 @@
+# 水煮鱼的做法
+
+水煮鱼是一道做法中等难度的硬菜。巴沙鱼富含优质蛋白且脂肪含量低，配合各种时令蔬菜十分营养健康。初学者一般需要 2 小时即可完成。
+
+## 必备原料和工具
+
+- 巴沙鱼
+- 蔬菜（比如土豆片/豆芽/花菜/生菜/……）
+- 红油豆瓣酱
+- 藤椒油
+- 菜籽油
+- 白胡椒粉
+- 蒜瓣
+- 盐
+- 糖
+- 量杯
+- 厨房秤（可选）
+- 大不锈钢碗
+
+## 计算
+
+以下用量适合 3 至 5 人食用。
+
+- 巴沙鱼 500g
+- 蔬菜（比如土豆片/豆芽/花菜/生菜/……） 可有不同搭配，推荐合计重量 300g 至 500g
+- 红油豆瓣酱 40g （不怕辣想多加红油就多加 10 至 20g）
+- 豆豉 10g （可选）
+- 藤椒油 10ml
+- 菜籽油 25ml
+- 白胡椒粉 3g
+- 大蒜 2 瓣
+- 盐 5g
+- 糖 2g
+
+## 操作
+
+- 准备：巴沙鱼若是从冷冻柜里取出，需要放室温自然解冻 5 小时再做切片处理。
+- 切片：巴沙鱼撇成薄片，约 5cm 长，3cm 宽。
+- [腌制](../../tips/learn/学习腌.md)：将切好片的巴沙鱼放入大不锈钢碗中
+- 加入 30g 豆瓣酱，3g 盐，10ml 藤椒油，3g 白胡椒粉
+- 用手抓匀后加入 5ml 菜籽油收尾封住口味
+- 常温静置至少 30 分钟入味。
+- 备菜：大蒜切成蒜末。以 300g 花菜，200g 生菜为例，将花菜与生菜洗净。
+- 焯水与炒菜：花菜[开水锅焯水](../../tips/learn/学习焯水.md)备用；将生菜洗净晾干，炒熟备用（不用放油）。
+- 炒豆瓣酱：热锅冷油（菜籽油 20ml），加入 10g 豆瓣酱，10g 豆豉（可选），加入蒜末，**中火**慢炒。
+- 汆鱼片：加入 150ml 热水，水很快开后加入腌制好的鱼片，轻轻翻动让鱼片在水中散开，加入 2g 盐和 2g 糖调味（此时可根据个人口味调整盐的用量）。水再次沸腾后即可盛盘。
+- 盛盘：先将熟的蔬菜盛至大碗中，然后将热的鱼片盛在蔬菜上面，浇上锅中剩余热汤即可！
+
+## 附加内容
+
+- 垫底的蔬菜组合及用量可自由发挥，但需要注意各种蔬菜的特点，比如改成土豆的时候，需要将土豆片/土豆块煮熟（可以用筷子戳一戳确认）。
+- 红油豆瓣酱（辣度）以及盐的用量可根据个人口味调整。
+- 注意切鱼片的时候可以垂直于鱼片长条的方向先剁成 5cm 的鱼块，然后翻转 90 度斜着撇成薄片。
+- [腌制](../../tips/learn/学习腌.md)的时候注意不要太用力抓。
+- [How to Fillet a Fish 怎样给鱼剔骨](https://www.youtube.com/watch?v=uXSgGtMkgro)
+
+### 参考资料
+
+如果您遵循本指南的制作流程而发现有问题或可以改进的流程，请提出 Issue 或 Pull request 。

dishes/aquatic/油焖大虾/油焖大虾.md

@@ -0,0 +1,45 @@
+# 油焖大虾的做法
+
+## 必备原料和工具
+
+- 黑虎虾 or 明虾、
+- 葱、姜
+- 料酒、盐、冰糖、植物油
+
+## 计算
+
+ 1 人食用的版本。
+
+- 虾 10 只
+- 花椒 5g
+- 葱 50g
+- 姜 20g
+- 黄酒 30g
+- 盐 3g
+- 冰糖 10g
+- 植物油
+
+## 操作
+
+- 剪虾枪到根上，虾须虾爪都剪掉，沙包挑掉，开背虾线挑出来，洗净备用
+- 炸料油
+  - 油温三成热放花椒，油热离火，放葱姜（不要让油变色最好）葱稍微变黄沥油 （葱油弄多了可以留着作为拌面使用）。
+- 下油，虾摆放整齐，两面变色后轻轻摁虾头
+  - 放姜米（姜切成细颗粒）
+  - 黄酒 30g
+  - 水两小碗
+  - 盐 3g
+  - 冰糖 10 克
+- 大火烧开转小火盖盖子闷（中途不能再加汤水，不要开盖）
+- 皮亮虾弯就可以起锅，虾摆盘
+- 收汁（过滤后倒回锅里收浓，放葱油 ） 汤汁剩余 1/4 时。
+- 浇汁
+- 完成
+- ![成品](./油焖大虾.jpg)
+- 开吃✅
+
+## 附加内容
+
+- 做法参考：B 站老饭骨视频[从小吃到大的油焖大虾居然是假的？泰斗级大师还原真·味道](https://www.bilibili.com/video/BV17f4y1W7z9)
+
+如果您遵循本指南的制作流程而发现有问题或可以改进的流程，请提出 Issue 或 Pull request 。

dishes/aquatic/白灼虾/白灼虾.md

@@ -38,7 +38,7 @@
 
 - 洋葱切小块，姜切片，平铺平底锅。
 - 活虾冲洗一下（去除虾线、剪刀减掉虾腿虾须子都是可选操作），控水，铺在平底锅的洋葱、姜片之上。
-- 倒入国内料酒，盖上锅盖，中火 1 分钟，小火 5 分钟，关火 5 分钟。
+- 锅内倒入料酒，盖上锅盖，中火 1 分钟，小火 5 分钟，关火 5 分钟。
 - 和上一步并行操作，制作蘸料：
   - 葱切成葱花、蒜切碎、倒入酱油、芝麻、香醋，搅拌之。
   - 油烧热，淋入蘸料。

dishes/aquatic/红烧鱼.md

@@ -0,0 +1,63 @@
+# 红烧鱼的做法
+
+- **WARNING** 如果没有使用过菜刀剁过肉类食物，那么并不推荐使用该菜单！！！
+- 在操作中，锋利的菜刀可能会划伤手指，请一定要小心。
+
+- 此做法代表通用红烧鱼做法，材料分为必备和可添加~
+
+## 必备原料和工具
+
+- 姜、蒜瓣、干辣椒
+- 油、盐、料酒、醋、酱油、白砂糖
+- 鱼
+
+### 可额外添加的材料
+
+注意这些材料都是经验计算得出，除了香菜外其他多了并不是一件好事儿
+
+- 蚝油
+- 葱
+- 香菜
+- 小米椒
+- 味精（鸡精）
+
+## 计算
+
+* 鱼 建议新手以一条中等大小的鲫鱼上手，提前划好花刀，方便成熟（不然鱼背上容易夹生）
+* 姜丝，以正常老姜切 2-3 片，然后片丝即可
+* 蒜瓣 3-4 个，拍碎或者切碎或者切片
+* 干辣椒（依照个人口味）2-3 个，切碎
+* 香菜按照个人口味
+* 盐 10g，如果辣椒辣度高，建议多一点
+* 醋 5ml
+* 酱油 5ml
+* 白砂糖 10g
+* 葱 1-2 根，正常就撒葱花
+* 小米椒 1-2，不放也可以，过来人的经验，最多放 2 个，不然辣度过高要菊花残。
+* 味精，看个人口味，不要放多，5g 即可。
+* 蚝油，5g 即可，和味精一个道理
+
+## 操作
+
+### 原材料准备
+
+* 姜蒜准备好，切碎
+* 干辣椒切碎，和姜蒜一起
+
+### 最终步骤
+
+* 加入 30-50ml 油，等待锅热...
+* 放入**擦干水分的鱼**（不想被热油溅一身的话），然后晃动锅，用热油煎鱼，注意这过程一定要小火
+* 将鱼翻面，重复上面油煎过程
+* 放入姜蒜辣椒，翻炒出香味
+* 倒入料酒，稍微多一点，此过程注意安全，会起大量油烟
+* 倒入醋（喜欢醋可以多放一点）
+* 然后放入白砂糖，酱油（老抽)
+* 加入冷水，以刚好淹没鱼身为宜，然后调成中火，盖上锅盖，大概 1 分钟后将鱼翻身，继续盖上锅盖
+* 3-4 分钟后，加入盐、小米椒、蚝油（味精、鸡精等），然后继续盖上锅盖，后续继续要翻身
+* 当锅内汤汁收汁到鱼的脊背线上的鱼鳍下面一点点的时候（或者汤汁不多的时候），转小火，加入香菜，葱花，然后盖上锅盖 20 秒，关火
+* 起锅
+
+## 附加内容
+
+如果您遵循本指南的制作流程而发现有问题或可以改进的流程，请提出 Issue 或 Pull request 。