ci(wiki): render option tables, pin pandoc, add visible auto-gen note

Improve the generated wiki pages:
- normalize definition-style option blocks (*name*: / typeof: / default:)
  into scdoc tables, so every module renders options as a clean table like
  the table-style pages (Bluetooth, Network, ... no longer a wall of text)
- drop pandoc's empty leading table-header row so the real header shows
- pin pandoc to 3.5 in CI (the distro 2.x man reader mangled lists into
  blockquotes); matches local output
- prepend a visible "auto-generated from master, do not edit here" note to
  every page (was an invisible HTML comment)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Alex
2026-07-04 12:49:30 +02:00
co-authored by Claude Opus 4.8
parent 8541ec8189
commit 33223d5534
2 changed files with 112 additions and 7 deletions
+10 -1
View File
@@ -31,7 +31,16 @@ jobs:
uses: actions/checkout@v4
- name: Install scdoc and pandoc
run: sudo apt-get update && sudo apt-get install -y scdoc pandoc
# pandoc is pinned: the distro package can be an old 2.x whose man reader
# mangles lists into blockquotes. Keep this in sync with local tooling.
env:
PANDOC_VERSION: "3.5"
run: |
sudo apt-get update && sudo apt-get install -y scdoc
curl -fsSL -o /tmp/pandoc.deb \
"https://github.com/jgm/pandoc/releases/download/${PANDOC_VERSION}/pandoc-${PANDOC_VERSION}-1-amd64.deb"
sudo dpkg -i /tmp/pandoc.deb
pandoc --version | head -1
- name: Clone the wiki
run: |