apairon
d51c6ec6bb
Nutzer-Feedback: Zwischenfassung war zu hell, weisser Text dadurch kontrastschwacher. - Text/weiss auf Chip: 7,9:1 -> 13,4:1 - Chip bleibt heller als der Seitenhintergrund (#2a2f39 vs #17181c = 1,32:1), Rahmen #525c6b (2,62:1) - am Live-Stand geprueft (computed style + Pixel): rgb(42,47,57) auf rgb(23,24,28) - Protokoll in plans/doku-audit.md Welle I nachgezogen
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.