Build the docs using sphinx#
You can build the sphinx based docs from the project directory by running:
$ tox -e docs
This will build the static docs on the docs directory, which includes API docs that pull in docstrings from the code.
See also
The docs will be built into the build/html directory, and can be opened locally with a web browse:
$ firefox build/html/index.html
Autobuild#
You can also run an autobuild process, which will watch your docs directory for changes and rebuild whenever it sees changes, reloading any browsers watching the pages:
$ tox -e docs autobuild
You can view the pages at localhost:
$ firefox http://localhost:8000
If you are making changes to source code too, you can tell it to watch changes in this directory too:
$ tox -e docs autobuild -- --watch src