Les meilleures pratiques pour l’utilisation avancée des conrefs

Doit-on utiliser des clés ou des conkeyrefs pour réutiliser des chaînes de caractères courtes ?

Si vous voulez utiliser des clés pour référencer une chaîne de caractères plutôt courte comme le nom de votre entreprise, utiliser une clé est la façon la plus facile de procéder.

Cependant, l’élément <keyword> utilisé pour définir une clé ne peut contenir seulement que du texte et l’élement <tm> (trademark, marque déposée). Si la clé nécessite d’être formatée, alors il sera plus simple d’utiliser un élément <ph> (phrase).

Par exemple, le nom d’entreprise “Pure-H2O” ne peut être accepté comme valeur pour l’élément <keyword>. Vous aurez plutôt besoin de l’élement <ph> :

<ph id="nom_entreprise">Pure-H<sub>2</sub>O</ph>

Pour créer une rubrique réutilisable avec le nom de l’entreprise référencé, utilisez l’élement <ph> avec un conkeyref.

Conkeyref ou conrefend ?

Voici une règle à suivre afin de déterminer s’il faut utiliser un conkeyref ou un conrefend :

  • Si l’élément sera toujours présent, mais changera en fonction de la cible, utiliser un conkeyref.
  • Si l’élément ne sera présent que pour une ou deux cibles (sur de nombreuses autres), utiliser un conrefend.

Rassembler les clés dans une sous-carte

Comme il a été recommandé dans la leçon sur l’utilisation des clés, il est pratique d’utiliser une sous-carte pour rassembler les définitions de clés pour les conkeyref.

Contributors