Arbeiten mit DITA-Conrefs

Conref erstellen

Um in Ihrem aktuellen Thema oder Ihrer aktuellen Map eine Conref zu einem DITA-Topic oder einer DITA Map zu erstellen, müssen Sie zunächst in den Zielthemen oder -Maps Referenzinhalte einrichten.

Danach erstellen Sie eine direkte oder indirekte Referenz auf den Ziel-DITA-Inhalt.

1. Platzieren Sie die Einfügemarke an der Position, an der die Conref in einem Thema oder einer Map eingefügt werden soll.

   Um eine Conref an einer Position im Thema einzufügen, müssen Sie die für das <conref>-Element relevante Einfügemarke platzieren:

   Ein<li>-Conref-Element (Listenelement) muss in einer<ol>- oder<ul>-Liste platziert werden.

   Ein<row>-Element einer Tabelle muss in einem<table>- oder<simpletable>-Element platziert werden.

   Im Falle eines<entry>-Elements einer Tabelle können Sie die Einfügemarke nicht im<row>. Sie müssen das vorhandene<entry>-Element verwenden, das Sie ersetzen möchten.

2. Wählen Sie imEinfügen > Conref.

   Über dieConref einfügenwird angezeigt.

3. Sie haben die Option, eine Verknüpfung als einen direkten oder indirekten Verweis auf die Zielinhalte hinzuzufügen.

   Erstellen einer direkten Referenz auf den Zielinhalt:

   1. Wählen Sie im DialogfeldConref einfügen" die OptionZiel: Datei. Im FensterDateieinstellungenDropdown-Liste wählen SieAktuell, um ein Referenzziel aus der aktuell geöffneten Datei auszuwählen. Alternativ können Sie eine andere geöffnete DITA-Datei auswählen, die das Referenzziel enthält, oder eine vorhandene DITA-Datei mit der Erweiterung "Durchsuchen....

   2. In der Elementliste werden die Elemente angezeigt, denen eindeutige Bezeichner (ID) zugewiesen sind.

      Wenn einem Element keine eindeutige ID zugewiesen ist, können SieElement eine eindeutige ID zuweisen.

   3. Wählen Sie ein Element zum Einfügen als Conref im aktuellen Thema aus.

      In der Liste werden auch die ID und die Inhalte (bei Textelementen) der Elemente angezeigt.

   Wenn Sie Änderungen an einem<conref>-Element im Quellthema vornehmen, müssen Sie das Quellthema speichern und das Container-Thema aktualisieren, um die Aktualisierungen sehen zu können.

   Erstellen einer indirekten Referenz zum Zielinhalt:

   1. Wählen SieZiel: Tasteund klicken Sie aufSchlüsselraummanager....

   2. Wählen Sie im DialogfeldDITA-Schlüsselraummanagerden Schlüssel in der Liste der definierten Schlüssel aus und klicken Sie aufOK.

   3. Wählen Sie ein Element aus.

      Die Elemente im DITA-Topic des ausgewählten Elements, denen eine ID zugewiesen ist, werden in der Elementliste angezeigt.

   4. Auswählen eines Elements zum Einfügen als Conref und Klicken aufOK.

4. KlickenEinfügen.

Conref zu einem Bereich von Elementen erstellen

Sie können eine Conref zu einem Bereich von Elementen erstellen. Ein Beispiel: Sie verfügen über eine Reihe von<p>-Elementen (Absatz), auf die Sie verweisen möchten. Sie können eine Conref zu allen<p>-Elementen erstellen.

1. Führen Sie zum Auswählen des ersten Elements im Bereich die Schritte im AbschnittConref erstellenklicken Sie jedoch nicht aufEinfügen.

2. Wählen Sie im DialogfeldConref-Endelementdas letzte Element in dem Bereich aus, das in die Conref eingeschlossen werden soll.

3. KlickenEinfügen.

Conrefs aktualisieren

Wenn Sie ein wiederverwendbares Element aktualisieren, nachdem Sie es in einem anderen Thema referenziert haben, müssen Sie die Conrefs im Thema aktualisieren, um die Aktualisierungen sehen zu können.

Aktualisieren der Conrefs in einem Thema:

1. Wählen SieStrukturansicht > DITA > Referenzen aktualisieren.

   Über dieDITA-Referenzen aktualisierenwird angezeigt.

2. PrüfenAlle Conrefs in Datei aktualisieren.

3. KlickenOK.

Alle Conrefs im aktuellen Thema werden aktualisiert.