Dialogfenster Schlüsselreferenz einfügen
Dieses Dialogfenster ermöglicht Ihnen das Einfügen einer Schlüsselreferenz in ein DITA-Topic oder eine DITA Map. Sie rufen dieses Dialogfenster entweder von der Menüoption > oder der zugehörigen Schaltfläche in der Symbolleiste aus auf. Wenn Sie dies wünschen, können Sie das Dialogfenster im Arbortext Editor Fenster andocken.
Die in diesem Dialogfenster enthaltenen Schlüssel kommen aus DITA-Zuordnungen, die in den erweiterten Einstellungen für ditakeybaselist enthalten sind. Sie können auch über die Schaltfläche Hinzufügen/Entfernen der Liste für die laufende Sitzung Zuordnungen hinzufügen. Wenn Sie ein Thema aus dem Kontext einer Zuordnung öffnen, die Schlüsseldefinitionen enthält, wird diese Zuordnung zu einem Bestandteil des Schlüsselkontexts, wenn Sie dieses Dialogfenster für dieses Thema öffnen. Wenn es sich bei der Zuordnung, die Ihre Schlüsseldefinitionen enthält, um eine DITA-Schlüsseldefinitionszuordnung handelt, sind zusätzliche Informationen für diese Definitionen verfügbar.
Das Dialogfenster Schlüsselreferenz einfügenenthält folgende Optionen:
• Suchen – Ermöglicht es Ihnen, die Liste verfügbarer Schlüsseldefinitionen zu filtern.
Während Sie in diese Option schreiben, wird der Inhalt der Schlüsseldefinitionstabelle automatisch nach Elementen gefiltert, die zu dem passen, as Sie eingeben. Die Suche erstreckt sich auf den Inhalt der Spalten Schlüsselname, Titel/Beschreibung und Referenz in der Tabelle. Auch Text sowie Markup in der Spalte Ressource wird mit einbezogen.
• Groß-/Kleinschreibung beachten – Legt fest, ob bei der Suche in der Option Suchen Groß-/Kleinschreibung beachtet wird.
• Beginnt mit – Legt fest, ob bei der Suche in der Option Suchen nur nach dem Anfang des Inhalts in der durchsuchten Spalte gesucht wird.
• - Legt die Zuordnung fest, die für die Schlüsseldefinitionen in der Schlüsseldefinitionstabelle verwendet wird.
Der Standardwert Alle bedeutet, dass alle Schlüsseldefinitionen im aktuellen Schlüsselkontext verwendet werden. Wenn Sie eine spezifische Zuordnung aus der Drop-down-Liste auswählen, erscheinen nur die Schlüsseldefinitionen aus dieser Zuordnung in der Schlüsseldefinitionsliste.
Verwenden Sie dieses Dialogfenster, um Zuordnungen aus Ihrem aktuellen Schlüsselkontext hinzuzufügen oder zu entfernen. Beachten Sie, dass hierdurch nur der Schlüsselkontext aus der aktuellen Sitzung geändert wird. Um den Schlüsselkontext dauerhaft zu ändern, müssen Sie die erweiterte Einstellung für ditakeybaselist ändern.
• Schlüsseldefinitionstabelle – Listet die Schlüsseldefinitionen auf, die Sie als Referenzen in Ihr Dokument einfügen können.
Wenn es sich bei der Zuordnung, die die Schlüsseldefinitionen enthält, um eine DITA-Schlüsseldefinitionszuordnung handelt, sind für die Definitionen zusätzliche Informationen verfügbar. Wenn Schlüssel ein mehr als einmal definiert wurde, erscheint jede Definition in einer eigenen Zeile. Wenn mehrere Schlüssel in einer Schlüsseldefinition definiert sind, wird jeder Schlüssel in einer eigenen Zeile aufgeführt.
Die Tabelle enthält die folgenden Spalten:
◦ Schlüsselname – Enthält den Namen des Schlüssels.
Reguläre Schlüssel haben kein Symbol. Inhaltsreferenzschlüssel werden durch das Symbol 
angezeigt. Wenn der Schlüssel in einer DITA-Schlüsseldefinitionszuordnung festgelegt ist und das Element keysubelementid angegeben ist, wird dieser ID-Wert nach einem / angefügt.
angezeigt. Wenn der Schlüssel in einer DITA-Schlüsseldefinitionszuordnung festgelegt ist und das Element keysubelementid angegeben ist, wird dieser ID-Wert nach einem / angefügt.◦ Typ – Enthält die Liste der Elemente, die zur Referenzierung dieses Schlüssels verwendet werden können.
Wenn der Schlüssel in einer DITA-Schlüsseldefinitionszuordnung festgelegt wurde and das Element keyreftags angegeben ist, kommt die Schlüsselliste von diesem Element. Andernfalls ist der Wert Beliebig, das heißt, jedes Element mit einem Element keyref kann den Schlüssel referenzieren. Wenn der Schlüssel für eine Inhaltsschlüsselreferenz conkeyref bestimmt ist, ist der Wert der Name des Elements, das für die Inhaltsreferenz verwendet werden soll, gefolgt von (conref).
◦ Titel/Beschreibung – Enthält eine Beschreibung des Schlüssels.
Wenn der Schlüssel in einer DITA-Schlüsseldefinitionszuordnung festgelegt ist und das Element keydescription angegeben ist, wird die Beschreibung aus diesem Element übernommen. Andernfalls kommt diese Beschreibung aus dem Kontext des Elements navtitle, dem Attribut navtitle oder dem Element linktext, in dieser Reihenfolge. Bei DITA 2.0-Dokumenten stammt die Beschreibung aus dem Inhalt des Elements titlehint, navtitle oder linktitle, und zwar in dieser Reihenfolge, sofern das Element keydescription nicht angegeben ist.
◦ Ressource – Gibt entweder den Wert des Attributs href aus der Schlüsseldefinition oder beliebigen Text in der Definition einschließlich des Markups an, falls kein Wert für href in der Schlüsseldefinition angegeben ist.
Wenn in einer Schlüsseldefinition kein Wert für href angegeben ist, geht das System davon aus, dass die Definition Inhalte für das Ersetzen von Text enthält.
◦ Zuordnungsname – Enthält den Namen der Zuordnung, die die Schlüsseldefinition enthält.
In der Tabelle erscheint nur der Basisname der Zuordnung. Wenn die Schlüsseldefinition aus einer Zuordnung stammt, die von einer anderen Zuordnung referenziert wird, ist der angezeigte Name der Basisname der übergeordneten Zuordnung, gefolgt von dem Basisnamen der referenzierten Zuordnung in Klammern.
• Dropdown-Liste Einfügen – Enthält eine Liste gültiger Schlüsselreferenzelemente, die an der aktuellen Cursorposition eingefügt werden können.
Bei Schlüsselreferenzen, die nicht für Textersetzungen vorgesehen sind, wird der Inhalt dieser Liste durch den Typ des Elements bestimmt, in dem sich der Cursor befindet. Der Inhalt der Liste wird auch dadurch bestimmt, ob die Spalte Typ einen Satz zulässiger Tags enthält und welcher Wert für die erweiterte Einstellung smartinsert festgelegt wurde.
Bei Schlüsselreferenzen, die für die Textersetzung vorgesehen sind, werden die Elemente in der Liste durch den Wert der erweiterten Einstellung ditatextkeyrefs bestimmt. Standardmäßig ist diese Einstellung auf off festgelegt, was bedeutet, dass nur Linkelemente, für die eine Schlüsselreferenz zulässig ist, in der Liste angezeigt werden. Wenn Sie die Einstellung auf on festlegen, werden auch Nicht-Linkelemente, die eine Schlüsselreferenz zulassen, in der Liste angezeigt. Dies ermöglicht es Ihnen, für diese Elementarten Schlüsselreferenzen für die Textersetzung einzufügen.
• Schaltfläche Einfügen – Fügt die ausgewählte Schlüsselreferenz unter Verwendung des ausgewählten Elements in Ihr Dokument ein.
Der Wert der Attribute href, Umfang, Typ und Format sowie der Linktext aus der Schlüsseldefinition werden für die eingefügte Referenz verwendet.