2013-06-19 01:07:47 -05:00
: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
2013-10-04 03:12:20 -05:00
`explicit-target`_ point to duplicated id like ``id1``.
2013-06-19 01:07:47 -05:00
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.
2013-09-23 05:53:22 -05:00
.. This case, a duplicated target id is generated by docutils.
2013-06-19 01:07:47 -05:00
.. There is no way to link to this section's duplicated id like ``id2`` by
.. using formal reStructuredText markup.
2013-09-23 05:53:22 -05:00
.. _bridge label: `label bridged target section`_
2013-10-02 21:53:53 -05:00
.. _bridge label2: `section and label`_
2013-09-23 05:53:22 -05:00
label bridged target section
=============================
.. This section is targeted through label definition.
2013-10-04 03:12:20 -05:00
`bridge label`_ is not translatable but linked to translated section title.
2013-09-23 05:53:22 -05:00
2013-10-02 21:53:53 -05:00
`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.