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

Chris McDonough chrism@digicool.com
Tue, 24 Jul 2001 15:06:37 -0400


Ron,

as a part of "opening up" the CVS repository to external contributions,
lots of things are being re-modularized that sort of lost their
independence inside CVS under DC control.  I'd imagine stx is one of
them.  That said, even currently, you can take the StructuredText
package out of Zope entirely and it will work just fine.  It's
lib/python/StructuredText.  There's a Wiki at
http://www.zope.org/Members/jim/StructuredTextWiki/FrontPage , probably
the most important part of which is the description of StructuredTextNG
(the current implementation).  There is a converter to DocBook shipped
with it.

- C


Ron Bickers wrote:
> 
> 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.
> 
> _______________________________________________
> Zope maillist  -  Zope@zope.org
> http://lists.zope.org/mailman/listinfo/zope
> **   No cross posts or HTML encoding!  **
> (Related lists -
>  http://lists.zope.org/mailman/listinfo/zope-announce
>  http://lists.zope.org/mailman/listinfo/zope-dev )

-- 
Chris McDonough                    Zope Corporation
http://www.zope.org             http://www.zope.com
"Killing hundreds of birds with thousands of stones"