2008-03-09 16:32:24 -05:00
|
|
|
.. _extensions:
|
|
|
|
|
|
|
|
|
|
Sphinx Extensions
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
.. module:: sphinx.application
|
|
|
|
|
:synopsis: Application class and extensibility interface.
|
|
|
|
|
|
|
|
|
|
Since many projects will need special features in their documentation, Sphinx is
|
|
|
|
|
designed to be extensible on several levels.
|
|
|
|
|
|
|
|
|
|
First, you can add new :term:`builder`\s to support new output formats or
|
|
|
|
|
actions on the parsed documents. Then, it is possible to register custom
|
|
|
|
|
reStructuredText roles and directives, extending the markup. And finally, there
|
|
|
|
|
are so-called "hook points" at strategic places throughout the build process,
|
|
|
|
|
where an extension can register a hook and run specialized code.
|
|
|
|
|
|
2008-04-06 12:38:55 -05:00
|
|
|
The configuration file itself can be an extension, see the :confval:`extensions`
|
|
|
|
|
configuration value docs.
|
|
|
|
|
|
2008-03-12 16:37:22 -05:00
|
|
|
.. toctree::
|
2008-03-09 16:32:24 -05:00
|
|
|
|
2008-03-16 06:19:26 -05:00
|
|
|
ext/appapi
|
|
|
|
|
ext/builderapi
|
2008-03-09 16:32:24 -05:00
|
|
|
|
|
|
|
|
|
2008-03-12 16:37:22 -05:00
|
|
|
Builtin Sphinx extensions
|
|
|
|
|
-------------------------
|
2008-03-09 16:32:24 -05:00
|
|
|
|
2008-03-12 16:37:22 -05:00
|
|
|
These extensions are built in and can be activated by respective entries in the
|
|
|
|
|
:confval:`extensions` configuration value:
|
2008-03-09 16:32:24 -05:00
|
|
|
|
2008-03-12 16:37:22 -05:00
|
|
|
.. toctree::
|
2008-03-09 16:32:24 -05:00
|
|
|
|
2008-03-16 06:19:26 -05:00
|
|
|
ext/autodoc
|
|
|
|
|
ext/doctest
|
2008-08-04 12:31:25 -05:00
|
|
|
ext/intersphinx
|
2008-08-06 08:04:14 -05:00
|
|
|
ext/math
|
2008-03-16 06:19:26 -05:00
|
|
|
ext/refcounting
|
|
|
|
|
ext/ifconfig
|
|
|
|
|
ext/coverage
|
