skip to navigation
skip to content

numpydoc 0.5

Sphinx extension to support docstrings in Numpy format

Latest Version: 0.7.0

numpydoc – Numpy’s Sphinx extensions

Numpy’s documentation uses several custom extensions to Sphinx. These are shipped in this numpydoc package, in case you want to make use of them in third-party projects.

The following extensions are available:

  • numpydoc: support for the Numpy docstring format in Sphinx, and add the code description directives np:function, np-c:function, etc. that support the Numpy docstring syntax.
  • numpydoc.traitsdoc: For gathering documentation about Traits attributes.
  • numpydoc.plot_directive: Adaptation of Matplotlib’s plot:: directive. Note that this implementation may still undergo severe changes or eventually be deprecated.

See A Guide to NumPy/SciPy Documentation for how to write docs that use this extension.


Numpydoc inserts a hook into Sphinx’s autodoc that converts docstrings following the Numpy/Scipy format to a form palatable to Sphinx.


The following options can be set in

  • numpydoc_use_plots: bool

    Whether to produce plot:: directives for Examples sections that contain import matplotlib.

  • numpydoc_show_class_members: bool

    Whether to show all members of a class in the Methods and Attributes sections automatically.

  • numpydoc_class_members_toctree: bool

    Whether to create a Sphinx table of contents for the lists of class methods and attributes. If a table of contents is made, Sphinx expects each entry to have a separate page.

  • numpydoc_edit_link: bool (DEPRECATED – edit your HTML template instead)

    Whether to insert an edit link after docstrings.

File Type Py Version Uploaded on Size
numpydoc-0.5.tar.gz (md5, pgp) Source 2014-06-08 31KB