Indirect hyperlinks
For indirect hyperlinks, the hyperlink target itself contains a hyperlink reference. Indirect hyperlinks thus enable the linking of explicit hyperlink targets.
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 |
For example, the following indirect hyperlink targets are equivalent:
If the reference name contains colons:
|
Samples
(In sample project: B_DocuElements\Hyperlinks\FB_Libdoc_IndirectHyperlinks)
Indirect references to an internal reference target
In the following sample, the hyperlink target .. _one
indirectly refers to target .. _two
and the target .. _two
indirectly refers to target .. _three
, an internal reference target. Actually, all three objectives refer to the same target (the same paragraph):
(*
This hyperlink points to target one_ and indirect to target three.
.. _one: two_
.. _two: three_
.. _three:
The hyperlink targets above point to this paragraph.
*)
Indirect references to an internal reference target
In the following sample, the target .. _Beckhoff
indirectly refers to the target .. _Beckhoff Information System
, an external reference target.
(*
The `Beckhoff Information System`_ is a reference source for Beckhoff_ products
.. _Beckhoff: `Beckhoff Information System`_
.. _Beckhoff Information System: https://infosys.beckhoff.de/
*)
It is also possible to insert an alias directly into the hyperlink target (see Embedded URIs and aliases).