apairon
bda5d80180
Deploy tibi-docs / build-and-deploy (push) Successful in 27s
- Workflow auf master-only reduziert: build + rsync ./dist/ (kein Registry/Staging) - rsync-Ziel ueber RSYNC_PATH=docs.tibicms.de (Docroot ab htdocs), User Repo+Subdomain-ID - sshpass -e statt Passwort im Kommando - astro site-URL auf https://docs.tibicms.de umgestellt (Sitemap/Canonical) - docker-compose-staging.yml entfernt (Staging raus)
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.