On Sat, Apr 20, 2013 at 8:35 PM, Tarek Ziadé <[email protected]> wrote: > OTHO LaTex is painful to edit/read compared to reST. IIRC Lennart Regebro > (who I added in CC) did his Python 3 porting book entirely in Rest > so he might have an interesting PoV
Yeah, I did it in ReST and output to HTML and PDF via LaTeX. This works well, although you might have to learn a bit too much LaTeX to get the output as you want it. I believe PyDanny and Audrey did the same, and they also output to a couple of eBook formats. In my experience each format you want to support is a significant effort. But that you even *can* support all these formats with Sphinx is a pretty strong argument. It's also super-easy to unit test all your code. Since I needed to support a whole host of Python versions I didn't have my code inline, but in separate external files. But if all your code should run on all the Python versions you support, then you can have the code inline and run tests on it. I'd recommend using Manuel in that case to run the tests. //Lennart _______________________________________________ Python-authors mailing list [email protected] http://mail.python.org/mailman/listinfo/python-authors
