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>-Element der Tabelle platzieren. Sie müssen das vorhandene <entry> -Element verwenden, das Sie ersetzen möchten.

2. Wählen Sie im Einfügen > Conref.

   Das Dialogfeld Conref einfügen wird 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 die Zielinhalte:

   1. Wählen Sie im Dialogfeld Conref einfügen die Option Ziel: Datei. Wählen Sie in der Dropdown-Liste Dateieinstellungen die Option Aktuell aus, um ein Referenzziel aus der aktuell geöffneten Datei auszuwählen. Alternativ dazu wählen Sie eine andere geöffnete DITA-Datei aus, die das Referenzziel enthält, oder öffnen Sie über die Schaltfläche Durchsuchen eine vorhandene DITA-Datei.

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

      Wenn einem Element keine eindeutige ID zugewiesen ist, ist das Element eine eindeutige ID zuweisen möglich.

   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 Sie Ziel: Schlüssel und klicken Sie auf Schlüsselraummanager....

   2. Wählen Sie im Dialogfeld DITA-Schlüsselraummanager den Schlüssel in der Liste der definierten Schlüssel aus und klicken Sie auf OK.

   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. Wählen Sie ein Element zum Einfügen als Conref aus und klicken Sie auf OK.

4. Klicken Sie auf Einfü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 Abschnitt Conref erstellen aus, klicken Sie jedoch nicht auf Einfügen.

2. Wählen Sie in der Dropdown-Liste Conref-Endelement das letzte Element des Bereichs aus, das in die Conref eingeschlossen werden soll.

3. Klicken Sie auf Einfü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 Sie Struktur > DITA > Referenzen aktualisieren.

   Das Dialogfeld DITA-Referenzen aktualisieren wird angezeigt.

2. Aktivieren Sie Alle Conrefs in Datei aktualisieren.

3. Klicken Sie auf „OK“.

Alle Conrefs im aktuellen Thema werden aktualisiert.