Skip to content

Introduction

This documentation is built using mkdocs, a static site generator that is geared towards building project documentation. The documentation is created in the Markdown format, and it all resides in the docs directory in the repository. The organization of the documentation is controlled by the mkdocs.yml in the root of the repository.

Prerequisites

You will need to have mkdocs installed locally, as well as the mkdocs theme.

Install mkdocs:

sudo -H pip install mkdocs

Install material theme:

sudo -H pip install mkdocs-material

Build and Deploy documentation

Make sure you have all the submodules:

git submodule update --init --recursive

Documentation is build by running to the following command in the root of the repository:

mkdocs build --clean

This command will create a static site folder in the root of the repository.

You can preview any changes you have made to the documentation by running the following command:

mkdocs serve

And then visiting http://localhost:8111 in your browser.

To deploy documentation to GitHub Pages, issue the following command:

mkdocs gh-deploy --clean