Skip to content
Dokumentation zu den von MAGELLAN und DAVINCI unterstützten Landesstatistiken
HTML PowerShell CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
theme
.gitignore
LICENSE
README.md
mkdocs.yml
upload.ps1

README.md

Build status

Dokumentation zu Landesstatistiken

Dies ist die deutsche Dokumentation zu den von MAGELLAN und DAVINCI unterstützten Landesstatistiken. Die Dokumentation ist Open Source und wir haben sie mit MkDocs und Material for MkDocs realisiert. Push-Requests im master-branch werden in AppVeyor getriggert, so dass jede Änderung automatisch veröffentlicht wird.

MkDocs unter Windows installieren

  1. Installiere Python. Gehe dazu auf die Python-Download-Seite und lade Dir die aktuellste Version für Windows herunter. Für die Version 3.7.2 wäre dies beispielsweise der Link Windows x86-64 executable installer.

  2. Starte das Installationspaket und beantworte alle Fragen.

  3. Öffne die Eingabeaufforderung als Administrator.

  4. Tippe die Befehle python --version und pip --version ein, um die Python-Installation zu überprüfen. In beiden Fällen sollte eine Versionsnummer als Ausgabe in der Eingabeaufforderung erscheinen.

  5. Tippe jetzt den Befehl pip install mkdocs ein, um das Python-Package MkDocs zu installieren.

  6. Tippe anschließend Befehl pip install mkdocs-img2fig-plugin ein, um das MkDocs-Plugin mkdocs-img2fig-plugin zu installieren.

  7. Ein letzter Test: Tippe den Befehl mkdocs --version ein. Eine Versionsnummer in der Eingabeaufforderung zeigt Dir erneut, dass alles korrekt installiert wurde.

Repository klonen

Dieses Repository ist ein Git-Repository. Um das Repository auf deinem lokalen Computer zu klonen, benötigst Du einen Git-Client. Entweder Du installierst Dir Git für Windows und arbeitest mit der Eingabeaufforderung, oder Du installierst Dir eine der zahlreichen GUIs. Zu empfehlen wären GitHub Desktop oder SourceTree.

  1. Erstelle einen lokalen Ordner für die Dokumentation, z.B. c:\docs\ls.

  2. Starte die Eingabeaufforderung und wechsle in den Ordner c:\docs\ls.

  3. Tippe den Befehl git clone https://github.com/stuebersystems/doc.ls.de.git ein, um das Repository zu klonen.

Repository als Zip-Archiv herunterladen

Willst du mit Git erstmal nichts zu tun haben, kannst Du das Repository auch als Zip-Archiv herunterladen:

  1. Öffne die URL https://github.com/stuebersystems/doc.ls.de in deinem Webbrowser

  2. Klicke auf die Schaltfläche Clone or download und dann auf Download ZIP.

  3. Entpacke das Zip-Archiv in einen lokalen Ordner Deiner Wahl, z.B. c:\docs\ls.

Mit MkDocs arbeiten

Du hast Python und das Package MkDocs installiert, Du hast dieses Repository geklont oder als Zip-Archiv heruntergeladen. Jetzt kannst Du die Dokumentation lokal auf deinem Rechner generieren:

  1. Starte die Eingabeaufforderung und wechsle in den Ordner c:\docs\ls.

  2. Tippe den Befehl mkdocs build ein. Die Dokumentation wird neu generiert.

  3. Um Dir das Ergebnis anzeigen zu lassen, tippe den Befehl mkdocs serve ein und öffne die Url http://127.0.0.1:8000 in Deinem Webbrowser.

Das Inhaltsverzeichnis findest Du in der Datei mkdocs.yml, die einzelnen Kapitel im Unterordner docs.

Weitere Informationen

Kann ich mithelfen?

Ja, sehr gerne. Der beste Weg mitzuhelfen ist es, Rückmeldung per Issue-Tracker zu geben und/oder Korrekturen per Pull-Request zu übermitteln.

Code of conduct (Verhaltensregeln)

In diesem Projekt wurde der STÜBER SYSTEMS Code of conduct übernommen.

You can’t perform that action at this time.