reStructured Text - suitable for non-documentation?

Florian Schulze florian.proff.schulze at
Mon Jun 2 14:01:43 CEST 2003

On Mon, 02 Jun 2003 02:31:44 GMT, Ben Finney <bignose-hates-spam at and-zip-> wrote:

> Howdy all,
> I'm engaged on a low-priority, long-term project to "refactor" my web
> pages.  I don't want the content in a database; I'm much more
> comfortable editing text files.  However, I do want content to be
> completely separate from presentation markup or code.
> So I've been investigating the various plain-text markup schemes
> available.  I.e., the ones where the idea is that the source be
> reasonably readable as a plain-text document, and existing plain-text
> "markup" conventions be leveraged as much as possible.  The Wiki
> schemes, the BB schemes, et al are all in this group.  None of them are
> particularly satisfactory though.
> My latest investigation is of reStructured Text, the proposed docutil
> markup scheme:
> <>
> This seems a well thought out scheme, with coverage of most of the
> things I want to do in web pages.
> So, some questions:
> Who is using reStructured Text actively?
> Who's using it for things other than Python documentation?
> How applicable do you think it is for non-documentation text?
> Are there non-Python tools for processing it (preferably PHP)?
> Am I insane for even thinking of such a thing?
> Are there better alternatives (i.e. ones specifically designed for
> marking up web page content in plain text)?

I want to do exactly the same. I already started to use it to some extend 
and for me it works well. I use rst2html from the docutils sandbox and I 
rewrote my own version of ht2html to better suite my needs. The website 
isn't online yet, but it looks very promising. If you are interested, I can 
send you an example. I have to do one anyway, because I want to show it to 
a friend. I also want to include template functionality. The goal is to 
move all the things that can be postprocessed to my local machine. Before I 
did much stuff in PHP, but that isn't really needed as it's not dynamic.


More information about the Python-list mailing list