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