Links in DITA-Dokumenten verwenden
DITA-Topics enthalten zwei unterschiedliche Arten von Links. Im Topic-Hauptteil können Sie das Element xref verwenden, um Querverweise oder Inline-Links einzufügen. Im Teil related-links des Topic können Sie Links mit dem Element link einfügen. Zugehörige Links werden auch über eine Beziehungstabelle generiert, wenn Sie eine DITA Map publizieren. Ein xref kann auf ein Topic, auf Elemente innerhalb eines Topic und auf externe Dokumente verweisen. Ein link kann nur auf Topics und externe Dokumente verweisen, jedoch nicht auf Elemente innerhalb eines Topic.
Die Quellenverwaltung enthält die Registerkarte Link/Querverweis, mit der Sie in einem Dateisystem, in einem CMS oder im Internet nach Dokumenten suchen können, die das Ziel eines Links verwendet werden sollen. Mit der Registerkarte können Sie auch ein Dokument durchsuchen, um bestimmte Elemente zu finden, auf die verwiesen werden soll. Eine unverankerte Version der Registerkarte Link/Querverweis, mit der Sie vorhandene Links bearbeiten können, steht im Dialogfenster Attribute ändern, in der Strukturansicht und in der Spaltenansicht zur Verfügung.
Wenn Sie einen Querverweis oder Link in ein DITA-Topic einfügen, ruft Arbortext Editor sowohl den Titel als auch die Kurzbeschreibung des Ziels ab, falls diese verfügbar sind, und zeigt diese Informationen in der Bearbeitungsansicht an. So können Sie feststellen, ob generierter Text für den Link ausreicht, oder ob Sie den Text für den Link manuell erstellen müssen. Dem angezeigten Linktext ist eine braune Raute vorangestellt, die einen grauen Hintergrund hat (
). Wenn für das Linkziel kein Titel verfügbar ist, wird die Meldung Kein Titel im Ziel; Linktext sollte erstellt werden als Vorschautext angezeigt.
). Wenn für das Linkziel kein Titel verfügbar ist, wird die Meldung Kein Titel im Ziel; Linktext sollte erstellt werden als Vorschautext angezeigt.Wenn Sie den Text für einen Querverweis oder Link erstellen möchten, anstatt generierten Text zu verwenden, können Sie den Vorschautext ohne weiteres löschen. Wenn Sie mit dem Mauszeiger auf den Vorschautext klicken oder den Cursor in den Vorschautext bewegen, wird der gesamte Vorschautext ausgewählt. Sie können den ausgewählten Vorschautext löschen oder direkt mit der Eingabe des Link- oder Beschreibungstexts beginnen. Außerdem können Sie mit den Optionen Erstellten Linktext verwenden und Generierten Linktext verwenden im Kontextmenü des Bearbeitungsfensters zwischen den beiden Texttypen umschalten. Sie können die Funktion "Referenzen aktualisieren" verwenden, um gelöschten Vorschautext erneut anzuzeigen oder den Vorschautext zu aktualisieren.
Vorschautext steht nur für lokale Verweise auf DITA-Dokumente zur Verfügung. Arbortext Editor versucht, Titelinformationen wie folgt abzurufen:
• Bei DITA 1.3-Dokumenten zuerst aus dem Element navtitle, dann aus dem Element title und schließlich aus dem Element searchtitle in einem DITA-Topic
• Bei DITA 2.0-Dokumenten zuerst aus den Elementen titlehint, navtitle oder dem gleichwertigen Element titlealt, dann aus dem Element title und schließlich aus dem Element searchtitle in einem DITA-Topic
Beschreibungstext wird aus dem Element shortdesc abgerufen.
Beachten Sie, dass der in der Bearbeitungsansicht angezeigte Vorschautext für den Link nicht verwendet wird, wenn Sie ein Dokument veröffentlichen. Bei der Dokumentveröffentlichung wird entweder manuell erstellter Linktext verwendet, oder der Titel und die Beschreibung werden zum Zeitpunkt der Veröffentlichung aus Linkzielen übernommen.