-
Notifications
You must be signed in to change notification settings - Fork 75
Automatic Documentation
b-schubert edited this page Aug 21, 2017
·
1 revision
To compile the docs yourself you have to install:
- Sphinx (
pip install sphinx
) - the ReadTheDocs theme (
pip install sphinx_rtd_theme
) - Napoleon (for Numpy like doc-string:
pip install sphinxcontrib-napoleon
)
Then:
- cd into ./docs
- call:
make clean html
This will generate new html pages in _build
If you want to add a new file you have to add a .rst
file or edit an existing .rst
file in the doc-folder with the following content:
evcouplings\.<folder-name> package
==================================
evcouplings\.<folder-name>\.<file-name> module
----------------------------------------------
.. automodule:: evcouplings.<folder-name>.<file-name>
:members:
:undoc-members:
:show-inheritance:
You also have to manually add the new .rst
file in evcouplings.rst