Follow
docutils documentation [ - ]
I like that docutils will produce a complete html file from reStructuredText input.
I like that the default html template can be overridden or extended & that basic examples are given.
But who thought it a good idea to a) not *document* the template format(s), & b) use a default template that doesn't even match the basic examples' formatting language?
docutils documentation [ - ]
I can't use either docutils or rst2html5 to generate a complete HTML page with my template, because there's no way I can find to specify the page title in the page head from within the .rst source file, with or without a custom template.
docutils documentation [ - ]
How do I use a per-page title 2x in an rst2html5 template file without:
* using sed, awk, or any other text/macro processing system on the command line, or
* typing more than 1 line of boilerplate giving the title in the .rst source file?
None of the docs I can find say.