Re: [Docutils-develop] Split a document into multiple HTML pages

[Jonas L. <jon...@gm...>]

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,
Jonas


On Tue, Jan 6, 2009 at 12:00 PM, Michael Foord <fuz...@vo...>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.
>
> http://sphinx.pocoo.org/
>
> 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
>> Doc...@li...
>> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>>
>> Please use "Reply All" to reply to the list.
>>
>>
>
>
> --
> http://www.ironpythoninaction.com/
> http://www.voidspace.org.uk/blog
>
>
>