Réutiliser du contenu à travers plusieurs rubriques

Lors de la publication d’une rubrique qui réutilise du contenu, le référencement de cette dernière ne peut être résolue que si l’élément référencé est accessible par la carte DITA. Par exemple :

  • Si les rubriques contenant l’élément référencé et l’élément référençant sont présents dans la même carte, alors le conref peut être résolu dans le contexte de la carte.

  • Si les rubriques contentant l’élément référencé et l’élément référençant se trouvent dans des cartes séparées, mais que ces dernières font partie d’une carte plus large, alors le conref peut être résolu dans le contexte de la carte plus large.

Ordinairement, si une rubrique est ajoutée par un topicref dans l’une des cartes, alors elle sera publiée avec les autres rubriques. Cependant, vous ne voulez pas publier votre rubrique partagée. Pour marquer que ces ressources ne sont pas prévues pour la publication, ajouter la valeur resource-only à l’attribut processing-role de l’élément <topicref>.

Dans l’exemple suivant, tache.dita sera publié, tandis que avertissements.dita ne le sera pas. Néanmoins, avertissements.dita sera disponible pour résoudre les conrefs de tache.dita ou de n’importe quelle autre rubrique présente dans cette carte.

<map>
... 
  <topicref href="commun/avertissements.dita" processing-role="resource-only"/>
...
  <topicref href="rubriques/tache.dita"/>
...
</map>
		   

Note: Si vous utilisez un CMS, son système peut résoudre les conrefs ou références directes dans la rubrique que vous consultez ou éditez même sans un contexte commun défini par une carte. Cependant, en fonction de vos paramètres de publication, ces référencement de contenu pourraient ne pas être résolus lors de la publication de ces rubriques. La meilleure pratique est d’insérer les rubriques contenants les éléments référençants et référencés dans la même carte ou sous-carte.

Contributors