On Mar 20, 12:58 pm, grkunt...@gmail.com wrote: > I am considering teaching a beginning programming course using Python. > I would like to prepare my class handouts in such a way that I can > import the Python code from real ".py" files directly into the > documents. This way I can run real unit tests on the code to confirm > that they work as expected. > > I am considering using LaTeX to write the handouts and then converting > them to PDF files. I will probably use a Makefile to convert the LaTeX > with embedded Python code into the PDF files using pdflatex. > > I will probably organize my directory structure into sub-directories > py-src, py-test, doc-src, and doc-dist. > > I will be starting out using Windows Vista/cygwin and hopefully switch > to a Macbook this summer. > > Any thoughts?
One word: Sphinx. -- http://mail.python.org/mailman/listinfo/python-list
