Re: [Docutils-develop] doctree -> rst conversion

[Stefan R. <lis...@st...>]

on 22.02.2008 19:56 David Priest said the following:
> Hello, all.  I have been given the go-ahead to implement a web-based
> documentation system using rst, following on some work I'd
> performedseveral years ago.
> 
> One of my first needs is to parse and re-write a rst file into
> sections and subsections.  The most obvious approach is to use the
> doctree, whichappears to have all the support required to do this.
> 
> Indeed, it looks so easy that I imagine someone has already done it.
> Hascode ever been released to the public?

I just committed code I wrote some time ago to a branch 
(lossless-rst-writer).
The idea was to work towards a byte-exact rst->doctree->rst roundtrip 
(plus beautifying and style enforcing options), but I got distracted :-)

What's in there now is an incomplete rst-writer (that is surely less 
complete than the one by Roberto) and a functional testing script 
(test_rst2rst_functional.py) that I used for 'test-driven development'.

A really lossless transformation would also need a subclass of the rst 
parser (losslessrst) that annotates the doctree with spacing and 
line-break information, info about directives that are transformed 
during parsing, ...

I don't know if that's helpful for you, but anyway, better if it sits in 
the repository than here.

cheers,
stefan