Sphinx documentation » History » Revision 6

« Previous | Revision 6/21 (diff) | Next »
Alexander Watzinger, 2020-05-09 17:41

Sphinx documentation

Sphinx is used to generate the in-application manual. The content of the manual can be changed in the .rst files at sphinx/source.

Install Sphinx

apt-get install python3-sphinx python3-sphinx-rtd-theme

Edit manual

Changes are made in the .rst files at sphinx/source

Generate documentation

After editing the HTML sites have to be generated.

sphinx-build ./sphinx/source/ openatlas/static/manual

After finishing changes it is a good practice to delete the openatlas/static/manual directory and generate the whole manual again. Otherwise not all changes (e.g. menu structure) may be propagated correctly.

Updated by Alexander Watzinger over 3 years ago · 6 revisions

Also available in: PDF HTML TXT