Skip to content

open-ephys/onix-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Documentation for ONIX

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

How to build this documentation

With pipenv (recommended)

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 docs folder (for html: docs/html)

without pipenv/virtualenv

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