Eine Key-Referenz (keyref) in ein Topic einfügen

Sie können Text als Variable in ein Topic einfügen. Diese Variable wird üblicherweise als Key-Referenz oder <keyref> bezeichnet.

Vorbereitungen

Um einen Key hinzuzufügen, müssen Sie das Topic auschecken und eine Kontextmap für das Topic auswählen. Der einzufügende Key muss in der Kontextmap oder einer Submap der Kontextmap definiert sein.

Warum und wann dieser Vorgang ausgeführt wird

Eine Möglichkeit, einen Key zu nutzen, besteht darin, einen Verweis auf den Key in ein Topic einzufügen.

So fügen Sie einen Key in ein Topic ein:

Prozedur

  1. Wählen Sie im Topic-Editor die Position im Topic aus, an der Sie den Key einfügen möchten.
  2. Klicken Sie auf der Symbolleiste auf Links und als Keys definierte Variablen einfügen.
    Das Dialogfeld DITA-Key einfügen wird geöffnet.
  3. Um die Liste einzuschränken, wählen Sie den Typ des einzufügenden Keys aus.
    • Alle
    • Web-Link für Key-Definitionen, die auf URLs verweisen
    • Schlüsselwort für Key-Definitionen, die auf Wörter oder Ausdrücke verweisen
    • Objekt für Key-Definitionen, die auf andere DITA-Objekte verweisen
  4. Wählen Sie im Feld Key den einzufügenden Key aus.

    Der Name des Keys wird in eckigen Klammern angezeigt, gefolgt vom Key-Wert.

  5. Wählen Sie im Feld Element ein Element aus der Dropdownliste der möglichen gültigen Elemente für die aktuelle Cursorposition aus.
  6. Klicken Sie auf Einfügen.

Ergebnisse

Der Key wird mithilfe des ausgewählten Elements, das durch einen schattierten Hintergrund und ein Linksymbol gekennzeichnet ist, an der ausgewählten Stelle eingefügt.