[sphinx-dev] Re: autosummary usage

2010-03-03 Thread Justin Rosen
anyone? :D On Feb 26, 2010, at 10:18 AM, Justin Rosen wrote: Hey Everyone, I've been reading this group for a while but have yet to post. I'm trying to use autosummary to produce a table with docstring summaries. Only problem is I'm not getting the docstring summaries! Does this on

[sphinx-dev] List Creation in Sphinx

2010-03-03 Thread istihza
Hello, In reStructuredText we can create lists in various formats. For instance: a. item1 b. item2 c. item3 The above will produce the following output: a. item1 b. item2 c. item3 If you enumerate lists with numbers, the output will be like this: 1. item1 2. item2 3. item3 However, in Sphinx

[sphinx-dev] Re: autosummary usage

2010-03-03 Thread akean
On Feb 27, 7:18 am, Justin Rosen wrote: > Hey Everyone, > > I've been reading this group for a while but have yet to post. > > I'm trying to use autosummary to produce a table with docstring summaries. > Only problem is I'm not getting the docstring summaries!  Does this only > work if using a t

Re: [sphinx-dev] rst output

2010-03-03 Thread Joachim Rolland-Marmier
No, there's no such output right now. It is true that reST is generated > and parsed in autodoc, but only because it's the easiest way to get the > reST inside the docstrings parsed as well. > > Of course, it should be able to convert the final node trees to reST again, > but this facility isn't e

[sphinx-dev] flowcharts or other linked diagramatics?

2010-03-03 Thread Chris Withers
Hi All, Has anyone done anything by way of flowcharts or similar with Sphinx? I'd like to document by way of a diagram how several python packages work together and provide links on the diagram to drill down to further information. Has anyone done anything like this? If so, where can I look?

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

2010-03-03 Thread Sebastian Schaetz
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: http://www.graphviz.org/

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

2010-03-03 Thread Sebastian Schaetz
Hi, I am writing an extension for Sphinx that basically is supposed to provide the following functionality: * the user provides a file location using a directive and a parameter inside the rst file * the extension fetches parts of the file, processes those parts and adds them to the doctree in or

Re: [sphinx-dev] List Creation in Sphinx

2010-03-03 Thread Max Battcher
istihza wrote: However, in Sphinx, no matter how you enumerate lists (be it with numbers or letters) the output will only have numbers... That is, Sphinx will convert "a, b, c" to "1, 2, 3" in the output... Is it expected? For whatever reason, Georg didn't copy over the standard docutils CSS c

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

2010-03-03 Thread akean
On Mar 4, 11:27 am, 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.htmlGraphviz all

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

2010-03-03 Thread Fernando Gómez
On 3 March 2010 14:34, Sebastian Schaetz wrote: > What I would love is to generate rst code in a string (including my > custom user data) and simply telling Sphinx to add this rst code to > the doctree. This would allow me to write small rst templates etc. If modifying an rst source file before

[sphinx-dev] Re: List Creation in Sphinx

2010-03-03 Thread istihza
Thanks for the info. I will consider copying them. Firat Ozgul On Mar 4, 12:51 am, Max Battcher wrote: > istihza wrote: > > However, in Sphinx, no matter how you enumerate lists (be it with > > numbers or letters) the output will only have numbers... That is, > > Sphinx will convert "a, b, c" to