# anduin2017/howtocook architecture

> Architecture diagram of the GitHub repository anduin2017/howtocook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anduin2017/howtocook
- Repository: https://github.com/anduin2017/howtocook

## Overview

HowToCook is a Chinese-language cooking guide, not an application codebase: its product is a Markdown cookbook and practical cooking advice. The main reader workflow is to browse the published recipe site, choose a dish, and follow its recipe; the repository also provides technique and kitchen-preparation guidance. Contributors can adapt the example recipe template. The README documents a Docker-hosted viewer, but its implementation is not present in the supplied tree, so the graph does not infer its internal indexing or serving architecture.

Main entry points: [`dishes`](https://github.com/anduin2017/howtocook/tree/master/dishes) (Recipe collection), [`dishes/template/示例菜/示例菜.md`](https://github.com/anduin2017/howtocook/blob/master/dishes/template/%E7%A4%BA%E4%BE%8B%E8%8F%9C/%E7%A4%BA%E4%BE%8B%E8%8F%9C.md) (Example recipe template), [`tips/厨房准备.md`](https://github.com/anduin2017/howtocook/blob/master/tips/%E5%8E%A8%E6%88%BF%E5%87%86%E5%A4%87.md) (Kitchen preparation), [`tips/learn`](https://github.com/anduin2017/howtocook/tree/master/tips/learn) (Cooking techniques)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_recipes["Recipe collection"]
  node_recipe_catalog["Recipe collection"]
  node_aquatic["Aquatic dishes"]
  node_breakfast["Breakfast"]
  node_condiments["Condiments"]
  node_desserts["Desserts"]
  node_drinks["Drinks"]
  node_meat["Meat dishes"]
  node_semi_finished["Semi-finished foods"]
  node_soups["Soups"]
  node_staples["Staple foods"]
  node_vegetables["Vegetable dishes"]
  node_recipe_template["Example recipe template<br/>[示例菜.md]"]
end

subgraph group_guides["Cooking guidance"]
  node_kitchen_prep["Kitchen preparation<br/>[厨房准备.md]"]
  node_learning_tips["Cooking techniques"]
  node_advanced_tips["Advanced techniques"]
  node_meal_choice["Choosing a meal<br/>[如何选择现在吃什么.md]"]
end

subgraph group_access["Reading and contribution"]
  node_website["Published recipe site"]
  node_local_viewer["Local Docker viewer"]
end

node_reader(("Home cook"))

node_reader -->|"browses recipes"| node_website
node_website -->|"presents recipes"| node_recipe_catalog
node_reader -->|"runs locally"| node_local_viewer
node_reader -->|"copies to contribute"| node_recipe_template
node_reader -->|"reads guidance"| node_kitchen_prep
node_reader -->|"learns techniques"| node_learning_tips
node_reader -->|"chooses a dish"| node_meal_choice

click node_recipe_catalog "https://github.com/anduin2017/howtocook/tree/master/dishes"
click node_aquatic "https://github.com/anduin2017/howtocook/tree/master/dishes/aquatic"
click node_breakfast "https://github.com/anduin2017/howtocook/tree/master/dishes/breakfast"
click node_condiments "https://github.com/anduin2017/howtocook/tree/master/dishes/condiment"
click node_desserts "https://github.com/anduin2017/howtocook/tree/master/dishes/dessert"
click node_drinks "https://github.com/anduin2017/howtocook/tree/master/dishes/drink"
click node_meat "https://github.com/anduin2017/howtocook/tree/master/dishes/meat_dish"
click node_semi_finished "https://github.com/anduin2017/howtocook/tree/master/dishes/semi-finished"
click node_soups "https://github.com/anduin2017/howtocook/tree/master/dishes/soup"
click node_staples "https://github.com/anduin2017/howtocook/tree/master/dishes/staple"
click node_vegetables "https://github.com/anduin2017/howtocook/tree/master/dishes/vegetable_dish"
click node_recipe_template "https://github.com/anduin2017/howtocook/blob/master/dishes/template/%E7%A4%BA%E4%BE%8B%E8%8F%9C/%E7%A4%BA%E4%BE%8B%E8%8F%9C.md"
click node_kitchen_prep "https://github.com/anduin2017/howtocook/blob/master/tips/%E5%8E%A8%E6%88%BF%E5%87%86%E5%A4%87.md"
click node_learning_tips "https://github.com/anduin2017/howtocook/tree/master/tips/learn"
click node_advanced_tips "https://github.com/anduin2017/howtocook/tree/master/tips/advanced"
click node_meal_choice "https://github.com/anduin2017/howtocook/blob/master/tips/%E5%A6%82%E4%BD%95%E9%80%89%E6%8B%A9%E7%8E%B0%E5%9C%A8%E5%90%83%E4%BB%80%E4%B9%88.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_recipe_catalog,node_aquatic,node_breakfast,node_condiments,node_desserts,node_drinks,node_meat,node_semi_finished,node_soups,node_staples,node_vegetables,node_recipe_template toneBlue
class node_kitchen_prep,node_learning_tips,node_advanced_tips,node_meal_choice toneAmber
class node_website,node_local_viewer toneMint
class node_reader toneIndigo
```

## Components

### Recipe collection

- [Recipe collection](https://github.com/anduin2017/howtocook/tree/master/dishes): `dishes`
- [Aquatic dishes](https://github.com/anduin2017/howtocook/tree/master/dishes/aquatic): `dishes/aquatic`
- [Breakfast](https://github.com/anduin2017/howtocook/tree/master/dishes/breakfast): `dishes/breakfast`
- [Condiments](https://github.com/anduin2017/howtocook/tree/master/dishes/condiment): `dishes/condiment`
- [Desserts](https://github.com/anduin2017/howtocook/tree/master/dishes/dessert): `dishes/dessert`
- [Drinks](https://github.com/anduin2017/howtocook/tree/master/dishes/drink): `dishes/drink`
- [Meat dishes](https://github.com/anduin2017/howtocook/tree/master/dishes/meat_dish): `dishes/meat_dish`
- [Semi-finished foods](https://github.com/anduin2017/howtocook/tree/master/dishes/semi-finished): `dishes/semi-finished`
- [Soups](https://github.com/anduin2017/howtocook/tree/master/dishes/soup): `dishes/soup`
- [Staple foods](https://github.com/anduin2017/howtocook/tree/master/dishes/staple): `dishes/staple`
- [Vegetable dishes](https://github.com/anduin2017/howtocook/tree/master/dishes/vegetable_dish): `dishes/vegetable_dish`
- [Example recipe template](https://github.com/anduin2017/howtocook/blob/master/dishes/template/%E7%A4%BA%E4%BE%8B%E8%8F%9C/%E7%A4%BA%E4%BE%8B%E8%8F%9C.md): `dishes/template/示例菜/示例菜.md`

### Cooking guidance

- [Kitchen preparation](https://github.com/anduin2017/howtocook/blob/master/tips/%E5%8E%A8%E6%88%BF%E5%87%86%E5%A4%87.md): `tips/厨房准备.md`
- [Cooking techniques](https://github.com/anduin2017/howtocook/tree/master/tips/learn): `tips/learn`
- [Advanced techniques](https://github.com/anduin2017/howtocook/tree/master/tips/advanced): `tips/advanced`
- [Choosing a meal](https://github.com/anduin2017/howtocook/blob/master/tips/%E5%A6%82%E4%BD%95%E9%80%89%E6%8B%A9%E7%8E%B0%E5%9C%A8%E5%90%83%E4%BB%80%E4%B9%88.md): `tips/如何选择现在吃什么.md`

### Reading and contribution

- **Published recipe site**
- **Local Docker viewer**

### Other components

- **Home cook**

## Connections

- Home cook → Published recipe site: browses recipes (evidence: `README.md`)
- Published recipe site → Recipe collection: presents recipes (evidence: `README.md`)
- Home cook → Local Docker viewer: runs locally (evidence: `README.md`)
- Home cook → Example recipe template: copies to contribute (evidence: `README.md`)
- Home cook → Kitchen preparation: reads guidance (evidence: `README.md`)
- Home cook → Cooking techniques: learns techniques (evidence: `README.md`)
- Home cook → Choosing a meal: chooses a dish (evidence: `README.md`)
