Insérer une référence clé (keyref) dans une rubrique

Vous pouvez insérer du texte comme variable dans une rubrique. Cette variable est mieux connue sous le nom référence clé ou <keyref>.

Avant de commencer

Pour ajouter une clé, vous devez verrouiller la rubrique et sélectionner une carte contextuelle pour la rubrique. La clé que vous souhaitez insérer doit être définie dans la carte contextuelle ou une sous-carte de la carte contextuelle.

Pourquoi et quand exécuter cette tâche

Une manière d’exploiter une clé consiste à insérer une référence à la clé dans une rubrique.

Pour insérer une clé dans une rubrique :

Procédure

  1. Dans l'Éditeur de rubrique, sélectionnez dans la rubrique l'emplacement où vous souhaitez ajouter la clé.
  2. Dans la barre d'outils, cliquez sur Insérer liens et variables définies comme clés.
    La boîte de dialogue Insérer une clé DITA s'ouvre.
  3. Pour réduire la liste, sélectionnez le type de clé que vous souhaitez insérer.
    • Tout
    • Lien web pour les définitions de clé faisant référence aux URL
    • Mot clé pour les définitions de clé faisant référence aux mots ou phrases
    • Objet pour les définitions de clé faisant référence à d’autres objets DITA
  4. Dans le champ Clé, sélectionnez la clé que vous souhaitez insérer.

    Le nom de la clé apparaît entre crochets, suivi de la valeur de la clé.

  5. Dans le champ Élément, sélectionnez un élément dans la liste déroulante des éléments valides possibles à l’emplacement actuel du curseur.
  6. Cliquez sur Insérer.

Résultats

La clé est insérée à l’emplacement de votre choix avec l’élément sélectionné, marqué comme tel par un fond ombré et une icône de lien que vous pouvez sélectionner.