La phrase « réutiliser une rubrique » signifie généralement utiliser une rubrique dans plusieurs cartes. Cependant, il existe des situations où vous souhaitez utiliser la même rubrique dans la même carte.
Par exemple, imaginez une carte DITA d’un cours et dans lequel chaque contenu introduisant un test est toujours le même. Plutôt que de créer une rubrique différente à chaque réapparition d’un test, vous pouvez plutôt créer une rubrique commune, et la réutiliser à chaque fois que la situation se présente.
Cependant, si vous réutilisez la même rubrique dans une seule carte, vous devrez ajouter l’attribut copy-to à la balise <topicref>
<map> ... <topicref href="ma_rubrique.dita" copy-to="première_copie.dita"/> ... <topicref href="ma_rubrique.dita" copy-to="seconde_copie.dita"/> ... </map>
La raison principale pour laquelle utiliser l’attribut copy-to est l’assurance que la référence du contenu pointe vers la bonne version du fichier.
C’est dans les bonnes pratiques d’appliquer l’attribut copy-to à tous les <topicref> renvoyant à la rubrique réutilisée, et non seulement à la première référence. Si vous réorganisez votre contenu, vous risquez d’oublier que cette rubrique est réutilisée.
Si votre carte principale ou bookmap réutilise plusieurs sous-cartes et que chacune de ces cartes réutilise la même rubrique, vous devez continuer à utiliser l’attribut copy-to. Quand vous générez une publication, le prétransformateur fusionne toutes les sous-cartes avec la carte principale pour en créer une nouvelle. Cette nouvelle carte est alors utilsée pour générer la publication.
Vous pouvez utiliser les balises <navtitle>, <linktext>, et <shortdesc> pour ajouter un titre et une description unique à la rubrique réutilisée.
<map> ... <topicref href="ma_rubrique.dita" copy-to="première_copie.dita"> <topicmeta> <navtitle>Nom de la première copie</navtitle> <linktext>Nom de la première copie</linktext> <shortdesc>Informations mofidiées à propos de la première copie de la rubrique.</shortdesc> </topicmeta> </topicref> ... <topicref href="ma_rubrique.dita" copy-to="seconde_copie.dita"> <topicmeta> <navtitle>Nom de la seconde copie</navtitle> <linktext>Nom de la seconde copie</linktext> <shortdesc>Informations mofidiées à propos de la seconde copie de la rubrique.</shortdesc> </topicmeta> </topicref> ... </map>
Contributors
- Simon Bate
- Jake Campbell
- Gretyl Kinsey
- Decarnelle Rémi (traducteur)