[Edu-sig] Writing books/manuals containing code
ajsiegel at optonline.net
Fri Sep 2 14:20:33 CEST 2005
> -----Original Message-----
> From: edu-sig-bounces at python.org [mailto:edu-sig-bounces at python.org] On
> Behalf Of Dethe Elza
> And sometimes even XML is too heavy--in which case you can use
> reStructured Text (or reST, part of the Python Docutils project).
> Using reST is kind of like wiki markup, but it can be transformed
> into DocBook, reST XML, XHTML, PDF, etc. Much more readable and
> editor-friendly than XML.
Again, just offering my own experience - I found learning to work with reST
well worth the investment. It's a strange beast in a way - you write pretty
naturally, but as if you were using a very primitive text editor with few
"modern" capabilities - and by so doing you are connected, as mentioned
above, with the state of the art capabilities of XHTML ,XML, PDF, etc.
>If you are on OS X there is even a reST-
> specific editor which transforms to XHTML as you go, for WYSIWYG-
> ish goodness.
Frustrating that it's OS X specific, as I don't have easy access to it.
Would be anguish to give it a whirl.
More information about the Edu-sig