DITA-Referenzen aktualisieren
Mit Arbortext Editor können Sie alle Referenzen in einem DITA-Dokument aktualisieren. Beim Aktualisieren der Verweise werden folgende Aktualisierungen vorgenommen:
• Attribute in DITA-Elementen, die auf andere Dokumente verweisen, werden geprüft und aktualisiert, um sicherzustellen, dass die Verweise auf dem aktuellen Stand sind.
Dies betrifft die Attribute href, type, format, scope und navtitle. Mit diesem Feature werden keine keyref- oder conkeyref-Attribute aktualisiert. Das Attribut navtitle ist bei DITA 2.0-Dokumenten nicht anwendbar.
• Absolute Dateipfade werden in relative Dateipfade geändert (falls möglich); Grundlage hierfür sind die aktuelle Basis-URI, das DITA-Dokumentverzeichnis und Ordner im DITA Reference-Pfad- und Grafikpfad.
• Der Vorschautext des Links wird aktualisiert.
Sie können Referenzen für ein DITA-Topic oder eine DITA Map über die Menüoption > aktualisieren. Sie können auch einen Teil eines DITA-Topic oder einer DITA Map auswählen und die Referenzen nur für diesen Teil der Map aktualisieren. Wählen Sie hierzu die Befehlsfolge > . Sie können die Referenz nur für ein einzelnes Element in einem DITA-Topic oder in einer DITA Map aktualisieren, indem Sie mit der rechten Maustaste auf das Element klicken und im Kontextmenü des Bearbeitungsfensters die Option Referenz aktualisieren auswählen.
Bei einem DITA-Topic erfolgt die Aktualisierung der Referenzen nur für das Topic. Bei einer DITA Map erfolgt die Aktualisierung der Referenzen nicht nur für die Map, sondern auch für andere DITA Maps oder -Topics, auf die von der Map verwiesen wird. Das Aktualisieren der Referenzen gilt auch für DITA-Inhalte, auf die DITA Maps verweisen, auf die die ursprüngliche Map verweist.
Wenn die Aktualisierung der Referenzen beginnt, wird die Meldung Referenzen werden aktualisiert: Dokument wird geprüft, n Elemente geprüft im Nachrichtenbereich unten im Arbortext Editor Fenster angezeigt. Die Meldung wird laufend aktualisiert, um den Status der Aktualisierung der Referenzen anzuzeigen. Wenn die Aktualisierung abgeschlossen ist, wird entweder die Meldung Aktualisierung von Dokument abgeschlossen: Keine Änderungen und n Dokumente mit n Elementen oder die Meldung Aktualisierung von Dokument abgeschlossen: n Änderungen und n Dokumente mit n Elementen angezeigt. In letzterem Fall wird das Fenster Referenzmeldungen aktualisieren angezeigt, in dem die vorgenommenen Änderungen sowie alle Warnungen oder Fehler aufgeführt werden, die während des Vorgangs erkannt wurden. Jeder Meldung folgt ein LINK. Wenn Sie auf den LINK doppelklicken, wird der Cursor an die Stelle im zugeordneten Dokument verschoben, für die die Meldung generiert wurde. Wenn die Meldung sich auf ein Dokument bezieht, auf das eine DITA Map verweist, wird dieses Dokument in einem neuen Arbortext Editor Fenster geöffnet.
Das Fenster Referenzmeldungen aktualisieren enthält zwei Menüs und ein Kontextmenü.
Das Menü Datei enthält die folgenden Optionen:
• Speichern – Speichert den Inhalt des Nachrichtenfensters in einer .xml-Datei. Wenn dies die erste Speicherung seit dem Öffnen des Fensters ist, werden Sie zur Auswahl eines Namens für die Ausgabedatei aufgefordert.
• Speichern als – Speichert den Inhalt in einer Ausgabe mit einem anderen Namen.
• Speichern als HTML – Speichert den Inhalt in einer .htm-Datei.
• Drucken – Druckt eine veröffentlichte Version des Meldungsfensters. Der Ausdruck enthält die Informationen, die derzeit im Menü Ansicht angezeigt werden.
• Vorherige löschen – Löscht den gesamten Inhalt des Meldungsfensters bis auf die Inhalte der letzten Aktualisierung von Referenzen.
• Alles löschen – Löscht den gesamten Inhalt des Meldungsfensters.
• Schließen – Schließt das Meldungsfenster.
Das Menü Ansicht enthält die folgenden Optionen:
• Codekontext – Bei Aktivierung werden Informationen zum Kontext des Codes in der Umgebung des Fehlers, z.B. ein Java Stack Trace, im Meldungsfenster angezeigt.
• Zeitstempel – Bei Aktivierung werden im Meldungsfenster Informationen zum Zeitstempel angezeigt.
• Meldungs-IDs – Bei Aktivierung werden den Meldungseinträgen zugeordnete Meldungs-IDs angezeigt, falls vorhanden. Ein Beispiel für eine Meldungs-ID ist A123456.
• Anzeige – Legt den Inhaltstyp fest, der im Meldungsfenster angezeigt wird:
◦ Meldungen – Zeigt alle Informationen an (Meldungen, Warnungen und Fehler).
◦ Warnungen – Zeigt nur Warnungen und Fehler an. Dies ist die Standardeinstellung.
◦ Fehler – Zeigt nur Fehler an.
• Schriftgröße – Es stehen zwei Optionen zum Ändern der Schriftgröße im Meldungsfenster zur Verfügung:
◦ Vergrößern – Vergrößert die Schrift in der Anzeige.
◦ Verkleinern – Verkleinert die Schriftgröße in der Anzeige.
Das Kontextmenü wird angezeigt, wenn Sie im Meldungsfenster mit der rechten Maustaste klicken. Es enthält die folgenden Optionen:
• Kopieren – Kopiert den markierten Bereich in die Zwischenablage. Diese Option ist nur verfügbar, wenn Sie auf einen markierten Bereich klicken.
• Link folgen – Wenn Sie im Meldungsfenster mit der rechten Maustaste auf einen LINK klicken und diese Option auswählen, wird das verknüpfte Dokument angezeigt. Der Cursor befindet sich an der entsprechenden Position des Quelldokuments. Diese Option hat keine Auswirkungen, wenn das Meldungsfenster keine Links enthält.
• Unterdrücken – Blendet die aktuelle Meldung aus. Wählen Sie zum Anzeigen unterdrückter Meldungen > > .
• Ein-/Ausblenden – Blendet den aktuellen Eintrag ein oder aus.