Pdoc is vastly simpler to use than Sphinx for small projects, with good HTML formatting.
In distinction from Sphinx, pdoc does not parse RST docstrings, but Pdoc does allow the following docstring formats:
At this time, pdoc3 doesn’t consider Python type hinting; hopefully they’ll add that in the future.
pdoc is a light minimal install.
pip install pdoc3
From the top-level pymap3d/ directory, type
pdoc --html pymap3d
This creates several
*.html files under
Check the output by:
If the output seems satisfactory,
move the files to the
or at least to a
mv pymap3d/*.html docs/
Publish the docs to the web by:
- In the Github repo Settings → Github Pages → Source: “master branch /docs folder”
- git commit and push. It takes a few seconds for Github Pages to deploy HTML.