ci(wiki): auto-insert new module pages into the sidebar

generate.py now keeps _Sidebar.md in sync: any Module:-* page from the
mapping that is not yet linked is inserted alphabetically into the
Modules list. Existing entries (custom labels, nested sub-entries,
hand-written non-module links) are left untouched, so adding a module no
longer requires editing the sidebar by hand.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Alex
2026-07-04 03:07:53 +02:00
co-authored by Claude Opus 4.8
parent c76bfc018b
commit 4e76d7339f
2 changed files with 55 additions and 0 deletions
+6
View File
@@ -18,6 +18,12 @@ touches `man/**` or this tooling.
- `extras/<Page>.md` — optional hand-maintained appendix (screenshots, showcase
snippets that have no man equivalent), appended verbatim after the generated body.
The generator also keeps `_Sidebar.md` in sync: any `Module:-*` page in the mapping
that is not yet linked in the sidebar is inserted alphabetically into the `Modules:`
list. Existing sidebar entries (custom labels, nested sub-entries, hand-written
non-module links) are never modified — so a new module auto-appears in navigation
without disturbing the curated structure.
## What it touches
Only the pages listed in `mapping.json` are (re)written. Every other wiki page