Bulding the documentation¶
You can use Sphinx to generate the full documentation in various formats (including HTML or PDF) yourself, as described in the following. First, install the extra requirements, i.e., Sphinx, with:
pip install -r doc/requirements.txt
Note
Plotting the inheritance graphs also requires Graphviz.
If you have conda, installing it requires just conda install graphviz
.
Afterwards, simply go to the folder doc/
and run the following command:
make html
This should generate the html documentation in the folder doc/sphinx_build/html.
Open this folder (or to be precise: the file index.html in it) in your webbroser
and enjoy this and other documentation beautifully rendered, with cross links, math formulas
and even a search function.
Other output formats are available as other make targets, e.g., make latexpdf
.
Note
Building the documentation with sphinx requires loading the modules. The conf.py adjusts the python path to include the tenpy from root directory of the repository.