Development#

Build docs (HTML)#

From the repository root:

sphinx-build -b html docs/source docs/build/html

The build executes embedded Plotly code blocks (.. plotly-exec::), so interactive charts are regenerated at each build.

Serve docs with live reload#

sphinx-autobuild docs/source docs/build/html

Then open http://127.0.0.1:8000.

Makefile shortcuts#

If using GNU Make:

make -C docs html
make -C docs clean