HowToCook README

The project's README from github.com/Anduin2017/HowToCook. As one markdown file: README.md.

程序员做饭指南

License GitHub contributors Man hours Website Docker

最近宅在家做饭,作为程序员,我偶尔在网上找找菜谱和做法。但是这些菜谱往往写法千奇百怪,经常中间莫名出来一些材料。对于习惯了形式语言的程序员来说极其不友好。

所以,我计划自己搜寻菜谱并结合实际做菜的经验,准备用更清晰精准的描述来整理常见菜的做法,以方便程序员在家做饭。

同样,我希望它是一个由社区驱动和维护的开源项目,使更多人能够一起做一个有趣的仓库。所以非常欢迎大家贡献它~

浏览菜谱

请直接访问 HowToCook 网站浏览菜谱可视化:

https://howtocook.aiursoft.com/

本地部署

如果需要在本地部署菜谱 Web 服务,可以在安装 Docker 后运行下面命令:

docker pull aiursoft/howtocookviewer
docker run -d -p 5000:5000 aiursoft/howtocookviewer

默认用户名密码: admin,Admin@123456!。启动后 30 分钟内会自动索引。

如何贡献

针对发现的问题,直接修改并提交 Pull request 即可。

在写新菜谱时,请复制并修改已有的菜谱模板: 示例菜。

搭建环境

菜谱

素菜

荤菜

水产

早餐

主食

HowToCook (Anduin2017/HowToCook)

community
Searching Database…

102.9K ·GitHub
What is this?A community-maintained cookbook written specifically for programmers, rewriting common Chinese home recipes with precise, step-by-step instructions instead of the vague wording typical of food blogs.
Is this just a markdown recipe list, or can I run it as a website?Both: the recipes live as plain Markdown files in the repo, readable directly on GitHub, and there's also an official website for browsing them visually plus a self-hosted web version you can run yourself.
How do I browse the recipes or try it myself?You can either visit the official HowToCook website to browse the visualized recipe collection, or deploy the same web service locally.
Do I need Docker to self-host it?Yes, the only documented local deployment method is running a single command after installing Docker; the recipe index then builds automatically within 30 minutes of startup.
Is the self-hosted login secure out of the box?No, the Docker deployment ships with a fixed default admin account, so it should be changed before exposing the instance publicly.
Why was this guide written instead of just using normal recipe sites?The author found typical online recipes inconsistently written, with vague steps and random extra ingredients appearing mid-recipe, which felt unfriendly to someone used to precise, formal instructions.
Does it cover anything beyond the recipes themselves?Yes, it includes kitchen-basics guides on things like choosing a pressure cooker or air fryer, dishwashing, food safety, and core techniques such as blanching, stir-frying, and steaming.
Creator
Anduin2017
Size
513.7 MB
Stars
102.9K
Age
6y
Commits · 90 Days