Building the documentation¶
Documentation is built via a nox suite that runs sphinx. You can either build the docs one-time if you want to get a static build for deployment, or you can start up a server to auto build the documentation when any of the source files are modified.
Note
This tutorial assumes you have already followed the Setting Up for Development steps to set up for developing this project.
Building static documentation¶
To generate a static copy of the documentation:
nox -s docs-build
The generated documentation will be placed in the docs/_build
directory.
Live-view documentation¶
To view the documentation live in your browser while editing it you can run:
nox -s docs
A browser window will be opened to the sphinx server so you can view updates dynamically