Les fichiers carte décrivent la façon dont vous organisez le contenu pour la livraison. Ils ressemblent à une table des matières : ils créent une séquence et une hiérarchie entre les rubriques. Lorsque vous générez un fichier PDF ou un système d’aide à partir d’un fichier carte, votre lecteur voit les rubriques dans l’ordre et la hiérarchie établis par le fichier carte.
En général, vous n’ajoutez pas toutes les runriques disponibles à un fichier carte, mais uniquement celles que vous souhaitez inclure dans un livrable. En outre, vous pouvez inclure la même rubrique dans plusieurs fichiers carte, ce qui est un autre exemple de réutilisation dans DITA.
Vidéo : Exemple de fichier carte DITA
- les éléments topicref, qui fournissent un lien vers une rubrique spécifique
- les éléments mapref, qui fournissent un lien vers une autre carte
Dans un fichier carte, vous mettez les topicrefs dans l’ordre, de haut en bas, pour indiquer une séquence. Pour indiquer une hiérarchie, vous imbriquez les rubriques. Considérons l’exemple suivant :
<map> <title>Ma première carte</title> <topicref href="canards.dita"> <topicref href="variete.dita"/> <topicref href="taille.dita"/> <topicref href="nids.dita"/> </topicref> </map>
Pour plus de commodité, le code est indenté. Mais ce qui compte, c’est que le premier topicref (canards) englobe les trois autres fichiers. Les rubriques variete.dita, taille.dita et nids.dita sont tous subordonnés à la rubrique canards.dita. Le résultat est une table des matières structurée comme ceci :
- Canards
- Variété
- Taille
- Nids
En plus des liens vers des rubriques, vous pouvez référencer des fichiers carte dans des fichiers carte. Dans cette approche, les cartes subordonnées (sous-cartes) sont généralement une collection de contenu associé. Par exemple, vous pouvez créer un fichier carte de niveau chapitre pour chaque chapitre d’un livre, puis référencer ces fichiers carte de niveau chapitre dans votre fichier carte principal de niveau livre.
À la place d’un topicref, une référence vers une carte utilise un mapref. Si vous souhaitez utiliser le contenu de la carte canard en tant que composant d’une autre carte, vous devez l’insérer dans la carte parente, comme indiqué ci-dessous:
<topicref href="poissons.dita"> <topicref href="oiseauxmarins.dita"> <mapref href="canard.ditamap" format="ditamap"/>
Vidéo : Réutilisation d’un fichier carte dans un fichier carte