Erstellen einer Key-Definition

Sie können eine Variable in einer Map als Key definieren und diesen Key dann in eine beliebige Anzahl von Topics innerhalb der Map einfügen.

Keys sind nützlich für die Handhabung der Konsistenz von Inhalten und für die Effizienz. Beispielsweise können Sie Keys verwenden, um Namen für Produkte oder Produktfunktionen zu definieren. Wenn sich Namen im Laufe der Zeit ändern, müssen Sie nicht alle Topics bearbeiten, in denen das Produkt oder die Funktion erwähnt wird. Sie müssen nur den Key in der Map bearbeiten, der den Namen des Produkts oder der Funktion definiert. Weiterhin gilt, wenn Sie zwei Maps haben, bei denen derselbe Key einen Namen unterschiedlich definiert, werden Topics mit diesem Key automatisch mit dem richtigen Namen des Produkts oder der Funktion für die Map aktualisiert.

Anmerkung: Sie müssen eine Map einchecken, bevor die neuen Key-Definitionen wirksam werden.

Die beiden typischsten Methoden zum Definieren und Hinzufügen von Keys zu Ihrem Inhalt sind:

  • Definieren Sie Keys in einer Map und fügen Sie sie dann den Topics in dieser Map hinzu.
  • Definieren Sie Keys in einer Submap. Von da an können Sie die Submap wiederverwenden, indem Sie sie zu anderen Maps mit Topics hinzufügen, die die von Ihnen definierten Keys benötigen.
Anmerkung: Wenn mehrere Definitionen eines Keys in einer Map vorhanden sind, hat die erste Definition Vorrang vor allen nachfolgenden Definitionen, es sei denn, Sie legen einen bestimmten Bereich für die Keys fest, der diese Vorgabe ändert.

So erstellen Sie eine Key-Definition:

  1. Klicken Sie in der Strukturansicht für Map-Editor auf Bearbeiten.
  2. Wählen Sie die Position in der Map aus, zu der Sie den Key hinzufügen möchten, und klicken Sie dann auf .
    Es wird ein Popup-Menü angezeigt.
  3. Wählen Sie aus dem Popup-Menü die Option Neues Element und anschließend die Option Gleiche Ebene oder Untergeordnete Ebene aus, je nachdem, ob Sie den Key als gleichwertigen oder untergeordneten Key des ausgewählten Elements erstellen möchten.
    Das Dialogfeld Neues Element wird geöffnet.
  4. Klicken Sie im Dialogfeld Neues Element auf das Dropdownmenü Element und wählen Sie <keydef> aus.
  5. Geben Sie in das Feld Key-Name den Namen für den Key ein.
  6. Wählen Sie für den Wert eine der folgenden Optionen aus:
    • Schlüsselwort bietet Ihnen einen Zusatz zur Keymap und verlangt von Ihnen die Eingabe eines Werts, den Sie als Referenz für diesen Key verwenden werden.
    • Objekt-Referenz unterstützt das Einfügen einer Referenz auf eine Grafik-, Topic- oder Map-Ressource, erfordert aber die Angabe des von DITA definierten Geltungsbereichs: lokal, gleichrangig oder extern.
    • Neues Topic-Referenz unterstützt die Erstellung gezielter Keys, die auf den von Ihnen festgelegten Topic-Bedingungen basieren.
    • Web-Link bietet Unterstützung für die Referenzierung von Live-Website-Links.
  7. Klicken Sie auf Einfügen.

Die Map enthält jetzt das Element <keydef> mit den von Ihnen definierten Werten.

Nach dem Einchecken der Map können Sie den von Ihnen definierten Key in ein Topic einfügen.