Referenznamen

In reStructuredText werden einfache Referenznamen und Phrasenreferenzen unterschieden.

Einfache Referenznamen

Einfache Referenznamen sind einzelne Wörter, die aus alphanumerischen Zeichen (Buchstaben oder Ziffern) und isolierten (nicht zwei benachbarten) Bindestrichen, Unterstrichen, Punkten, Doppelpunkten und Pluszeichen bestehen. Leerzeichen oder andere Zeichen sind nicht erlaubt. Einfache Referenznamen werden bei Zitatbeschriftungen und einigen Hyperlinks verwendet:

Want to learn about MyFavoriteProgrammingLanguage_?

.. _MyFavoriteProgrammingLanguage: http://www.python.org

oder

Want to learn about My_Favorite_Programming-Language_?

.. _My_Favorite_Programming-Language: http://www.python.org

Phrasenreferenzen

Als „Phrasenreferenzen“ werden Referenznamen bezeichnet, die Interpunktion verwenden oder deren Namen Phrasen sind (zwei oder mehr durch Leerzeichen getrennte Wörter). Phrasenreferenzen werden ausgedrückt, indem die Phrase in Backquotes eingeschlossen wird und der Text als Referenzname behandelt wird:

Want to learn about `my favorite programming language`_?

.. _my favorite programming language: http://www.python.org

Referenznamen 1:

Eigenschaften

Referenznamen sind leerzeichen-neutral und schreibungsunabhängig. Wenn die Referenznamen intern aufgelöst werden, gilt:

Leerzeichen werden normalisiert (ein oder mehrere Leerzeichen und Zeilenumbrüche werden als ein einziges Leerzeichen interpretiert)
Groß- und Kleinschreibung wird normalisiert (alle Buchstaben werden in Kleinbuchstaben umgewandelt)

Beispielsweise sind die folgenden Hyperlink-Referenzen äquivalent:

- `A HYPERLINK`_
- `a    hyperlink`_
- `A
  Hyperlink`_

.. _A HYPERLINK: https://beckhoff.de/

Durch Anklicken einer der Hyperlink-Referenzen wird die Beckhoff Homepage im Bibliotheksverwalter aufgerufen.

Referenznamen 2:

Hyperlinks, Fußnoten und Zitate haben denselben Namensraum für Referenznamen. Die Bezeichnungen von Zitaten (einfache Referenznamen) und manuell nummerierten Fußnoten (Dezimalzahlen) werden für das jeweilige Bibliotheksobjekt in dieselbe Datenbank eingetragen wie andere Hyperlink-Namen.

Das bedeutet, dass innerhalb eines Bibliotheksobjekts auf eine Fußnote (definiert als .. [1]), auf die normalerweise durch eine Fußnotenreferenz ([1]_) verwiesen wird, auch durch eine einfache Hyperlink-Referenz (1_) verwiesen werden. Achten Sie darauf, dass es nicht zu Konflikten mit Referenznamen kommt.

Siehe auch: Mehrdeutigkeit bei impliziten und expliziten Hyperlinks innerhalb eines Bibliotheksobjekts