[Doc-SIG] Docutils and ResT
Michael Foord
mike at pcblokes.com
Fri Oct 22 01:51:25 CEST 2004
Hello,
I'm a very recent, but appreciative, convert to Docutils and ResT. I'm
gradually converting my docstrings and module documentation to ResT. I
hope progress is being made on pysource - to be fair epydoc is pretty
good though.
Anyway - enough waffle. I'd like to convert docutils to emit *part* of
an html page. This is so that I can also write a preprocessor and
develop an automatic content management system for my website. This will
allow me to do all the content for my website in ResT rather than HTML -
hurrah.
This end of the project is simple enough - I can modify the HTML writer
to not do the head and tail of the page. I'd also like to extend ResT a
bit to add a few directives, so I'll need to tinker with the reader
which looks a bit more complex. I am hoping that people won't object to
me posting questions here about this.... [I'd like to auto generate
index pages and few other interesting bits and pieces]
Yours, hopefully not too annoyingly...
Michael Foord
p.s. If anyone is vaguely interested in my ideas I kind of summarised
them at :
http://www.voidspace.org.uk/documents/voidspace_manifesto.html
voidspace is badly in need of a revamp *sigh* - XHTML and CSS here I
come....
http://www.voidspace.org.uk/atlantibots/pythonutils.html
More information about the Doc-SIG
mailing list