Mkdocs documentation

This file describes the Mkdocs package we use inside Gyselalib++ to document our code.

Packages for installation

The packages required to make the docs are listed in the requirements.txt file. Simply run:

pip install -r requirements.txt

Adjustments to MkDocs can be done in the mkdocs.yml.

To run the documentation locally follow the instructions in Add Documentation.

MkDocs Navigation and Configuration

The configuration of MkDocs, including various options and additional packages, is managed through the mkdocs.yml file. This file allows you to customise the structure and appearance of your documentation.

Modifying the Navigation Panel

To add a new section to the navigation panel of your documentation site, update the nav: section in the mkdocs.yml file. This section defines the structure of your documentation, specifying the order and hierarchy of pages displayed in the sidebar.

Configuring the Doxygen API

The documentation includes an API reference generated with Doxygen, you can configure it using mkdoxy, an additional package designed to integrate Doxygen into MkDocs.

Useful pages used for setting up MkDocs

  • find a nice example project here: MkDocs Project
  • mkdocs-include-dir-to-nav ... Package to do include subdirectories Doc