Re: [Python-authors] Code in books

2014-02-24 Thread Harry Percival
My book is structured like a tutorial, so each code example in the book builds on the last -- they don't stand alone. the book also contains lots of listings showing commands to run and expected output. So my test suite works by reading the book as HTML (I prefer that, helps catch any mistakes i

Re: [Python-authors] Book writing software

2013-04-21 Thread Harry Percival
I'm writing a book for O'Reilly (http://www.obeythetestinggoat.com/), and they recommended AsciiDoc, which I've been really happy with. http://www.methods.co.nz/asciidoc/userguide.html It's a lot like RST or Markdown, but it's designed to convert to docbooks xml as well as html, so it gives you m