microPlatform documentation source for https://docs.foundries.io

In order to build documentation at a minimum we require that both python3 and pip for python3 are installed. All of the required python modules are described in the requirements.txt file in this directory and can be installed with the command pip install -r requirements.txt.

The following is the list of packages needed (can be incomplete):

The recommended way to build documentation, in order to avoid messing with the global system-wide package storage, is to use virtualenv to set up the necessary environment for sphinx packages:

$ sudo apt-get install python3 python3-virtualenv
$ virtualenv -p /usr/bin/python3 venv
$ . ./venv/bin/activate
$ pip install -r requirements.txt

To build html docs from rst files just run:

$ make html

And open with build/html/index.html in your browser.