Sphinx documentation » History » Revision 7

« Previous | Revision 7/22 (diff) | Next »
Alexander Watzinger, 2020-05-21 23:26

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.
Restructured text

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 almost 4 years ago · 7 revisions

Also available in: PDF HTML TXT