Add pdoc3 to setup.py and index.md.

diff --git a/doc/index.md b/doc/index.md
index 5baba4c38d0854765df0868cccb32ae3d834fe12..0a5cf054ed31cf48a5b475dbfb2d3058160f6b98 100644 (file)
--- a/doc/index.md
+++ b/doc/index.md
@@ -85,6 +85,13 @@ des Codes mit Tests erhält man mit der zusätzlichen Option `-v`:
 (venv)$ python -m doctest -v <Pfad zur Code-Datei>
 ```
 
+Außerdem wird durch die `[dev]`-Extras in `setup.py` auch das Tool `pdoc`
+zur automatischen Generierung von API-Dokumentation in HTML installiert:
+```sh
+(venv)$ pdoc --html --config sort_identifiers=False --force \
+             --output-dir doc/ controlpi/ controlpi-plugins/
+```
+
 ## Überblick
 Die ControlPi-Infrastruktur hat zwei Haupt-Bestandteile:
 - Ein Plugin-System erlaubt es, ohne Anpassungen am Code der Infrastruktur

diff --git a/setup.py b/setup.py
index 4adccf682cba715bad905ed2c76b89eabb851c8f..78a75acb9c0b1404cc376325381312b72093218f 100644 (file)
--- a/setup.py
+++ b/setup.py
@@ -23,6 +23,7 @@ setuptools.setup(
             "pycodestyle",
             "pydocstyle",
             "mypy",
+            "pdoc3",
         ]
     },
     classifiers=[