[SciPy-User] [SciPy-user] Using Sphinx with numpy/scipy template

[josef.pktd at gmail.com]

On Wed, Sep 29, 2010 at 7:20 AM, bfrenay <bfrenay at gmail.com> wrote:
>
> Hello,
>
> I just migrated all my code documentation to the numpy/scipy format.
> However, I have some problems with sphinx.  I have (i) installed sphinx and
> numpydoc using easyinstall, (ii) inserted the following line in conf.py
>
> extensions= ['sphinx.ext.autodoc', 'sphinx.ext.autosummary', 'numpydoc']
>
> and (iii) created a simple, dummy index.rst file reproduced here bellow
>
> .. project documentation master file
>
> .. automodule:: project.datasets
>    :members:
>
> However, I only get errors (reproduced after the message).  Does anyone have
> an idea about what is going on, please ?
>
> Thank you,
>
> Benoît
>
> $ make html
> sphinx-build -b html -d _build/doctrees   . _build/html
> Running Sphinx v1.0.4
>
> Exception occurred:
>  File
> "/usr/local/lib/python2.6/dist-packages/numpydoc-0.3.1-py2.6.egg/numpydoc/numpydoc.py",
> line 136, in get_directive
>    raise RuntimeError("No directive named '%s' found" % name)
> RuntimeError: No directive named 'function' found
> The full traceback has been saved in /tmp/sphinx-err-pCQ8Df.log, if you want
> to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> Either send bugs to the mailing list at
> <http://groups.google.com/group/sphinx-dev/>,
> or report them in the tracker at
> <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
> make: *** [html] Erreur 1
> --
> View this message in context: http://old.nabble.com/Using-Sphinx-with-numpy-scipy-template-tp29837454p29837454.html
> Sent from the Scipy-User mailing list archive at Nabble.com.

copied form an earlier thread, It should still work with an older sphinx

---------
On Mon, Jul 26, 2010 at 1:56 PM, Gael Varoquaux
<gael.varoquaux at normalesup.org> wrote:
> On Mon, Jul 26, 2010 at 01:52:06PM -0700, Matthew Brett wrote:
>> http://old.nabble.com/numpydoc-broken-by-latest-sphinx-td28896476.html
>> http://projects.scipy.org/numpy/ticket/1489
----

fix was applied in numpy, see ticket; maybe also in numpydoc

Josef
>
> _______________________________________________
> SciPy-User mailing list
> SciPy-User at scipy.org
> http://mail.scipy.org/mailman/listinfo/scipy-user
>