blob: ac000849babfabc1c4e961736204591b85143d26 (
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
: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.
|
