Boîte de dialogue Informations sur la référence de clé
Cette boîte de dialogue permet d'afficher des informations sur la définition de clé associée à une référence de clé dans une rubrique ou un plan DITA. Vous pouvez y accéder à l'aide de l'option de menu > ou de l'option correspondante proposée dans le menu de raccourcis. Cette option de menu est disponible à condition de placer le curseur dans un élément contenant une référence de clé.
Pour qu'une référence de clé puisse vous renseigner sur sa définition de clé, il faut d'une part, que cette référence de clé possède un contexte de clé actif et d'autre part, que la définition de clé associée appartienne à ce contexte. Un contexte de clé est un plan DITA contenant des définitions de clés. Si ce plan constitue un plan de définition de clés DITA, des informations supplémentaires sont disponibles pour les définitions.
La valeur attribuée à l'option ditakeycontext détermine le contexte de clé pour un document. Cette option peut être définie soit de façon explicite, soit automatiquement par Arbortext Editor dans certains cas. Si vous ouvrez, par exemple, une rubrique référencée à partir d'un plan contenant des définitions de clés, Arbortext Editor configure ce plan en tant que contexte de clé.
La boîte de dialogue Informations sur la référence de clé contient les options suivantes :
• Informations sur la définition de clé : fournit des informations au sujet de la définition de clé.
Si ce plan constitue un plan de définition de clés DITA, il est probable que des informations supplémentaires soient disponibles pour les définitions. Vous bénéficiez des informations suivantes :
◦ Clé : indique le nom de la clé.
◦ href : fournit le chemin d'accès complet au document identifié par l'attribut href dans la définition de clé.
Si aucun attribut href n'est attribué, (Aucun(e)) est affiché.
◦ Etendue : fournit l'attribut scope de la valeur à partir de la définition de clé applicable à cette référence de clé.
◦ Format : fournit l'attribut format de la valeur à partir de la définition de clé applicable à cette référence de clé.
◦ Texte : affiche le contenu texte défini par la définition de clé.
Pour les références de clé utilisées pour le remplacement de texte, cette option affiche aussi tout balisage fourni dans la définition de clé. Pour les autres références de clé, cette option affiche le texte à partir de la cible de la référence.
◦ Description : Donne une description à la clé.
Si la clé est définie dans un plan de définition de clés DITA et que l'élément keydescription est spécifié, la description provient de cet élément. Sinon, la description est extraite du contenu de l'élément navtitle, de l'attribut navtitle ou de l'élément linktext (dans cet ordre).
◦ ID de l'élément : fournit l'identificateur de l'élément que vous avez prévu d'utiliser comme cible de la définition de clé.
Ces informations concernent uniquement les plans de définition de clés DITA pour lesquels une valeur a été attribuée à l'élément keysubelementid dans la définition de clé.
◦ Balises : établit une liste des éléments pour lesquels une clé a été définie dans le but de fournir une référence.
Ces informations concernent uniquement les plans de définition de clés DITA pour lesquels une valeur a été attribuée à l'élément keyreftags dans la définition de clé.
◦ Définition du plan : fournit le chemin d'accès au plan où figure la définition de la clé.
• Atteindre la définition : ouvre le plan contenant la définition de clé dans une nouvelle fenêtre Arbortext Editor et met en surbrillance la définition de clé dans le plan.