[Doc-SIG] Docutils and ResT

Voidspace mike at pcblokes.com
Fri Oct 22 14:57:26 CEST 2004

Hello David,

David Goodger wrote:

> [Michael Foord]
> > I hope progress is being made on pysource
> Yes, I'm working on it now.  You can expect something before long.

Docutils is *very* good - I really appreciate being able to use ResT.
Docfactory will be nice as well - for some reason I was getting slightly 
different (not so good) output from Docfactory than from buildhtml.py - 
which I thought was odd.

> > 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.
> There's an interface that does exactly that.  See
> <http://docutils.sf.net/docs/api/publisher.html> for a brief overview.
> You want the ``publish_parts`` function.

Aha... fantastic
Very interesting.

> > 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.
> What kind of directives?
> (Directives are added to the parser, not the reader.  See PEP 258 for
> an overview.)

Ok - thanks. That gives me a good start. When I run into difficulties 
I'll let you know :-)
(I'm sure you're delighted to hear that).

The sort of things I'm hoping to add are :

a display box
auto generate indexes from the contents of directories - so need a meta 
description in each page and a directive to generate the index
images in different 'classes' so I can apply different styles (left, 
centered and right basically)

> > I am hoping that people won't object to me posting questions here
> > about this....
> No objections.  That's what here is for!  The docutils-develop list is
> also available. 

Ok - might be more appropriate.

> > 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
> One suggestion: that page would look a lot better if the stylesheet
> were installed on the site.
Isn't it ?? Should be - oops............
Thanks for your answers and help - much appreciated.




The Place where headspace meets cyberspace. Online resource site - covering science, technology, computing, cyberpunk, psychology, spirituality, fiction and more. 

Python utilities, modules and apps.
Including Nanagram, Dirwatcher and more.

Everyone has talent. What is rare is the courage to follow talent
 to the dark place where it leads. -Erica Jong
Ambition is a poor excuse for not having sense enough to be lazy.
         -Milan Kundera

More information about the Doc-SIG mailing list