Manuelle Erstellung eines Gabelungslinks

[en] This article is designed to help you when all of the following apply:

[en] You have reused the same topic several times in the same publication
[en] You want to add a cross-reference to a specific element in the reused topic
[en] You want the cross-reference to target a specific instance of the topic, rather than the first instance.

Anmerkung

[en] Each time a topic appears in a publication, we call it an "instance" of that topic. For each instance, the publication has a separate reference, called a fork.

[en] For example, let's say you have reused a "Reset system" four times in the same publication. You want to add a cross-reference to a para element in the "Reset system" topic, but you specifically want to target the fourth instance of the topic and not the other three. For that, you need to add a cross-reference to a specific element (para) for a specific fork (fourth topic instance).

XML tree view of the reset system topic. A callout points to a specific para element.

[en] Cross-reference is going to target a specific element ...

A publication structure. It has several chapters. 4 of the chapters contain the same reused topic, called Reset system. Callouts point to all 4 of the reused topics, but there is a red cross next to the first three. The fourth reused topic has a green and white check mark.

[en] ... in a specific instance of a topic in the publication.

[en] The following steps explain how to set up a cross-reference to an element in a specific instance of a topic:

[en] The element that you are going to cross-reference needs to have an xml:id attribute, otherwise you will be unable to reference it.

[en] To check if the target element has an xml:id:
1. [en] Open the topic that contains the target element.
2. [en] Click inside the target element.
3. [en] Look in the Element attributes side panel. If the element has an xml:id, it will be listed there.
[en] To learn how to create an xml:id for an element, see IDs für Querverweise manuell generieren.
Öffnen Sie das Topic, in dem sich der Querverweis befindet.
[en] Position the cursor where you want the cross-reference to appear.
[en] Select the Insert tab.
Wählen Sie Link und danach in der Symbolleiste Querverweis.
Geben Sie eine Linkbezeichnung ein. (Das ist optional).
Navigieren Sie zur Publikation.

Anmerkung

Der Querverweis-Dialog zeigt die Ziele sowohl als Teil der Publikation als auch als Topic (außerhalb des Publikationsbaums) an. Es ist wichtig, das Ziel innerhalb des Publikationsbaum auszuwählen, um den Gabelungs-Linkzu erhalten!

Erfahren Sie mehr über den Unterschied zwischen Topics und Gabelungen unter Topic oder Gabelung.
[en] Open the publication branch and navigate to instance of the topic that has the target element. For example, to link to the fourth instance of a topic, navigate to the fourth instance inside the publication structure.
Um verlinkbare Elemente anzuzeigen, klicken Sie auf den Pfeil vor dem Topic.
Wählen Sie das Element aus, damit es im Topic als Link angezeigt wird. Dieser führt direkt zum ursprünglichen Element.
[en] Select the link in the topic and look in the Element attributes panel. You should see that the link has an xlink:href attribute.

[en] The value for the attribute should have this structure:

[en] urn:resource:fork:<fork id number>/<element>-idm<element id number>

[en] For example:

[en] urn:resource:fork:1665535/para-idm243468712643086

[en] If your link does not use this structure or has no link at all, repeat this procedure and make sure you:
- [en] Navigate to the topic instance inside the publication and not directly to the topic itself
- [en] Link to the element in the appropriate instance of the topic.
Drücken Sie Speichern.