[sphinx-dev] ".. rubric::" and ":class:" don't play nice together when building PDF

Hi, The Sage project (www.sagemath.org) uses Sphinx 0.6.3 for its standard documentation. Recently, I came across a case where mixing ".. rubric::" and ":class:" would not result in any problems building the HTML version of the Sage reference manual, but the PDF version wouldn't build. The relevan

[sphinx-dev] Sphinx 1.0b2 autodoc: parameter types not showing up in info field lists

I've just started using Sphinx to document my first real Python project and am loving it so far. I'm having a problem with autodoc though: I haven't managed to get parameter types to show up in the parameter list of function/methods in HTML builds. I haven't found anything either in Sphinx' docume

[sphinx-dev] Namespace packages

Hello, I am trying to use automodule on one of my project's modules, and i'm getting the following error message: {{{ reading sources... [100%] test /home/pferreir/indico/cds-indico/doc/api/source/test.rst:4: (WARNING/ 2) autodoc can't import/find module 'indico.tests', it reported error: "No mod

[sphinx-dev] Search Function Firefox on Linux (Centos+KDE)

We are testing out using Sphinx for a cross-platform app, and it looks ok on both Windows and Linux, apart from one wrinkle. The search function simply doesn't do anything on Linux. No error messages, just nothing. The same doc set works perfectly on windows xp and 7. I'm running CentOS 5 with KDE

[sphinx-dev] A way to reuse hyperlinks?

Hello, is there a way to reuse hyperlinks in the sphinx system? i.e - avoid copy-pasting urls from file to file? for example I would like to have external links entered like so: `some link text `_ and in some other file: .. _name_for_url: http://example.com/ Thanks. Evgeny. -- You received

Re: [sphinx-dev] A way to reuse hyperlinks?

Am 25.06.10 02:45, schrieb Evgeny: > Hello, is there a way to reuse hyperlinks in the sphinx system? i.e - > avoid copy-pasting urls from file to file? I think there is a way to do this with substitutions. http://sphinx.pocoo.org/rest.html#substitutions -- Jan Ulrich Hasecke DZUG e.V. (Deutschs

Re: [sphinx-dev] Namespace packages

On 06/22/2010 10:38 AM, Pedro Ferreira wrote: Hello, I am trying to use automodule on one of my project's modules, and i'm getting the following error message: {{{ reading sources... [100%] test /home/pferreir/indico/cds-indico/doc/api/source/test.rst:4: (WARNING/ 2) autodoc can't import/find m

Re: [sphinx-dev] A way to reuse hyperlinks?

On 06/24/2010 08:45 PM, Evgeny wrote: Hello, is there a way to reuse hyperlinks in the sphinx system? i.e - avoid copy-pasting urls from file to file? for example I would like to have external links entered like so: `some link text`_ and in some other file: .. _name_for_url: http://example.c

[sphinx-dev] how to recursively autodoc a whole project?

Hi folks, is it possible to insert complete autodoc from all contents (subpackages and all) of a package. For example I have a project that has an empty file __init__.py, a bunch of other .py files and directories that contain other __init__.py and so on. Is there a way to extract all docstrings

[sphinx-dev] how to keep most developer documentation with sphinx in source code? - are there good examples?

Hello, I'm trying to use sphinx for our project - askbot Q&A forum. Would really like to keep all developer documentation within the source code files, because I'm afraid that documentation in the external files is more likely to get out of sync with the real code. Is anyone doing this? Are there

Re: [sphinx-dev] how to keep most developer documentation with sphinx in source code? - are there good examples?

You could use the autodoc extension, this way you can use the docstrings in the documentation. If you look at Sphinx itself you will see that the developer documentation consists only of the docstrings, the only written documentation is the one you can find on http://sphinx.pocoo.org. So I guess

Re: [sphinx-dev] how to recursively autodoc a whole project?

Sphinx is intended to be used as a tool for handwritten documentation so you probably won't find a satisfying solution for this unless you switch to something like pydoc. Nevertheless there is the autosummary extension which is supposed to more or les

Re: [sphinx-dev] A way to reuse hyperlinks?

There is no good solution for it in 0.x but 1.0 has an extension called extlinks which solves this problem. Currently 1.0 is still at the beta stage so if you are not comfortable using 1.0b2 you will have to wait for the final release to use this

Re: [sphinx-dev] Namespace packages

You can solve this problem easily by inserting the directory with your package at the first position in the sys.path in the conf.py, this way it has priority over any other installed versions. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To pos

Re: [sphinx-dev] Projects using Sphinx

The qooxdoo documentation has been added to the examples with this changeset . P.S.: I'm sorry I haven't sent a reply earlier. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post