summaryrefslogtreecommitdiffstats
path: root/doc/extdev/utils.rst
blob: 9e10a0ded8580b817502948b281d34d138c7218d (plain)
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
Utilities
=========

Sphinx provides utility classes and functions to develop extensions.


Base classes for components
---------------------------

These base classes are useful to allow your extensions to obtain Sphinx
components (e.g. :class:`.Config`, :class:`.BuildEnvironment` and so on) easily.

.. note:: The subclasses of them might not work with bare docutils because they
          are strongly coupled with Sphinx.

.. autoclass:: sphinx.transforms.SphinxTransform
   :members:

.. autoclass:: sphinx.transforms.post_transforms.SphinxPostTransform
   :members:

.. autoclass:: sphinx.util.docutils.SphinxDirective
   :members:

.. autoclass:: sphinx.util.docutils.SphinxRole
   :members:

.. autoclass:: sphinx.util.docutils.ReferenceRole
   :members:

.. autoclass:: sphinx.transforms.post_transforms.images.ImageConverter
   :members:


Utility components
------------------

.. autoclass:: sphinx.events.EventManager
   :members:


Utility functions
-----------------

.. autofunction:: sphinx.util.parsing.nested_parse_to_nodes


Utility types
-------------

.. autoclass:: sphinx.util.typing.ExtensionMetadata
   :members: