External hyperlinks
External hyperlinks make it possible to link from the comment or from the function block documentation to an external website or to open an email program.
Hyperlink reference
Description | The hyperlink reference consists of a reference name followed by an underscore:
Phrase references must be specified in back quotes:
(See also: Reference names) |
Start and end characters |
(See also: Inline markup) |
Hyperlink target
Description | The hyperlink target consists of an explicit markup start (".. "), an underscore, the reference name, a colon, spaces and a link block:
A phrase reference in the hyperlink target can optionally be included in back quotes:
(See also: Explicit markup blocks, Reference names) |
Principle |
|
Properties |
If the URI of an external hyperlink target contains an underscore as the last character, this must be escaped so as not to be confused with an indirect reference target (see Escaping mechanism). |
Sample
By clicking on the hyperlink reference, the website is called up directly in the Library Manager or a corresponding email program is opened.
(In sample project: 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
*)
It is also possible to include URIs directly in references.
(*
External hyperlinks, like `Beckhoff <http://www.beckhoff.de/>`_.
*)
See also: Embedded URIs and aliases