Indirekte Hyperlinks

Bei indirekten Hyperlinks enthält das Hyperlink-Ziel selbst wieder eine Hyperlink-Referenz. Indirekte Hyperlinks ermöglichen so die Verlinkung von expliziten Hyperlink-Zielen.

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, einem Doppelpunkt, Leerzeichen und einem Linkblock:

.. _reference-name: link-block

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

.. _`reference name`: link-block
.. _reference name: link-block

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

Prinzip

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

Eigenschaften

  • Indirekte Hyperlink-Ziele haben eine Hyperlink-Referenz in ihrem Linkblock.
  • Wie bei externen Hyperlink-Zielen kann der Linkblock eines indirekten Hyperlink-Ziels in der gleichen Zeile wie der explizite Markup-Block beginnen oder in der nächsten Zeile.

Beispielsweise sind die folgenden indirekten Hyperlink-Ziele äquivalent:

.. _one-liner: `A HYPERLINK`_
.. _entirely-below:
   `a    hyperlink`_
.. _split: `A
   Hyperlink`_

Wenn der Referenzname Doppelpunkte enthält:

  • muss die Phrase im Linkblock des Hyperlink-Ziels in Backquotes eingeschlossen sein
`Beckhoff Support:`_

* worldwide support
* design, programming and commissioning of complex automation systems
* training program for Beckhoff system components 

.. _`Beckhoff Support:`: support@beckhoff.com
  • oder der/die Doppelpunkt(e) muss/müssen mit einem Backslash versehen werden:
`Beckhoff Support:`_

* worldwide support
* design, programming and commissioning of complex automation systems
* training program for Beckhoff system components 

.. _Beckhoff Support\:: support@beckhoff.com

Bespiele

(Im Beispielprojekt: B_DocuElements\Hyperlinks\FB_Libdoc_IndirectHyperlinks)

Indirekte Verweise auf ein internes Verweisziel

Im folgenden Beispiel verweist das Hyperlink-Ziel .. _one indirekt auf das Ziel .. _two und das Ziel .. _two verweist indirekt auf Ziel .. _three, ein internes Verweisziel. Eigentlich beziehen sich alle drei Ziele auf dasselbe (auf denselben Absatz):

(*
This hyperlink points to target one_ and indirect to target three.

.. _one: two_
.. _two: three_
.. _three:

The hyperlink targets above point to this paragraph.
*)

Indirekte Hyperlinks 1:

Indirekte Verweise auf ein externes Verweisziel

Im folgenden Beispiel verweist das Ziel .. _Beckhoff indirekt auf das Ziel .. _Beckhoff Information System, ein externes Verweisziel.

(*
The `Beckhoff Information System`_ is a reference source for Beckhoff_ products

.. _Beckhoff: `Beckhoff Information System`_

.. _Beckhoff Information System: https://infosys.beckhoff.de/
*)

Indirekte Hyperlinks 2:

Es ist auch möglich, einen Alias direkt in das Hyperlink-Ziel einzufügen (siehe Embedded URIs and Aliases).