DITA-Inhaltsreferenzen (conrefs)



Ein DITA <conref>-Attribut fügt eine Inhaltsreferenz als Texteinschub ein und formatiert sie mit <DITA-Conref>-Tags als bedingten Text.

Das <conref>-Attribut wird als Verweis zu einer ID verwendet, sodass ein Topic oder ein Topic-Element mit einer eindeutigen ID wiederverwendet werden kann. Sie können beispielsweise eine Reihe von Topics in einem verbundenen (DITA) oder verschachtelten Kontext für Authoring-Zwecke erstellen und jedes Topic einzeln an einer neuen Position referenzieren. Bei der Ausgabe werden die Inhalte des ersten Topic durch das Topic mit dem <conref>-Attribut aufgerufen.

Grafik in Originalgröße anzeigen
DITA conref-Manager

Sie können eine <conref> auch zu einer Fußnote oder einer indexterm-Marke hinzufügen. Alle referenzierten Elemente werden als Einschübe in einem FrameMaker-Dokument angezeigt. Sie können den Einschübe-Pod zum Bearbeiten der DITA-Inhaltsreferenzen verwenden.

    Erstellen einer Inhaltsreferenz für ein DITA-Topic

    1. Öffnen Sie eine DITA-Topic-Datei.

    2. Reduzieren Sie das <body>-Element und platzieren Sie den Einfügepunkt darunter.

    3. Wählen Sie „DITA“ > „Conref einfügen“. Das Fenster „DITA Conref“ wird angezeigt.

    4. Wählen Sie in der Liste „Quelldatei“ die Datei aus, von der aus Sie das Topic referenzieren möchten.

      Hinweis: Die Liste „Quelldatei“ zeigt nur geöffnete Dateien an. Verwenden Sie die Schaltfläche „Durchsuchen“, um eine noch nicht geöffnete Datei zu öffnen.

    5. Wählen Sie im Bereich „Element-Tag“ einen Tag. Die Liste „Elementdaten“ enthält die Elemente aus der Quelldatei, die dem gewählten Element-Tag entsprechen.

    6. Wählen Sie in der Liste „Elementdaten“ das gewünschte Element und klicken Sie auf „Einfügen“. Der Inhalt des gewählten Elements wird in die geöffnete Datei eingefügt.

      Standardmäßig wird der Text eines Elements, das über eine Referenz eingefügt wurde, blau angezeigt. Sie können die Farbe jedoch mithilfe des Gestaltungsfensters für strukturierte Vorlagen ändern.

    Es werden Fehlermeldungen erzeugt, wenn Sie eine Datei öffnen, die ein <conref>-Element oder ein <xref>-Element enthält, das nicht zugeordnet werden kann. Fehlermeldungen werden auch angezeigt, wenn die Datei eine Datei mit nicht zuordbaren Referenzen referenziert. Wenn diese Meldungen nicht angezeigt werden sollen, wählen Sie „DITA“ > „DITA-Optionen“ und deaktivieren Sie „Conrefs beim Öffnen von Datei automatisch laden“ und „Querverweise beim Öffnen von Datei automatisch laden“.

    Erstellen einer conref für ein Bild

    Sie können eine Inhaltsreferenz für ein Grafikobjekt wie z. B. ein DITA-Bildelement erstellen.

    1. Öffnen Sie die DITA-Topic-Datei, in der Sie eine Inhaltsreferenz zum Bild einfügen möchten.

    2. Platzieren Sie den Einfügepunkt an einer zulässigen Stelle in der Strukturansicht.

    3. Wählen Sie „DITA“ > „Conref einfügen“.

    4. Wählen Sie die Bildquelldatei aus der Liste „Quelldatei“.

    5. Wählen Sie im Bereich „Element-Tag“ ein Bild-Tag. Die Liste „Elementdaten“ zeigt die Bilder in der gewählten Quelldatei an. Es werden nur die gültigen Elemente in der Liste „Element-Tag“ angezeigt.

      Hinweis: Wenn das Bild, das Sie einfügen möchten, nicht in der Liste „Elementdaten“ enthalten ist oder Eintrag „KEINE ID|KEIN INHALT“ anzeigt, dann wurde dem Bildelement keine ID zugewiesen. Weisen Sie eine ID zu, speichern Sie die Quelldatei und wiederholen Sie die Schritte zum Einfügen der Inhaltsreferenz.

    6. Wählen Sie die Bild-ID aus der Liste „Elementdaten“ und klicken Sie auf „Einfügen“. Das Bild wird in die geöffnete Datei eingefügt.

    Wenn Sie das Bild in der Quelldatei ändern, klicken Sie auf „DITA“ > „Referenzen aktualisieren“, um die Änderungen in der Zieldatei zu übernehmen.

    Erstellen einer conref für eine Tabelle oder ihre Zellen

    Sie können eine <conref> für ein ganzes Tabellenelement, eine Tabellenüberschrift, den Tabellenhaupttext, eine Tabellenzeile oder eine Tabellenzelle erstellen.

    Hinweis: Bei einem simpletable-Element ist die Tabellenüberschrift ein ungültiges Element und es kann deshalb keine conref erstellt werden.

    Einfügen einer conref für eine Tabelle

    1. Öffnen Sie die DITA-Topic-Datei, in der Sie eine Inhaltsreferenz zur Tabelle einfügen möchten.

    2. Platzieren Sie den Einfügepunkt an einer zulässigen Stelle in der Strukturansicht.

    3. Wählen Sie „DITA“ > „Conref einfügen“.

    4. Wählen Sie die Tabellenquelldatei aus der Liste „Quelldatei“.

    5. Wählen Sie im Bereich „Element-Tag“ den Typ des Quelltabellenelements, z. B. <simpletable>. Die Liste „Elementdaten“ zeigt die Tabellen in der gewählten Quelldatei an.

      Hinweis: Wenn die Tabelle, die Sie einfügen möchten, nicht in der Liste „Elementdaten“ enthalten ist oder Eintrag „KEINE ID|KEIN INHALT“ anzeigt, dann wurde dem Tabellenelement keine ID zugewiesen. Weisen Sie eine ID zu, speichern Sie die Quelldatei und wiederholen Sie die Schritte zum Einfügen der Inhaltsreferenz.

    6. Wählen Sie die Tabellen-ID aus der Liste „Elementdaten“ und klicken Sie auf „Einfügen“. Die Tabelle wird in die geöffnete Datei eingefügt.

    Einfügen einer conref für eine Tabellenzeile

    1. Öffnen Sie die DITA-Topic-Datei, in der Sie eine Inhaltsreferenz zur Tabellenzeile einfügen möchten.

    2. Fügen Sie ein Tabellenelement in das Dokument ein. Vergewissern Sie sich, dass sie die gleiche Anzahl von Spalten wie die Quelltabelle hat.

    3. Wählen Sie die Tabellenzeile in die Sie eine Inhaltsreferenz einfügen möchten.

      Hinweis: Bei der Auswahl der Tabellenzeile in der Dokumentansicht werden möglicherweise nur die einzelnen Zellen anstelle des Zeilenelements ausgewählt. Überprüfen Sie in der Strukturansicht, ob Sie das gesamte Tabellenzeilenelement ausgewählt haben, z. B. <strow>.

    4. Wählen Sie „DITA“ > „Conref einfügen“.

    5. Wählen Sie in der Liste „Quelldatei“ die Datei mit der gewünschten Tabellenzeile aus. Beachten Sie, dass die Liste „Element-Tag“ nur das Tabellenzeilenelement <strow> anzeigt.

    6. Wählen Sie die Tabellenzeilen-ID aus der Liste „Elementdaten“ und klicken Sie auf „Einfügen“. Der Inhalt der Quelltabellenzellen wird in die gewählte Tabellenzeile eingefügt. Ein blauer Rahmen um die Zeile zeigt an, dass es sich um eine Inhaltsreferenz handelt.

      Hinweis: Die Quelltabellenzeile muss eine ID haben. Wenn dem Tabellenzeilenelement keine ID zugewiesen wurde, wird sie nicht in der Liste „Elementdaten“ angezeigt, auch wenn ihre Zellen einzelne IDs haben. Weisen Sie eine ID zur Tabellenzeile zu, speichern Sie die Quelldatei und wiederholen Sie die Schritte zum Einfügen der Inhaltsreferenz.

    Einfügen einer conref für eine Tabellenzelle

    1. Öffnen Sie die DITA-Topic-Datei, in der Sie eine Inhaltsreferenz zur Tabellenzelle einfügen möchten.

    2. Platzieren Sie den Einfügepunkt an einer zulässigen Stelle in der Strukturansicht und fügen Sie ein Tabellenelement ein.

    3. Wählen Sie die Tabellenzelle in die Sie eine Inhaltsreferenz einfügen möchten.

    4. Wählen Sie „DITA“ > „Conref einfügen“.

    5. Wählen Sie in der Liste „Quelldatei“ die Datei mit der gewünschten Tabellenzelle aus.

    6. Wählen Sie in der Liste „Element-Tag“ den Typ des Quelltabellenelements, z. B. <stentry>. Die Liste „Elementdaten“ zeigt die Tabellenzellen in der gewählten Quelldatei an.

      Hinweis: Die Tabellenzelle muss eine ID haben. Wenn dem Tabellenzellenelement keine ID zugewiesen wurde, wird sie nicht in der Liste „Elementdaten“ angezeigt. Weisen Sie eine ID zu, speichern Sie die Quelldatei und wiederholen Sie die Schritte zum Einfügen der Inhaltsreferenz.

    7. Wählen Sie die Tabellenzellen-ID aus der Liste „Elementdaten“ und klicken Sie auf „Einfügen“. Der Inhalt der Quelltabellenzellen wird in die gewählte Tabellenzelle eingefügt.

    Hinweis: Sie können keine Inhaltsreferenz für eine Tabellenspalte einfügen. Wenn die Spalte nicht zu viele Zellen enthält, können Sie stattdessen Inhaltsreferenzen für einzelne Spaltenzellen einfügen.