Guide
Dieser Leitfaden erklärt, wofür die Seite gedacht ist, wie sie aufgebaut ist und wie du sie lokal bauen kannst.
Ziel der Dokumentation
Wissen liegt oft verstreut in Notizen, Wikis und Köpfen. Diese Seite bündelt es an einem Ort, damit Informationen schnell auffindbar, nachvollziehbar und für alle Beteiligten gleichermaßen zugänglich sind.
Aufbau der Seite
Die Seite ist eine statische Astro-Anwendung. Ein gemeinsames Basislayout liefert Kopfbereich, Hauptinhalt und einen optionalen Footer. Jede Seite unter src/pages wird beim Build zu einer eigenen HTML-Datei.
Navigation
Die Hauptnavigation befindet sich im Kopfbereich und ist auf jeder Seite identisch. Darüber erreichst du alle Bereiche, ohne die Orientierung zu verlieren.
Lokal bauen
Mit den folgenden Schritten erzeugst du die statische Seite auf deinem Rechner:
- Abhängigkeiten reproduzierbar installieren:
npm ci - Die Seite bauen:
npm run build
Das Ergebnis liegt anschließend im Ordner dist. Dieser Leitfaden ist dort unter dist/guide/index.html zu finden.