Éléments shortdesc dans la carte DITA

Les éléments shortdesc spécifiés dans une rubrique DITA peuvent être écrasés par des éléments shortdesc de la carte DITA.

Les rubriques possèdent normalement un élément de description courte (shortdesc). Celui-ci est généralement rendu dans la publication par :

  • le premier paragraphe de la rubrique
  • le texte d'aperçu des liens (pour les publications hypertexte)
  • le texte d'aperçu des rubriques filles dans les rubriques parents

Dans certaines circonstances, vous serez peut-être amené à remplacer le texte d'aperçu des rubriques filles par une description alternative, spécifique à la publication. Pour cela, vous devez spécifier la shortdesc alternative dans la carte DITA. Cela peut se faire en ajoutant un élément shortdesc dans l'élément topicmeta de l'élément topicref.

Voici un exemple de marquage de l'élément topicref :
<topicref href="c_starting_xrw.dita" format="dita">
  <topicmeta>
    <shortdesc>Le XRW est démarré en tapant le code PIN sur la clavier
    sécurisé, puis en tournant la clé dans le démarreur.</shortdesc>
  </topicmeta>
</topicref>
Remarque : L'insertion d'un élément linktext dans l'élément topicmeta de topicref permet également, pour les liens hiérarchiques générés, d'utiliser le texte alternatif plutôt que le titre de la rubrique.