Die Neo Dokumentation und Homepage mit MkDocs.
Go to file
hrnz 285ab7ff84 Tabellen links ausgerichtet 2020-11-08 11:48:24 +01:00
docs Tabellen links ausgerichtet 2020-11-08 11:48:24 +01:00
overrides Startseite: Links hinzugefügt 2020-11-08 11:31:22 +01:00
.gitignore Init: Strukturskelett für die MkDocs Doku 2020-05-18 22:27:05 +02:00
README.md Strukturtest Benutzerhandbuch: installation windows 2020-05-25 21:46:25 +02:00
mkdocs.yml Links in FAQ repariert, MS Office unter Anwendungen hinzugefügt 2020-11-06 23:36:28 +01:00

README.md

Neo - ergonomisch optimiert
Dokumentation

Ä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 - Statischer Seiten Generator
  • MkDocs-Material - Material Thema für MkDocs
  • Git in irgend einer Form

Herunterladen

Das Dokumentations Repo 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