We use MkDocs for building and generating the documentations. MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.
The Markdown files listed above are used for their specific documentation. They can be edited and built into HTML documentation pages.
You you have not setup Pipenv
already, then MkDocs and a template need to be installed first using pip
pip install mkdocs
pip install mkdocs-material
From the root our repository, we need to run:
mkdocs build
If Pipenv
is setup then from virtual shell or from the root our repository, we need to run:
pipenv run mkdocs build
This, will build the documentation as HTML and saves them in the site
directory. Note that we use some mkdocs markdown extensions that can be viewed in mkdocs.yml
file.
The Documentation is hosted at: https://docs.isac-simo.net/