Re: [sphinx-dev] How to override values in conf.py by values read from a Settings.yml (YAML) file?

2012-07-25 Thread Sebastian Wiesner
2012/7/23 Martin Bless m.bl...@gmx.de: Hello everybody, maybe there is an obvious solution - but I just don't see it. At the end of 'conf.py' I want to read and parse an additional 'Settings.yml' configuration file and add those settings to what we already have in 'conf.py'. If present

Re: [sphinx-dev] autodoc and module variables

2012-03-16 Thread Sebastian Wiesner
Am 16. März 2012 11:34 schrieb Andrea Crotti andrea.crott...@gmail.com: On 03/16/2012 10:31 AM, Daniel Neuhäuser wrote: A colon has to follow the hash like #: so in order for Sphinx to pick it up as a doc string for that attribute. Ah great thanks, just to check, is it written anywhere?

Re: [sphinx-dev] sphinx-build and outdir

2012-03-15 Thread Sebastian Wiesner
Am 14. März 2012 06:17 schrieb Andrea Crotti andrea.crott...@gmail.com: I'm having some troubles understanding the wonders of sphinx-build.. So in mailman 3 we have a perfectly working python setup.py build_sphinx, that reads the setup.cfg file with the following: [upload_docs] upload_dir:

Re: [sphinx-dev] Feature Flags in Sphinx documentation

2011-09-20 Thread Sebastian Wiesner
2011/9/20 ashwin rashwi...@gmail.com: Hi All, I have a requirement in which I need to do the following: a. Generate documentation for different set of products. b. For all these  products, there would be only one set of REST files. c. We want to have a feature flag in these REST files.

Re: [sphinx-dev] autodoc: keeping names of contants in signature

2011-08-31 Thread Sebastian Wiesner
2011/8/31 Sebastian Rahlf ba...@rotekroete.de: Hi! I'm using Sphinx's autodoc feature to document my API. For example::    DEFAULT_OPTION = 'default'    def do_something(msg, option=DEFAULT_OPTION):        print msg The generated documentation now shows the following signature:    

Re: [sphinx-dev] autodoc: keeping names of contants in signature

2011-08-30 Thread Sebastian Wiesner
2011/8/30 Sebastian Rahlf ba...@rotekroete.de: Hi! I'm using Sphinx's autodoc feature to document my API. For example::    DEFAULT_OPTION = 'default'    def do_something(msg, option=DEFAULT_OPTION):        print msg The generated documentation now shows the following signature:    

Re: [sphinx-dev] Persistent storage and conditional rebuild in extensions

2010-08-17 Thread Sebastian Wiesner
): # look up normalized signature in the tag file HTH Sebastian Wiesner -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev

[sphinx-dev] 3rd party extensions

2010-07-21 Thread Sebastian Wiesner
Hi, http://bitbucket.org/birkenfeld/sphinx-contrib seems to be kind of semi-official third-party extension repository for Sphinx, some extensions developed in this repository are also released on PyPI as sphinxcontrib-*. However, this repository is neither mentioned in the Sphinx documentation

Re: [sphinx-dev] Re: A set of extensions for sphinx

2010-04-16 Thread Sebastian Wiesner
On Thursday 15 April 2010 00:23:32 Tim Michelsen wrote - lunar.sphinx.ext.issuetracker: Link issue references like #10 to the issue trackers in GitHub or BitBucket. What to you think about Launchpad, Sourceforge and Google Code? No objections, I'm just not using any of these services and

Re: [sphinx-dev] Re: A set of extensions for sphinx

2010-04-16 Thread Sebastian Wiesner
On Friday 16 April 2010 11:52:11 Sebastian Wiesner wrote On Thursday 15 April 2010 00:23:32 Tim Michelsen wrote - lunar.sphinx.ext.issuetracker: Link issue references like #10 to the issue trackers in GitHub or BitBucket. What to you think about Launchpad, Sourceforge and Google

[sphinx-dev] A set of extensions for sphinx

2010-04-13 Thread Sebastian Wiesner
Hi, I've written a couple of extensions for Sphinx, that you may or may not find useful: - lunar.sphinx.ext.programoutput: Include the output of programs into documentation - lunar.sphinx.ext.ansi: Parse ANSI color sequences in program output and color HTML output -

[sphinx-dev] Re: Three sphinx questions

2009-08-26 Thread Sebastian Wiesner
At Tuesday 25 August 2009 00:58:06 2) How can I sort members using autodoc in the order they were defined? autodoc imports the module and analyzes its namespace, which is an unordered dictionary. The order of definition cannot be restored from this dictionary. You have to discard the

Re: Sphinx for general use

2008-11-09 Thread Sebastian Wiesner
Sunday 09 November 2008 20:32:58 Georg Brandl Hans Fangohr schrieb: Dear all, Alaric Haag schrieb: Hello, The Sphinx page bills it as a tool for documenting Python projects. I perceive it to be more of a document management tool that uses ReST. I've barely scratched the surface