Howdy,
recently, Matthew Brett pointed out that reST supports a mode that's
very handy for writing tutorial-like documents that contain code
blocks including their output, and they can even be run as tests.
Here's a simple example with its corresponding source:
http://neuroimaging.scipy.org/site/doc/manual/html/users/analysis_pipeline.html
http://neuroimaging.scipy.org/site/doc/manual/html/_sources/users/analysis_pipeline.txt
and they can even use the MPL math support, as seen here:
http://neuroimaging.scipy.org/site/doc/manual/html/users/glm_spec.html
http://neuroimaging.scipy.org/site/doc/manual/html/_sources/users/glm_spec.txt
But we were thinking it would be great to have also plot support for
this, without being forced to use standalone scripts like in mpl's
current form of the plot directive. I unfortunately have to go now
and will be mostly offline for a week, but I just had a chat about
this with John, so I want to leave some context in here in case this
is of interest to you guys. If there's a discussion on the API, I'll
do my best to keep up, but I'm also cc'ing the nipy list so those
interested can pitch in (though we should keep the conversation to the
MPL list, where the plot machinery is implemented).
Cheers,
f