The Zope Book (in my hands) and StructedText
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.
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"
participants (2)
-
Chris McDonough -
Ron Bickers