Throw in gendoc.py if a spec section doesn't end with \n\n There needs to be TWO new lines at the end of each spec section else the title of the next section merges into the last paragraph of the earlier section. This happens without rst2html producing a warning, and results in the section heading of a file disappearing(!) |
||
---|---|---|
.. | ||
continuserv | ||
speculator | ||
basic.css | ||
gendoc.py | ||
matrix-org-gendoc.sh | ||
nature.css | ||
README |
Requirements: - docutils (for converting RST to HTML) - Jinja2 (for templating) To generate the complete specification along with supporting documentation, run: python gendoc.py The output of this will be inside the "gen" folder. Matrix.org only ("gen" folder has matrix.org tweaked pages): ./matrix-org-gendoc.sh /path/to/matrix.org/includes/nav.html