Anonyme Hyperlinks

Bezeichnungen von Hyperlinks sollten im Allgemeinen möglichst ausführlich und sprechend sein. Das Duplizieren eines langen Referenznamens im Hyperlink-Ziel kann jedoch aufwändig und fehleranfällig sein.

Bei anonymen Hyperlinks enthält das Hyperlink-Ziel keinen Referenznamen, d. h. der Name der Hyperlink-Referenz wird nicht verwendet, um die Referenz mit ihrem Ziel abzugleichen. Stattdessen ist die Reihenfolge der anonymen Hyperlink-Ziele innerhalb des Kommentars signifikant: Die erste anonyme Hyperlink-Referenz wird auf das erste anonyme Hyperlink-Ziel verlinkt usw. Die Anzahl der anonymen Hyperlink-Referenzen im Kommentar muss dabei mit der Anzahl der anonymen Hyperlink-Ziele übereinstimmen.

Anonyme Hyperlinks können zu missverständlichen und unlesbaren Kommentaren führen. Aus Gründen der Lesbarkeit wird empfohlen, die Hyperlink-Ziele möglichst nahe an den Hyperlink-Referenzen zu platzieren.

Anonyme Hyperlinks 1:

Beachten Sie beim Bearbeiten von Kommentaren mit anonymen Hyperlinks, dass insbesondere beim Hinzufügen, Entfernen und Neuanordnen von Hyperlink-Referenzen auch die Reihenfolge der entsprechenden Hyperlinke-Ziele angepasst werden muss.

Hyperlink-Referenz

Beschreibung

Die Hyperlink-Referenz besteht aus dem Referenznamen gefolgt von zwei Unterstrichen:

anonymous-hyperlink-reference-name__.

Phrasenreferenzen müssen in Backquotes angegeben werden.

`anonymous hyperlink reference name`__.

Start- und Endzeichen

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

(Siehe auch: Inline-Markup)

Hyperlink-Ziel

Beschreibung

Das Hyperlink-Ziel besteht aus einem expliziten Markup-Start („.. “), zwei Unterstrichen, einem Doppelpunkt, Leerzeichen und einem Linkblock. Es gibt keinen Referenznamen.

.. __: anonymous-hyperlink-target-link-block

Alternativ können anonyme Hyperlink aus zwei Unterstrichen, einem Leerzeichen und einem Linkblock bestehen:

__ anonymous-hyperlink-target-link-block

(Siehe auch: Explizite Markup-Blöcke)

Prinzip

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

Beispiel

Im folgenden Beispiel verweist die erste anonyme Hyperlink-Referenz auf das Beckhoff Online-Informationssystem und die zweite anonyme Hyperlink-Referenz auf die Beckhoff Homepage. Wenn die Reihenfolge der anonymen Hyperlink-Ziele verändert wird, verändert sich auch die Zuweisung der Verweise.
(Im Beispielprojekt: B_DocuElements\Hyperlinks\FB_Libdoc_AnonymousHyperlinks)

(*
See the `Beckhoff Online Information System`__ or the `Beckhoff home page`__.

.. __: http://infosys.beckhoff.de/

.. __: http://beckhoff.de/
*)

Anonyme Hyperlinks 2: