Schlüssel
Verschiedene Materialsätze können ähnliche Informationen enthalten, die an ausgewählten Orten angepasst werden müssen. Mit Schlüsseln können Sie bei der Arbeit mit DITA Variableninformationen in einfügen.
Beispieldateien, die Sie in dieser Lektion verwenden können, finden Sie in der Datei keys.zip.
Schlüssel aktivieren
-
Laden Sie den Satz der bereitgestellten Beispieldateien hoch.
a. Laden Sie die ZIP-Datei.
b. Aktualisieren Sie die AEM-Umgebung.
c. Auswahl der zu extrahierenden Datei.
d. Klicken Sie der oberen Symbolleiste auf Archiv extrahieren“.
e. Wählen Sie im Dialogfeld den spezifischen Speicherort für zu extrahierende Dateien aus, z. B. den Ordner „Keys“.
f. Klicken Sie auf Weiter.
g. Überspringen Sie alle Konflikte, da sie für Inhalte, die noch nie hochgeladen wurden, nicht existieren werden.
h. Wählen Extrahieren oben rechts im Bildschirm aus.
-
Wenn die Extraktion abgeschlossen ist, klicken Sie auf Zum Zielordner wechseln.
Schlüssel zu referenzierten Werten auflösen
Um Schlüssel korrekt zu verwenden, müssen Benutzereinstellungen auf eine bestimmte Zuordnung als Stammzuordnung verweisen. Innerhalb dieser Zuordnung befindet sich eine Sammlung von Schlüsseln, die innerhalb einer Themengruppe gruppiert sind. Durch Öffnen der Zuordnung und der Themen werden die Schlüssel zu den Werten aufgelöst, auf die diese Zuordnung verweist.
-
Geben Sie eine Stammzuordnung an.
a. Öffnen Sie auf dem Bildschirm Schlüssel eine Karte.
b. Konfigurieren Sie die Benutzereinstellungen.
c. Klicken Sie auf das Benutzereinstellungen-Symbol in der oberen Symbolleiste.
d. Klicken Sie auf das Schlüsselsymbol, um eine Stammzuordnung anzugeben, die zum Auflösen von Schlüsseln verwendet wird.
e. Aktivieren Sie die Kontrollkästchen für jede gewünschte Assets.
f. Klicken Sie auf Auswählen.
g. Speichern der Benutzereinstellungen.
-
Navigieren Sie zur Kartenansicht.
-
Öffnet die angegebene Zuordnung.
Die Schlüssel werden aufgelöst.
Manuelles Hinzufügen eines neuen Keydef
-
Öffnen Sie eine Zuordnung mit einer angegebenen Stammzuordnung.
-
Schlüssel auswählen.
-
Fügen Sie eine neue Keydef ein.
a. Klicken Sie auf eine gültige Position in der Karte.
b. Wählen Sie das Keydef in der oberen Symbolleiste aus.
c. Geben Sie im Dialogfeld Keydef einfügen einen eindeutigen Wert für Schlüssel ein, der für die Definition, die Sie erstellen, sinnvoll ist.
d. Klicken Sie auf Einfügen.
-
Hinzufügen von Themen innerhalb der Keydef.
a. Klicken Sie auf das Element einfügen-Symbol in der oberen Symbolleiste.
b. Suchen Sie im Dialogfeld Element einfügen nach „topicMeta“ und wählen Sie es aus.
-
Fügen Sie Schlüsselwörter innerhalb des Themas hinzu.
a. Klicken Sie auf das Element einfügen-Symbol in der oberen Symbolleiste.
b. Suchen und wählen Sie im Dialogfeld Element einfügen „Keywords“ aus.
-
Fügen Sie ein Keyword innerhalb des TopicMeta hinzu.
a. Klicken Sie auf das Element einfügen-Symbol in der oberen Symbolleiste.
b. Suchen Sie im Dialogfeld Element einfügen nach „Keyword“ und wählen Sie diese aus.
-
Geben Sie den Wert für die keydef in das Keyword ein.
In der Karte sollte Ihr Keydef nun in etwa wie folgt aussehen:
Konfigurieren einer Keydef als Snippet
Snippets sind kleine Inhaltsfragmente, die in verschiedenen Themen in Ihrem Dokumentationsprojekt wiederverwendet werden können. Anstatt jede Keydef manuell zu generieren, können Sie eine einzelne Keydef als Snippet konfigurieren.
-
Ein Keydef-Element in der Zuordnung auswählen.
-
Klicken Sie im Kontextmenü auf Ausschnitt erstellen.
-
Fügen Sie im Dialogfeld Neues Snippet einen Titel und eine Beschreibung hinzu.
Möglicherweise möchten Sie auch vorhandene Schlüssel oder Schlüsselwortdefinitionen aus dem Inhalt entfernen. -
Klicken Sie auf Erstellen.
-
Wählen Sie im linken Bedienfeld die Option Snippets aus.
-
Ziehen Sie das soeben erstellte Snippet per Drag-and-Drop aus dem Snippets-Bedienfeld auf die Karte.
-
Aktualisieren Sie die Keydef nach Bedarf mithilfe der Inhaltseigenschaften.
Nach dem Speichern und Aktualisieren ist dieser Schlüsselsatz für alle Benutzenden verfügbar, die eine Zuordnung definiert haben, die dieselbe Stammzuordnung enthält.