[Zope] Re: reStructuredText rendering from commandline

[Ng Pheng Siong]

On Tue, Sep 30, 2003 at 08:38:53AM +0200, Andreas Tille wrote:
> On Tue, 30 Sep 2003, Ng Pheng Siong wrote:
> > docutils-0.3/tools/html.py
> > Turns your restructured text file into html.
> >
> IMHO this HTML is a little bit poor.  I had a view on it whether it might
> be usable as a replacement for the StructuredText stuff I use in the
> Debian Zope Book package but it is nearly unuseable because it uses poor
> formating.  Where heading tags (<h1> or <h2>) would be apropriate, simple
> <p> tags are used followed by a <blockquote>.

Above-mentioned html.py eventually invokes docutils.core.publish, which
does the following:

- self.reader.read(...)
- self.apply_transforms(...)
- self.writer.write(...)

By visual inspection of ZReST in Zopes 2.6 and 2.7, class ZReST's render
does the same three steps.

I'd imagine the magic to improve the html output is in apply_transforms.

Cheers.

-- 
Ng Pheng Siong <ngps at netmemetic.com> 

http://firewall.rulemaker.net  -+- Manage Your Firewall Rulebase Changes
http://sandbox.rulemaker.net/ngps -+- Open Source Python Crypto & SSL