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 wird eine braune Raute vorangestellt, und der Linktext ist grau unterlegt (
). 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 zuerst aus dem Element navtitle, danach aus dem Element title und schließlich aus dem Element searchtitle in einem DITA-Topic abzurufen. 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.