[matplotlib-devel] Question about sphinx doc extensions

[Ted D. <ted...@jp...>]

We're in the process of converting our documentation from doxygen (parsing C++ and post processing w/ many huge regexp's to make it look like python) to using sphinx.  I was curious about the equation formatting extension that you guys wrote and how it compares to the one (or is it two?) that come with sphinx.  What didn't work about the sphinx math extensions that caused you to write a new one?  Are there any plans to incorporate some of the MPL extensions into sphinx?

We'll definitely need latex equations, testing of examples (maybe some combination of the MPL plot and doctest like functions), and inheritance diagrams so we might just use the MPL sphinx extensions for these.

We're also planning on making some custom html templates to make our output more like doxygen (especially having a class summary showing all the methods at the top of the screen).  We may also look at processing our users guide, our python module, matplotlib, python, and any other 3rd party package we install that uses sphinx (and maybe some that don't) to create a single set of docs showing all the python modules we deliver that has a common look to it.

Thanks,
Ted