The users manual is maintained using Sphinx, a documentation tool written in Python. The easiest way to setup Sphinx (and Python) environment is to install Anaconda, which enables you to install Sphinx package using Anaconda navigator.
The source
directory contains all of the documentation sources as .rst
files.
The document sources must be written in reStructuredText format.
If you are not familiar with reStructuredText, please refere this document.
To build html files, type the following command in the top of working directory:
$ make html
The outputs are generated under the build/html
directory.
If successfully built, you can browse the local html files by your favorite web browser.
Please do not commit any files generated by Sphinx.
If changes of .rst
files are pushed or merged to the master branch, the documentation pages will be automatically published as https://rcsoccersim.readthedocs.io/.