Files
concrete/docs
youben11 698bd28104 ci: refactor docker images and CI jobs
use a single docker image for all testing environments
unify some CI jobs on this single environment
also parameterize the build of the doc, which no longer have a hardcoded
path for the compiler build directory
2022-09-13 15:18:15 +01:00
..
2021-12-27 09:55:57 +01:00
2021-12-27 09:55:57 +01:00
2021-12-27 09:55:57 +01:00
2021-12-27 09:55:57 +01:00
2021-12-27 09:55:57 +01:00
2021-12-27 09:55:57 +01:00
2021-12-27 09:55:57 +01:00

Bibliotech

Documentation is built with sphinx (https://www.sphinx-doc.org).

Dependencies

In the docs repository (which contains this file):

It is recommended to first create a virtualenv:

virtualenv .venv
source .venv/bin/activate

You need to install the Python dependencies:

pip install -r requirements.txt
pip install -r ../llvm-project/mlir/python/requirements.txt

You also need to install Doxygen.

Build local docs

make doc

To open the docs:

xdg-open _build/html/index.html

Automatic build on update

If you want the documentation to be updated as you are editing it, you can install an extra package called sphinx-autobuild

pip install sphinx-autobuild

and launch (after a run of make doc) in the doc directory:

python -m sphinx_autobuild . _build

This will launch a local web server on port 8000 with updated rendered version on each source modifications (but doesn't work on dialects changes, for which make doc need to be run again).