Eingebettete URIs und Aliases
Eigenschaften
- Dem eingeklammerten URI muss ein Leerzeichen vorangestellt werden.
- Der eingeklammerte URI muss der letzte Text vor dem Ende der Zeichenkette sein.
- Mit einem einzigen abschließenden Unterstrich wird die Hyperlink-Referenz „benannt“ und der gleiche Ziel-URI kann erneut referenziert werden.
- Bei zwei nachgestellten Unterstrichen sind Hyperlink-Referenz und Hyperlink-Ziel anonym und das Ziel kann nicht erneut referenziert werden. Dies sind „einmalige“ Hyperlinks.
Zum Beispiel:
See the `Beckhoff Online Information System <http://infosys.beckhoff.de/>`__ or the `Beckhoff home page <http://beckhoff.de/>`__.
Dies entspricht:
See the `Beckhoff Online Information System`__ or the `Beckhoff home page`__.
__ http://infosys.beckhoff.de/
__ http://beckhoff.de/
|
Der Referenztext kann auch weggelassen werden, in diesem Fall wird der URI zur Verwendung als Referenztext dupliziert:
See the `<http://infosys.beckhoff.de/>`__ or the `<http://beckhoff.de/>`__.
|
 | Das eingebettete URI-Konstrukt bietet eine einfache Erstellung und Pflege von Hyperlinks auf Kosten der allgemeinen Lesbarkeit. Inline-URIs, besonders lange, unterbrechen zwangsläufig den natürlichen Textfluss. |
Beispiel
(Im Beispielprojekt: B_DocuElements\Hyperlinks\FB_Libdoc_ExternalHyperlinks)
Eine Hyperlink-Referenz kann direkt einen Ziel-URI in spitzen Klammern („<...>“) einbetten.
See the `Beckhoff home page <http://www.beckhoff.de>`_ for info.
This `link <Beckhoff home page_>`_ is an alias to the link above.
Dies entspricht:
See the `Beckhoff home page`_ for info.
This link_ is an alias to the link above.
.. _Beckhoff home page: http://www.beckhoff.de
.. _link: `Beckhoff home page`_
|
