[sphinx-dev] Creating roles in Sphinx extensions

2010-03-04 Thread Kevin Horn
I'm creating a Sphinx extension which just adds a custom docutils "role". A couple of questions: 1) What's the opinion of the list on whether to use a standard "role function" or the CustomRole class in docutils.parsers.rst.roles.py? Which is better and why? 2) What's the best way to access a Sp

[sphinx-dev] Re: Adding stuff to doctree in a convenient way

2010-03-04 Thread Sebastian Schaetz
> But... IIRC the "source-read" event fires just after reading the file > from disk, that is  *before* the rst is parsed. Exactly, which means I would have to do it myself to get the directives and their parameters but that is what I try to avoid. -- You received this message because you are su

Re: [sphinx-dev] Re: Adding stuff to doctree in a convenient way

2010-03-04 Thread Fernando Gómez
On 4 March 2010 11:40, Sebastian Schaetz wrote: > Thank you for this suggestion. I think this would be possible however > then I lose the advantages of having the rst already parsed once. But... IIRC the "source-read" event fires just after reading the file from disk, that is *before* the rst i

[sphinx-dev] Re: Adding stuff to doctree in a convenient way

2010-03-04 Thread Sebastian Schaetz
> If modifying an rst source file before the rst markup is parsed is an > adequate solution, then the "source-read" event may be what you need: > >    http://sphinx.pocoo.org/ext/appapi.html#event-source-read Thank you for this suggestion. I think this would be possible however then I lose the adv

[sphinx-dev] Re: Inheritance diagram requires pickling (was: Is it posible to insert hyperlinks (or other markup) in class signatures?)

2010-03-04 Thread Václav Šmilauer
> > Inheritance diagrams don't work for me (they just don't > > produce anything), and this is a nice way to show it somehow (I will > > bug you with inheritance diagrams separately, as I try it out more; I > > suspect (again) boost::python vs. pure python classes.) > > Quite possible :( > > That s

Re: [sphinx-dev] flowcharts or other linked diagramatics?

2010-03-04 Thread SHIBUKAWA Yoshiki
Hi, > Has anyone done anything by way of flowcharts or similar with Sphinx? I created sequence diagram extension. http://www.shibu.jp/sdeditext/ It uses quick sequence diagram editor(sdedit) to generate graphic files. Both Graphviz and sdedit need their own script's knowledge. Graphviz is more

Re: [sphinx-dev] Re: flowcharts or other linked diagramatics?

2010-03-04 Thread Chris Withers
Sebastian Schaetz wrote: On Mar 3, 11:11 pm, Chris Withers wrote: Hi All, Has anyone done anything by way of flowcharts or similar with Sphinx? Maybe the graphviz extension is what you are looking for: http://sphinx.pocoo.org/ext/graphviz.html Graphviz allows you to create graphs like this: