[sphinx-dev] odt2sphinx 0.1.0

Hi all, In order to have non-technical persons write our application user manual, we made a little tool called odt2sphinx that convert an OpenOffice document into Sphinx .rst source files. I released it on pypi [1] today with the hope it gets useful to others. The sources are on bitbucket [2].

Re: [sphinx-dev] offline mode?

Hi Chris, intersphinx can use objects.inv file on the hd. You should download the objects.inv files from the other documentations and give their path to intersphinx : intersphinx_mapping = {'http://docs.python.org/dev': 'python-inv.txt'} Cheers, Christophe 2010/1/14 Chris Withers

Re: [sphinx-dev] offline mode?

See http://sphinx.pocoo.org/ext/intersphinx.html for more information. -- 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] Re: documenting instance attributes

My mistake, it's : .. attribute:: bar your doc 2009/11/11 Joshua Bronson jabron...@gmail.com Thanks for the replies. I'll be following http://bitbucket.org/birkenfeld/sphinx/issue/280/ :) I'd prefer Christophe's method to Edward's because it doesn't require changing (obscuring?) your

[sphinx-dev] Re: documenting instance attributes

Another simple way is to document explicitely the attribute in the class docstring : class Foo: .. attribute bar:: A nice doc def __init__(self): self.bar = 1 My 2 cents Christophe 2009/11/10 Edward Z. Yang edwardzy...@thewritingpot.com Excerpts from Joshua

[sphinx-dev] Re: Progress in rst2pdf-sphinx builder

Hi Roberto, You extension looks very promising ! I was wondering how easy it would be to customize the PDF output with it : - Can we provide stylesheets ? - Is is possible / planned to add chapter numbering ? Thanks a lot, Christophe --~--~-~--~~~---~--~~ You

Re: Next release ?

2009/5/27 Georg Brandl ge...@python.org Christophe de VIENNE schrieb: Hi Georg, I was wondering if you plan to release Sphinx 0.6.2 soon ? Yes, in fact I am -- just a few bugs left on the list. Great ! Thanks, Christophe --~--~-~--~~~---~--~~ You

Next release ?

Hi Georg, I was wondering if you plan to release Sphinx 0.6.2 soon ? Thanks, Christophe --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to

Re: sphinx-contrib repository created

Hi, 2009/5/17 Georg Brandl ge...@python.org Hi, since it was generally thought a good idea, I've just created the sphinx-contrib repo at http://bitbucket.org/birkenfeld/sphinx-contrib/ Anybody who asks will get write permission there, to manage and publish his/her own extension(s).

Re: class renaming - feedback needed!

Nice one. +1 2009/5/13 sffjunkie sffjun...@googlemail.com Or the Docbook tag 'ooclass' Simon --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to

Re: Status update

2009/5/2 Georg Brandl ge...@python.org Now we have a few choices: - Keep the incompatibility. - Rename Sphinx' class. I don't have a suggestion for a better name though. I would go for this option (renaming). And I think it is a change that is acceptable for 1.0 release. My point is

Re: Latex fails if cmdoption contains |

Thank you Georg 2009/3/9 Georg Brandl ge...@python.org: Christophe de VIENNE schrieb: Hi, When using the following directive, make pdf fails with a ! Undefined control sequence. : .. cmdoption:: --startup manual|auto|disabled If I replace the '|' with ',' the error vanish. Thanks

Latex fails if cmdoption contains |

Hi, When using the following directive, make pdf fails with a ! Undefined control sequence. : .. cmdoption:: --startup manual|auto|disabled If I replace the '|' with ',' the error vanish. Thanks, Christophe --~--~-~--~~~---~--~~ You received this message

Re: Bug Report: new line for lists

Hi, Do you refer to http://sphinx.pocoo.org/rest.html#lists-and-quotes ? The way I understand it is that there is no need to write a long item on one line, one can split it in several line while 'staying' in the list item. It is not saying that this second line will be a new line in the output.

Re: Creating and adapting extensions

Hi Timmie, The fact that you have to parse yourself the rst files and docstrings seems wrong to me. Does your citations have to be like [mybook] ? Or could they be written :bibtex:`mybook` ? With the later you would just have to add a new reference type, and it would be instantly handled

Re: how to markup inline images?

This is doable with inline markup and substitution. See the rest documentation : http://docutils.sourceforge.net/docs/user/rst/quickref.html#inline-markup Christophe 2008/12/16 MishaS mikhail.sobo...@gmail.com: Hi, I'd like to write a document that requires inline images. So something

Re: :class: does not work inside :type :

Hi, 2008/12/15 Georg Brandl ge...@python.org: Christophe de VIENNE schrieb: Hi Georg, I am having a little problem with the :type: keyword and :class:. In the following code, all the :class:`TestClass` are rendered as links to the class definition, except for the one in the :type p1

Re: Creating and adapting extensions

Hi, I do not have answers to all of your questions, but out of my experience making my own extension, here are a few ones : 2008/12/15 Timmie timmichel...@gmx-topmail.de: Hello, I have some questions while modifying and creating extensions. First, where can I find a preview of the

:class: does not work inside :type :

Hi Georg, I am having a little problem with the :type: keyword and :class:. In the following code, all the :class:`TestClass` are rendered as links to the class definition, except for the one in the :type p1: keyword : .. class:: TestClass .. function:: test_function :param p1: test,

Re: Multi-lingual documentation

how terrible the lookups could get, and (to keep consistent w/ behavior of other directives) how to manage paragraph translations, such as: .. translate:: * a list * of items ... still thinking... On Thu, Nov 20, 2008 at 5:25 AM, Christophe de VIENNE [EMAIL PROTECTED] wrote: Hi, 2008

Re: How do I convert a word document to reStructured text?

Another hurried answer : I would try to convert to open document first using open office, then use sxw2rest that is mentioned here : http://docutils.sourceforge.net/docs/user/links.html#import My 2 cents, Christophe 2008/10/28 Martin Hans [EMAIL PROTECTED] Hi, Currently our product's user

Re: graphviz extension

Hi Charles, I am interested in your graphviz extension, and willing to give a hand to improve it if needed. Before digging into it to fix the image path problem that was mentioned before, I would like to know if you made any change on it and have a more recent version to share ? Thanks,