[Doc-SIG] Docutils and ResT

[David Goodger]

[Michael Foord]
 > for some reason I was getting slightly different (not so good)
 > output from Docfactory than from buildhtml.py - which I thought was
 > odd.

It could be a stylesheet issue.  HTML with the stylesheet looks a lot
better than without.

 > The sort of things I'm hoping to add are :
 >
 > a display box

Can you elaborate?

 > auto generate indexes from the contents of directories - so need a
 > meta description in each page and a directive to generate the index

What kind of index?  Are you thinking of a simple list (like a table
of contents), or a detailed index (like in the back of a reference
book)?

 > images in different 'classes' so I can apply different styles (left,
 > centered and right basically)

You can do that now:

     .. image:: picture.png
        :class: right

The "class" option is directly transferred to a "class" attribute on
an HTML <img> tag, so all you have to do is add corresponding styles
to your stylesheet.  Details here:
<http://docutils.sf.net/docs/ref/rst/directives.html#image>.

 > Thanks for your answers and help - much appreciated.

You're welcome.

-- 
David Goodger <http://python.net/~goodger>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 256 bytes
Desc: OpenPGP digital signature
Url : http://mail.python.org/pipermail/doc-sig/attachments/20041022/111f1163/signature.pgp