On Sat, Feb 21, 2009 at 4:14 PM, Georg Brandl <[email protected]> wrote:
> > Michael Droettboom schrieb: > > > That's the one that matplotlib is currently using for its own docs. I > > don't know if any new features exist in forks elsewhere -- which is why > > it's great that Gael has taken it on to sort all this stuff out. > > > > > http://matplotlib.svn.sourceforge.net/viewvc/matplotlib/trunk/matplotlib/doc/sphinxext/inheritance_diagram.py?revision=6863&view=markup > > < > http://matplotlib.svn.sourceforge.net/viewvc/matplotlib/trunk/matplotlib/doc/sphinxext/inheritance_diagram.py?revision=6863&view=markup > > > > > > It has been updated since the last time I mentioned it on the Sphinx > > list to put the image files into the build directory -- it basically > > follows the pattern used in the Sphinx built-in math extensions (this > > was sort of the missing info I couldn't figure out on my own earlier). > > Cool! May I take it and include it in Sphinx? I'll have to make a few > changes, e.g. convert the directive to a class like all others in 0.6, > add a config value for otherwise hardcoded settings, make warnings out > of errors etc. Maybe I'll also abstract a bit of the subprocess calling > code now that we have this and pngmath sharing it. Yes. It's all under a BSD license (as the rest of matplotlib), so feel free. I appreciate any and all improvements. I suspect you're a much more experienced Sphinx extension writer than I ;) > > > > One aspect that is not ideal is how it deals with cross-references. The > > HTML version produces a clickable image map that links to the > > documentation of each class. I manage this by stuffing xfile_ref nodes > > in the tree at tree-building time, let Sphinx resolve those > > cross-references to real URLs, and then pull them out when the graph > > node is later visited. If there's a way to convert a class name to a > > URL in a more direct way that I just wasn't able to find, that would > > probably be less cumbersome. > > I'd call that way clever rather than cumbersome - you don't have to > duplicate the code from environment.py :) > Cool! Mike -- Michael Droettboom http://www.droettboom.com/ Sent from my MacBook Wheel This message is confidential, intended only for the named recipient(s) and may contain information that is privileged or exempt from disclosure under applicable law. If you are not the intended recipient(s), you are notified that any dissemination, distribution, or copying of this message is strictly prohibited. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" 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/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
