Developing the apiron documentation¶
These docs are built using sphinx.
Developing¶
If you have tox installed, you may build these docs by running tox -e docs. Otherwise, you can follow the instructions below to manually install dependencies and build the docs.
Installation¶
$ cd /path/to/apiron/
$ pyenv virtualenv 3.7.0 apiron # pick your favorite virtual environment tool
$ pyenv local apiron
(apiron) $ pip install -e .[docs]
Building¶
You can build or rebuild the static documentation using make
:
$ cd /path/to/apiron/docs/
(apiron) $ make html
Running Sphinx v1.7.4
...
build succeeded.
The HTML pages are in _build/html.
If you’d instead like to have the docs rebuilt as you’re changing them, you can watch for changes:
$ cd /path/to/apiron/docs/
(apiron) $ make watch
[...] Serving on http://127.0.0.1:8000
[...] Start watching changes
[...] Start detecting changes