The web-page

doc/, doc/tutorials/, doc/exercises/, …

Built once a day from reStructuredText files and docstrings using Sphinx.

$ pip install sphinx-rtd-theme
$ cd doc
$ make  # sphinx-build -b html -d build/doctrees  -n . build/html
...
$ firefox build/html/index.html

We don’t want .png and .csv files in our git repository. Instead, we generate those files by running Python scripts that have a special comment in line 1:

# creates: figure.png, table.csv
...

The .rst files contain reStructuredText directives like shown here:

.. literalinclude:: script.py

.. image:: figure.png

.. csv-table::
   :file: table.csv