To avoid polluting your development system you should create and use an isolated Python environment to install and use Sphinx.

To do so you need to install the Python virtualenv module. On Debian/Ubuntu you can do this the following way:

# apt-get install python3-virtualenv

To initially setup the virtual Python environment simply execute the following lines:

$ make buildvenv

$ make autobuild

Now open http://localhost:8000/ in your browser to view the documentation. Any changes to the documentation code will be rendered now immediatelly.

$ make clean

• http://www.sphinx-doc.org/en/stable/rest.html
• http://docutils.sourceforge.net/docs/user/rst/quickref.html
• https://github.com/ralsina/rst-cheatsheet/blob/master/rst-cheatsheet.rst
• https://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html

To contribute to the documentation simply clone this repository, make your changes and create a PR (pull request).

CC BY-SA 3.0