[Edu-sig] Writing books/manuals containing code

Arthur 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[1] (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[2] 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 mailing list