mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
68 lines
1.8 KiB
Plaintext
68 lines
1.8 KiB
Plaintext
:tocdepth: 2
|
|
|
|
.. _implicit-target:
|
|
|
|
section and label
|
|
==================
|
|
|
|
.. This section's label and section title are different.
|
|
.. This case, the section have 2 target id.
|
|
|
|
:ref:`implicit-target` point to ``implicit-target`` and
|
|
`section and label`_ point to ``section-and-label``.
|
|
|
|
|
|
.. _explicit-target:
|
|
|
|
explicit-target
|
|
================
|
|
|
|
.. This section's label equals to section title.
|
|
.. This case, a duplicated target id is generated by docutils.
|
|
|
|
:ref:`explicit-target` point to ``explicit-target`` and
|
|
`explicit-target`_ point to duplicated id like ``id1``.
|
|
|
|
|
|
implicit section name
|
|
======================
|
|
|
|
.. This section have no label.
|
|
.. This case, the section have one id.
|
|
|
|
`implicit section name`_ point to ``implicit-section-name``.
|
|
|
|
duplicated sub section
|
|
------------------------
|
|
|
|
.. This section have no label, but name will be duplicated by next section.
|
|
.. This case, the section have one id.
|
|
|
|
`duplicated sub section`_ is broken link.
|
|
|
|
.. There is no way to link to this section's ``duplicated-sub-section``` by
|
|
.. using formal reStructuredText markup.
|
|
|
|
duplicated sub section
|
|
------------------------
|
|
|
|
.. This section have no label, but the section was a duplicate name.
|
|
.. This case, a duplicated target id is generated by docutils.
|
|
|
|
.. There is no way to link to this section's duplicated id like ``id2`` by
|
|
.. using formal reStructuredText markup.
|
|
|
|
|
|
.. _bridge label: `label bridged target section`_
|
|
.. _bridge label2: `section and label`_
|
|
|
|
label bridged target section
|
|
=============================
|
|
|
|
.. This section is targeted through label definition.
|
|
|
|
`bridge label`_ is not translatable but linked to translated section title.
|
|
|
|
`bridge label2`_ point to ``section and label`` and `bridge label`_ point to ``label bridged target section``. The second appeared `bridge label2`_ point to correct target.
|
|
|