1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66
|
============
Overview
============
.. py:module:: sphinx_toolbox
.. extensions:: sphinx-toolbox
:import-name: sphinx_toolbox
:no-postamble:
sphinx.ext.viewcode
sphinx_tabs.tabs
sphinx-prompt
The following features are enabled by default:
* :mod:`sphinx_toolbox.assets`
* :mod:`sphinx_toolbox.changeset`
* :mod:`sphinx_toolbox.code`
* :mod:`sphinx_toolbox.collapse`
* :mod:`sphinx_toolbox.confval`
* :mod:`sphinx_toolbox.decorators`
* :mod:`sphinx_toolbox.formatting`
* :mod:`sphinx_toolbox.github`
* :mod:`sphinx_toolbox.installation`
* :mod:`sphinx_toolbox.issues`
* :mod:`sphinx_toolbox.latex`
* :mod:`sphinx_toolbox.rest_example`
* :mod:`sphinx_toolbox.shields` *
* :mod:`sphinx_toolbox.sidebar_links`
* :mod:`sphinx_toolbox.source`
* :mod:`sphinx_toolbox.wikipedia`
* :mod:`sphinx_toolbox.more_autodoc.autonamedtuple`
* :mod:`sphinx_toolbox.more_autodoc.autoprotocol`
* :mod:`sphinx_toolbox.more_autodoc.autotypeddict`
\* Indicates that the extension cannot be enabled separately from the rest of ``sphinx_toolbox``.
.. latex:clearpage::
Some features must be enabled separately:
* :mod:`sphinx_toolbox.more_autodoc`
* :mod:`sphinx_toolbox.more_autodoc.augment_defaults`
* :mod:`sphinx_toolbox.more_autodoc.generic_bases`
* :mod:`sphinx_toolbox.more_autodoc.genericalias`
* :mod:`sphinx_toolbox.more_autodoc.no_docstring`
* :mod:`sphinx_toolbox.more_autodoc.overloads`
* :mod:`sphinx_toolbox.more_autodoc.regex`
* :mod:`sphinx_toolbox.more_autodoc.sourcelink`
* :mod:`sphinx_toolbox.more_autodoc.typehints`
* :mod:`sphinx_toolbox.more_autodoc.typevars`
* :mod:`sphinx_toolbox.more_autodoc.variables`
:mod:`sphinx_toolbox.more_autodoc` can also be specified as an extension, which enables all of the above features.
* :mod:`sphinx_toolbox.more_autosummary`
Provides a patched version of :class:`sphinx.ext.autosummary.Autosummary`
to fix an issue where the module name is sometimes duplicated.
I.e. ``foo.bar.baz()`` became ``foo.bar.foo.bar.baz()``, which of course doesn't exist
and created a broken link.
|