Hello David and Michael,

Thank you for the useful references to rst2chunkedhtml and to Sphinx. After careful reading of the documentation, I understand that Sphinx, with its template-based configuration mechanisms, is exactly the tool I was looking for.

Thanks again,

On Tue, Jan 6, 2009 at 12:00 PM, Michael Foord <fuzzyman@voidspace.org.uk> wrote:
Hey Jonas,

You may want to look at Sphinx which can build tables of contents for multiple input rest docs. It can also build indexes.


Michael Foord

Jonas Latt wrote:
I am playing around with docutils and like its straightforward interface and
ease of use. I am however stuck with the following problem. I would like to
generate a fairly long html documentation from rst source. Because of the length
of the document, it would be good to start a new html file for each section
instead of flushing everything into a single file. Although I understand that I
could simply split the rst source into multiple files an apply docutils
iteratively to each of them, I do not think that this would be sufficient for my
purposes. Indeed, I would like to have a consistent table of contents which
refers to all sections of the document, and I wouldn't know how to generate such
a table with this iterative approach.

Instead, I would guess that I need to parse the whole document at once, extract
the document tree and somehow split it up, section after section. I am however
not familiar with docutils and wonder how to do this best. Should I write a new
transformer? Or a new writer? Or something else? Any hint or suggestion on this
topic is very much appreciated.

Docutils-develop mailing list

Please use "Reply All" to reply to the list.