mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
31 lines
1.1 KiB
ReStructuredText
31 lines
1.1 KiB
ReStructuredText
.. _glossary:
|
|
|
|
Glossary
|
|
========
|
|
|
|
.. glossary::
|
|
|
|
builder
|
|
A class (inheriting from :class:`~sphinx.builder.Builder`) that takes
|
|
parsed documents and performs an action on them. Normally, builders
|
|
translate the documents to an output format, but it is also possible to
|
|
use the builder builders that e.g. check for broken links in the
|
|
documentation, or build coverage information.
|
|
|
|
See :ref:`builders` for an overview over Sphinx' built-in builders.
|
|
|
|
description unit
|
|
The basic building block of Sphinx documentation. Every "description
|
|
directive" (e.g. :dir:`function` or :dir:`describe`) creates such a unit;
|
|
and most units can be cross-referenced to.
|
|
|
|
documentation root
|
|
The directory which contains the documentation's :file:`conf.py` file and
|
|
is therefore seen as one Sphinx project.
|
|
|
|
environment
|
|
A structure where information about all documents under the root is saved,
|
|
and used for cross-referencing. The environment is pickled after the
|
|
parsing stage, so that successive runs only need to read and parse new and
|
|
changed documents.
|