This has cropped up a number of times already. The main points: - ipython notebooks are great for examples from pedagogical point of view - there is no standard way to run tests on them - there is no standard way to add them to sphinx docs (this http://matplotlib.sourceforge.net/sampledoc/ipython_directive.html is for ipython scripts, not for complete notebooks)
I propose that we become early adopters of https://github.com/ipython/nbconvert which seems to be how the ipython team plans to address these issues. (correct me if I am wrong) The proposal: - a simple check added to whatever tests the examples at the moment - if nbconvert is installed it uses it to generate .py files and test them - a simple script added to the makefile for the docs that detects if nbconvert is installed and generates html or whatever to be added to the docs Please keep in mind that anything more feature complete than this proposal will take disproportionately more time to implement at the moment. When the tools like nbconvert mature we may switch to a better workflow. I can try to take care of this in a week after my exams if there is interest in the proposal. -- You received this message because you are subscribed to the Google Groups "sympy" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/sympy?hl=en.
