## Änderungen direkt Über gitea
Auf den Dokumentationsseiten befindet sich ein Knopf, über den die Seite im Gitea Editor geändert werden kann. Die Dokumentation wird automatisch neu gebaut, wenn Änderungen im master branch eingehen und kann unter https://mkdocs.neo.uber.space/ eingesehen werden.
## Selber bauen
### Anforderungen
* [MkDocs](https://www.mkdocs.org) - Statischer Seiten Generator
* [MkDocs-Material](https://squidfunk.github.io/mkdocs-material/) - Material Thema für MkDocs
* Git in irgend einer Form
### Herunterladen
Das [Dokumentations Repo](https://git.neo-layout.org/neo/dokumentation) herunterladen und entpacken oder mittels Befehl klonen.
ssh: `git clone neo@git.neo-layout.org:neo/dokumentation.git`
https: `git clone https://git.neo-layout.org/neo/dokumentation.git`
### Bauen
Den lokalen MkDocs Server im Dokumentations Ropo mit `mkdocs serve` starten. Die Dokumentation wird nun auf `http://localhost:8000` angezeigt und bei Änderungen automatisch aktuallisiert.
Mittels `mkdocs bulld` kann die gesamte Dokumentation statisch generiert werden. Die entstandenen Dateien finden sich im Verzeichnis `/site`.
## Struktur
```
.
├─ docs/ # Dokumentationsstexte im Markdownformat
│ ├─ Quickguide/ # Markdown für Download und Installation
│ ├─ Benutzerhandbuch/ # Seiten zum Benutzerhandbuch
│ ├─ .../ # und andere bereiche der Dokumentation
│ ├─ index.md # Setzen des Startzeitentemplates
│ └─ kontakt.md # Kontaktseite
├─ overrides/ # Themaanpassungen nach Materialvorgabe
│ ├─ assets/
│ │ ├─ images/ # Icons, Logos und Tastaturbilder
│ │ └─ stylesheets/ # Zusätzliche Stilanpassungen
│ ├─ overrides/
│ │ └─ home.html # Startseitentemplate
│ ├─ partials/
│ │ ├─ footer.html # Anpassung des Footers
│ │ └─ header.html # Anpassung des Headers
│ └─ main.html # Anpassung des Haupttemplates
├─ mkdocs.yml # MkDocs Konfiguration
└─ README.md
```