docs-matrix-spec/scripts
Kegan Dougal 4e1e82f995 Fix paragraph CSS and adjust where paragraphs are in the RST
The CSS for `nature.css` was such that it was preventing `p` tags from
having sufficient vertical whitespace. This meant that you couldn't insert
any kind of spacing between lengthy sections (they just appeared as new lines).

This PR fixes this so you can actually have some whitespace between paragraphs.
As a result of this change, some parts of the spec appeared to have too much
whitespace. These were often sections which shouldn't have begun a new
paragraph anyway (e.g. a single sentence being an entire paragraph, `TODO`
blocks resulting in new paragraphs). This PR fixes the most offending areas
where we shouldn't have been inserting new paragraphs.
2015-09-30 10:43:02 +01:00
..
continuserv Apparently tabs are A Thing 2015-09-18 15:15:55 +01:00
speculator Support viewing the spec at head 2015-09-29 12:41:07 +01:00
basic.css move gendoc to matrix-doc and make it work. rename tutorials section to match matrix.org structure 2014-10-17 02:33:35 +01:00
codehighlight.css Turn on code highlighting for HTTP api responses and add a 2015-09-18 17:26:10 +01:00
gendoc.py Add more logging and make logging context clearer 2015-09-23 15:36:13 +01:00
matrix-org-gendoc.sh Add a README, spell matrix correctly. 2015-02-19 16:53:54 +00:00
nature.css Fix paragraph CSS and adjust where paragraphs are in the RST 2015-09-30 10:43:02 +01:00
README Restructure the first few sections. 2015-06-02 16:27:52 +01:00

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