Documentation¶

The galois documentation is generated with Sphinx. The Sphinx theme used is sphinx-immaterial.

Install¶

The documentation dependencies are stored in docs/requirements.txt.

1
2
3
4
5
6
7

sphinx>=3
git+https://github.com/jbms/sphinx-immaterial
recommonmark>=0.5
sphinx-design
sphinxcontrib-details-directive
ipykernel
numpy

Install the documentation dependencies by passing the -r switch to pip install.

$ python3 -m pip install -r docs/requirements.txt

Build the docs¶

The documentation is built by running the sphinx-build command.

$ sphinx-build -b html -v docs/ docs/build/

The HTML output is located in docs/build/. The home page is docs/build/index.html.