Externe Hyperlinks

Externe Hyperlinks ermöglichen es, aus dem Kommentar bzw. aus der Bausteindokumentation heraus auf eine externe Webseite zu verlinken oder ein E-Mail-Programm zu öffnen.

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

  • Externe Hyperlink-Ziele haben einen absoluten URI oder eine E-Mail-Adresse in ihrem Linkblock.
  • Der URI eines externen Hyperlinks kann entweder in derselben Zeile wie das explizite Markup beginnen oder in einem eingerückten Textblock unmittelbar danach, ohne dass Leerzeilen dazwischenkommen.
  • Wenn sich mehrere Zeilen im Linkblock befinden, werden diese verkettet. Zeilenumbrüche im Linkblock werden entfernt. Die folgenden externen Verweisziele sind somit äquivalent:
.. _one-liner: https://infosys.beckhoff.de/

.. _starts-on-this-line: http://
   infosys.beckhoff.de/

.. _entirely-below:
   https://infosys.
   beckhoff.de/

Wenn der URI eines externen Hyperlink-Ziels als letztes Zeichen einen Unterstrich enthält, muss dieses „escaped“ werden, um nicht mit einem indirekten Verweisziel verwechselt zu werden (siehe Escaping-Mechanismus).

Beispiel

Durch Anklicken der Hyperlink-Referenz wird die Webseite direkt im Bibliotheksverwalter aufgerufen bzw. ein entsprechendes E-Mail-Programm geöffnet.
(Im Beispielprojekt: B_DocuElements\Hyperlinks\FB_Libdoc_ExternalHyperlinks)

(*
See the Beckhoff_ home page for more information.

Please contact the `Beckhoff Support`_ for technical assistance.

.. _Beckhoff: http://www.beckhoff.de
.. _Beckhoff Support: support@beckhoff.com

For more information see the `PLC Lib Tc2_System`_ and `PLC Lib Tc2_Standard`_.

.. _PLC Lib Tc2_System: https://download.beckhoff.com/download/document/automation/twincat3/TwinCAT_3_PLC_Lib_Tc2_System_EN.pdf
.. _PLC Lib Tc2_Standard: https://download.beckhoff.com/download/document/automation/twincat3/TwinCAT_3_PLC_Lib__Tc2_Standard_EN.pdf
*)

Externe Hyperlinks 1:

Externe Hyperlinks 2:

Externe Hyperlinks 3:

Externe Hyperlinks 4:

Es ist auch möglich, URIs direkt in Verweisreferenz einzubinden.

(*
External hyperlinks, like `Beckhoff <http://www.beckhoff.de/>`_.
*)

Externe Hyperlinks 5:

Siehe auch: Eingebettete URIs und Aliases

Weiterführende Informationen