[Zope] The Zope Book (in my hands) and StructedText

Ron Bickers rbickers-dated-996605342.f46f60@logicetc.com
Tue, 24 Jul 2001 14:49:01 -0400


I got my copy of The Zope Book today and it looks good.  Well, it looks like
every other New Riders book, but that's good enough for me.  Thank you Amos
and Michel for driving this and of course thanks to everyone else involved.

I'm particularly impressed that it was written in StructuredText (is it
appropriate to call it STX?) and converted into the necessary formats for
publishing.

I had the opportunity the other day to suggest that someone use STX for
their documentation project (which is much smaller than a book), but I
couldn't convince them for several reasons.  First, there is no STX module
(that I know of) packaged outside of Zope and there appears to be a separate
unsynchronized version in The Zope Book CVS.  Are they the same and I just
don't know it or are they in fact different versions?  Also, short of
pulling some scripts out of The Zope Book CVS, I don't know of any
documentation or packaged tools for converting or otherwise processing STX
(outside of Zope).  I'm particularly interested in the possibility of
converting to GNU info format and man pages, if that's even a reasonable
thing to expect.  I wouldn't be against writing converters myself if there
isn't already another way.

Are there plans to package STX as a separate module along with documentation
and tools for converting to various popular formats?

Thanks!
_______________________

Ron Bickers
Logic Etc, Inc.