The Gardener's Handbook
Everything in this site is one garden. The mapping is simple:
| In a library | In this garden |
|---|---|
| The shelf | The garden — the bed on the home page |
| A book | A vegetable — one major topic (a course, a language) |
| Its pages | Leaves — the individual notes inside |
Click a vegetable and you step into its plot: the sidebar shows that topic’s leaves and nothing else, with a path back to the garden at the top.
How it’s organized
Section titled “How it’s organized”src/├── garden.mjs ← the registry: one entry per vegetable└── content/docs/ ├── japanese/ ← one folder per topic │ ├── index.md ← the topic's home leaf │ ├── grammar/ │ └── vocabulary/ ├── example-course/ └── handbook/ ← this pagePlanting a new topic
Section titled “Planting a new topic”-
Dig the plot — create
src/content/docs/<topic>/with anindex.mdhome page, then add one Markdown file per note. New leaves appear in the topic’s sidebar automatically. -
Put it in the registry — add one entry to
src/garden.mjs:{slug: 'control-systems',label: 'Control Systems',veg: 'pumpkin',note: 'semester 2',},That single entry grows the plot in the garden bed, the topic’s own sidebar, and the crest above it. If the topic has sub-folders that deserve labeled groups (like Japanese’s Grammar and Vocabulary), give the entry a
sidebararray — copy the one on thejapaneseentry. -
Pick the vegetable — varieties on hand:
carrot,daikon,pumpkin,eggplant,tomato,cabbage,turnip, andsprout. They’re all drawn insrc/components/Veggie.astro, so a new variety is one more SVG.
Growing good leaves
Section titled “Growing good leaves”- One idea per leaf. A note called “は vs が” gets reread; “Grammar dump week 3” never does.
- Name files for the idea —
control-systems/root-locus.mdreads better in six months thancs2/lec7.md. Future-you is the most important reader. - Rewrite, don’t transcribe. Notes go down within a day of the lecture, from memory first; the gaps you find are the exam questions you would have missed.
What a leaf can hold
Section titled “What a leaf can hold”Math (