On Wed, 26 Mar 2008, Rich Shepard wrote: > After looking at the docutils page on sourceforge.net, > I don't think that's what I want. I'm not trying to > produce program documentation, but the inputs and outputs > of a mathematical model whose UI and some code are written > in Python
Take a look at this: <URL:http://docutils.sourceforge.net/rst.html> <URL:http://docutils.sourceforge.net/docs/user/rst/quickref.html> reStructuredText is a super simple markup language. It has an ``include`` directive. So you can layout the basic document structure and then simply include programmatically produced sections. It also has directives for including graphics. Output is produced with writers. There are two simple scripts, rst2html.py and rst2latex.py, that may interest you. So the process could work like this: - create a "shell" for you report, comprising the stuff that does not change - use the include directive to indicate inclusion of generated content - use the ``image`` directive to indicate image files for inclusion (e.g., PDF figures) - run rst2latex.py on your file to produce the equivalent LaTeX document - process the LaTeX to PDF as usual reStructuredText has only modest support for citations, but it can be supplemented by bibstuff if you have serious citation needs. hth, Alan Isaac PS Make sure you look at ``rst2latex.py --help`` since there are some very useful options.