apairon
dcdb6ee637
Befund 1 (Nutzer): Inline-Code war im Dark Mode kaum lesbar.
- src/styles/custom.css: eigene Chip-Farben (--tibi-inline-*), Rahmen, nowrap in der ersten Tabellenspalte
- gemessen: Text/Chip 10,2:1 dunkel, 12,4:1 hell
Befund 2 (beim Nachmessen gefunden): 58 Seiten waren .md - Starlight-Komponenten wurden NICHT gerendert
(rohe <Aside>/<Steps>-Tags, import-Zeile als sichtbarer Text auf 57 Seiten).
- alle 58 Seiten auf .mdx umgestellt und MDX-konform gemacht (Imports, Block-Tags in eigenen Zeilen,
HTML-Kommentare -> {/* */}, geschweifte Klammern escaped)
- nachher: 428 Asides, 87 Steps, 158 Tab-Gruppen gerendert, 0 geleakte Imports
- fehlender Import in reference/hooks-daten ergaenzt
Regressionsschutz: audit-docs.mjs prueft jetzt Komponente-ohne-Import, .md-mit-Komponente,
geleakte Imports und rohe Tags im gebauten dist/. AGENTS.md 3 dokumentiert die .mdx-Regel.
Nebenfund: de.json mit ASCII-Umschreibungen -> Issue tibi-admin-nova #6
Build: 71 Seiten gruen, Audit 7 legitime Platzhalter-Marker
Tibi Doku
Entwickler- und später Anwender-Dokumentation für Tibi-Server und Tibi-Admin-Nova. Basis: Astro Starlight — Markdown-Quellen, statischer Build, eingebaute Volltextsuche (Pagefind). Theme an Nova angelehnt (Inter, Near-Black, Nova-Orange).
Altes Demo+Docs-Repo liegt archiviert unter cms/tibi-docs-legacy.
Start
npm install
npm run dev # http://localhost:4321
# oder
make docker-up # https://tibi-docs.code.testversion.online/
make docker-down
Docs pflegen
Single Source bleibt in den Quell-Repos — hier wird nur gerendert:
npm run sync # tibi-server/docs + tibi-admin-nova/docs übernehmen
npm run sync:openapi # OpenAPI vom laufenden Server holen (TIBI_API_URL)
npm run build # prüfen, ob alles rendert
Eigene Seiten: src/content/docs/{einstieg,nova,anwender,reference,adr}/.
Struktur
src/content/docs/
index.mdx Startseite (Hero)
einstieg/ was-ist-tibi, schnellstart, begriffe
# Neuaufbau: server/, nova/, anwender/, reference/, adr/ folgen
scripts/
sync-server-docs.mjs
sync-openapi.mjs
Siehe AGENTS.md für die Agenten-Regeln.