[Doc-SIG] Getting started with restructured text
Amos Latteier
amos@zope.com
Wed, 21 Nov 2001 16:52:19 -0800
Hi,
I don't know much about restx, but what I've seen so far impresses me.
The spec seems well thought out. I currently use structured text quite a
bit. In fact I've written a book with it. I am painfully aware of
shortcomings in structured text. I'd like to evaluate restx as an
alternative for writing articles and books.
I downloaded the latest cvs snapshot and tried to figure out how to get
going. I ran into a couple problems:
* distutils doesn't add __init__.py files to the dps and parsers
directories that it creates. This means that they aren't considered
packages. I don't know if this is a distutils bug or a problem with how
restx uses distutils.
* restx seems to require that the entire dps package be installed.
* There is no obvious way to create HTML output. Should I write an HTML
formatter along the lines shown in dps.formatters.model? Or is XSLT
preferred?
Thanks for any pointers.
-Amos
--
Amos Latteier amos@zope.com
Zope Corporation http://www.zope.com/