# Lokale Installation der Dokumentation

Dies ist eine vorläufige Beschreibung zur Installation der Dokumentation auf einem lokalen Rechner.
Wenn die Dokumentation in unseren Internetauftritt integriert ist, werden andere Schritte nötig sein.

Zuerst eine virtuelle Python-Umgebung erzeugen und aktivieren:

    $ python3 -m venv doku
    $ . ./doku/bin/activate

Anschließend Sphinx und das Readthedocs-Theme installieren.
Das Theme ist weit verbreitet und gut lesbar. 
Bei einer Veröffentlichung wird es vermuitlich ein Theme geben, das mit unserem CD besser übereinstimmt.
Fürs erste eignet sich das Theme gut zum Korrekturlesen.

    $ pip install -U Sphinx
    $ pip install sphinx_rtd_theme
    
Dann die Dokumentation mit Git klonen:

    $ git clone ssh://DEIN-BENUTZERNAME@dev.hostsharing.net:29418/docs/hs.docs.users.git
  
  Und die Dokumentation bauen.

Für die HTML-Version:

    $ cd hs.docs.users
    $ sphinx-build -c local -b html source/ build/html

Die Startseite der Dokumentation lautet: `build/html/index.html`