open-ephys / ONI

Open Neuro Interface Hardware Specification and API Documentation
https://open-ephys.github.io/ONI/
Creative Commons Attribution Share Alike 4.0 International
1 stars 2 forks source link

====================== Open Neuro Interface

This documentation's source template was taken from the Spinal HDL <https://github.com/SpinalHDL/SpinalDoc-RTD>_ project.

The theme is based on the PyData Sphinx Theme <https://pydata-sphinx-theme.readthedocs.io/en/latest/>_.

For more detailed usage instructions, see the Open Ephys Doc Template <https://github.com/open-ephys/doc-template>_.

How to build this documentation

With pipenv (recommended)

Requirements (Python 3):

Create a virtual environment with pipenv (will use the Pipfile for installing the necessary packages).

.. code:: shell

pipenv install

Then you can build the documentation.

.. code:: shell

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:

.. code:: shell

pipenv shell

and then you can use make the usual way.

.. code:: shell

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).

without pipenv/virtualenv

Requirements (system):

Requirements (Python 3):

After installing the requirements you can run:

.. code:: shell

make html # for html make latex # for latex make latexpdf # for latex (will require latexpdf installed) make # list all the available output format