Interne Hyperlinks

Interne Hyperlinks ermöglichen es, innerhalb eines Kommentars eine Stelle mit einer anderen zu verbinden. Das Hyperlink-Ziel zeigt dabei immer auf das ihm nachfolgende Textkörperelement.

Hyperlink-Referenz

Beschreibung

Die Hyperlink-Referenz besteht aus einem Referenznamen gefolgt von einem Unterstrich:

reference-name_

Phrasenreferenzen müssen in Backquotes angegeben werden:

`reference name`_

(Siehe auch: Referenznamen)

Start- und Endzeichen

  • Kein Startzeichen, Endzeichen = „_“
  • Startzeichen = „`“, Endzeichen = „`_“ (Phrasenreferenzen)

(Siehe auch: Inline-Markup)

Hyperlink-Ziel

Beschreibung

Das Hyperlink-Ziel besteht aus einem expliziten Markup-Start („.. “), einem Unterstrich, dem Referenznamen und einem Doppelpunkt:

.. _reference-name:

Eine Phrasenreferenz im Hyperlink-Ziel kann optional in Backquotes eingeschlossen werden:

.. _`reference name`:
.. _reference name:

(Siehe auch: Explizite Markup-Blöcke, Referenznamen)

Prinzip

+-----+---------------+
|".. "|"_"name":"     |
+-----+               |
      |               |
      +---------------+

Eigenschaften

  • Interne Hyperlink-Ziele haben einen leeren Linkblock.
  • Zwischen dem expliziten Markup-Block und dem nachfolgenden Textkörperelement ist eine Leerzeile notwendig. Leerzeilen zwischen expliziten Markup-Blöcken sind optional.

Beispiel

(Im Beispielprojekt: B_DocuElements\Hyperlinks\FB_Libdoc_InternalHyperlinks)

Einfaches internes Hyperlink-Ziel

Durch Anklicken der Hyperlink-Referenz target_ wird das Textkörperelement unterhalb von .. _target: angezeigt.

(*
Clicking on this internal hyperlink will take us to the target_
below.

.. _target:

The hyperlink targets above point to this paragraph.
*)

Interne Hyperlinks 1:

Verschachtelung von internen Hyperlink-Zielen

Der Hyperlink funktioniert auch, wenn das interne Hyperlink-Ziel in einem eingerückten Textblock „verschachtelt“ ist. So können zum Beispiel Hyperlink-Ziele auf einzelne Listenelemente gesetzt werden (mit Ausnahme des ersten, da ein vorhergehendes internes Hyperlink-Ziel für die gesamte Liste gilt):

(*
Clicking on this internal hyperlink will take us to the `third item`_ of the bullet list.

* First list item
* Second list item

  .. _third item:

* Third list item, with hyperlink target.
*)

Interne Hyperlinks 2:

Verkettung von internen Hyperlink-Zielen

Interne Hyperlink-Ziele können „verkettet“ werden. Mehrere benachbarte interne Hyperlink-Ziele zeigen dann auf dasselbe Element:

(*
Clicking on this internal hyperlink will take us to target1_
and clicking on this internal hyperlink will take us to target2_.
Both targets point the the same paragraph.

.. _target1:
.. _target2:

The targets "target1" and "target2" are synonyms; they both
point to this paragraph.
*)

Interne Hyperlinks 3:

Interne Hyperlink-Ziele können auch in den laufenden Text eingefügt werden (siehe: Inline-Hyperlinks).