sphinx.ext.autosectionlabel
– Allow reference sections using its title¶
Nuevo en la versión 1.4.
This extension allows you to refer sections its title. This affects to the
reference role (ref
).
For example:
A Plain Title
-------------
This is the text of the section.
It refers to the section title, see :ref:`A Plain Title`.
Internally, this extension generates the labels for each section. If same
section names are used in whole of document, any one is used for a target by
default. The autosectionlabel_prefix_document
configuration variable can be
used to make headings which appear multiple times but in different documents
unique.
Configuration¶
-
autosectionlabel_prefix_document
¶ True to prefix each section label with the name of the document it is in, followed by a colon. For example,
index:Introduction
for a section calledIntroduction
that appears in documentindex.rst
. Useful for avoiding ambiguity when the same section heading appears in different documents.