This documentation's source template was taken from the Spinal HDL project.
The theme is based on the PyData Sphinx Theme.
For more detailed usage instructions, see the Open Ephys Doc Template.
Requirements (Python 3):
- pipenv (will automatically download all the project requirements from pypi)
Create a virtual environment with pipenv (will use the Pipfile for installing the necessary packages).
pipenv install
Then you can build the documentation.
pipenv run make html
If you want to run make
multiple times, prepending pipenv run
on each command can be annoying.
You can spawn a subshell with:
pipenv shell
and then you can use make
the usual way.
make html # for html
make latex # for latex
make latexpdf # for latex (will require latexpdf installed)
make # list all the available output format
All the outputs will be in the docs folder (for html: docs/html).
Requirements (system):
- make
Requirements (Python 3):
- sphinx
- pydata-sphinx-theme=="0.13.3"
After installing the requirements you can run:
make html # for html
make latex # for latex
make latexpdf # for latex (will require latexpdf installed)
make # list all the available output format