MetaONNX

Building the documentation

Documentation is based on Sphinx and can be generated locally from the repository top.

Build steps

• Optional: create a virtual environment using Virtualenv or Conda

• Install akida packages and their requirements using the provided file:

pip install -r requirements.txt

• Install Sphinx additional modules used by the documentation:

pip install sphinx_rtd_theme sphinx-gallery autodocsumm sphinx_design sphinxcontrib-video

• Finally build using sphinx-build tool, refer to Sphinx tutorial for details on this command line:

sphinx-build -D plot_gallery=0 -b html ./doc ./build

Note that by removing the -D plot_gallery=0 option in the previous command, examples will be executed for a nicer rendering but it will take much more time. If needed (e.g. for debugging), a set of selected examples can be rendered through the command:

sphinx-build -b html ./doc ./build -D sphinx_gallery_conf.filename_pattern=regex_my_examples.py

• Open .build/index.html once done

Style check

Style check is based on flake8.

To align examples with python formatting rules:

autopep8 --ignore E402,E501 --in-place --recursive examples/

Link check

Leveraging sphinx built-in link checker. Note that links to internal components must be explicitly relative and will be ignored by the tool (it cannot check relative links).

sphinx-build -D plot_gallery=0 -b html ./doc ./build -b linkcheck