Rappel sur la réutilisation de contenu

Dans le cours Introduction à la réutilisation dans DITA, vous avez appris comment utiliser l’attribut conref pour réutiliser du contenu. L’attribut conref sert à référencer le contenu d’un élément (probablement d’une autre rubrique) pour l’afficher dans un autre élément semblable.

Pour réutiliser du contenu, plusieurs conditions sont à remplir :

  • L’élément référencé (le contenu récupéré) doit disposer d’un attribut id :
    <p id="utilise_moi">Ceci est un paragraphe réutilisable.</p>
  • L’élément référençant, vide, doit utiliser l’attribut conref pour spécifier l’id de la rubrique et de l’élément référencé :
    <p conref="#ma_rubrique/utilise_moi"/>

    Ou bien si l’élément référencé est dans un autre fichier :

    <p conref="rubrique_fichier.dita#ma_rubrique/utilise_moi"/>

Le conref est résolu quand la rubrique contenant l’élément référençant est transformée en vue de générer une publication. Certains éditeurs DITA peuvent afficher le contenu référencé en lecture seule.

Contributors