Les cartes sont utilisées pour compiler, organiser et définir les relations entre les rubriques DITA. Une carte peut contenir :
-
tous les concepts et les références avec des informations sur un seul produit
-
toutes les tâches donnant des instructions sur l’utilisation de ce produit
-
un glossaire des termes liés
Bien qu’une seule rubrique DITA puisse être publiée seule, de nombreux auteurs rassemblent les rubriques dans des cartes en vue de la publication.
L’utilisation de cartes peut ajouter de la flexibilité et faciliter la réutilisation dans votre travail de publication. Si vous avez une rubrique dont le contenu s’applique à plusieurs produits (comme des informations communes sur la sécurité), vous pouvez écrire cette rubrique une seule fois et la référencer dans plusieurs cartes.
Vous pouvez également référencer d’autres cartes à partir d’une même carte. Cela vous permet de regrouper des ensembles de rubriques connexes. Par exemple, vous pouvez avoir besoin de compiler toutes les cartes pour des produits individuels en une seule carte pour une famille de produits.
Les cartes peuvent contenir des métadonnées, telles que des informations sur les produits, les droits d’auteur et la date de publication. Les métadonnées des cartes peuvent être utilisées pour aider votre entreprise à gérer et à distribuer votre contenu plus efficacement, ou pour aider vos clients à trouver plus facilement le contenu dont ils ont besoin.
Au minimum, une carte doit contenir un élément racine <map>. L’élément <map> peut contenir les éléments suivants :
-
L’élément <title>, qui permet de nommer la carte (par exemple, « Guide utilisateur du produit X »). Le texte de l’élément <title> peut également être utilisé comme titre de votre document de sortie.
-
Un certain nombre d’éléments <topicref>, qui vous permettent de référencer des rubriques dans la carte. Un élément de <topicref> peut contenir d’autres éléments <topicref>.
-
Un certain nombre d’éléments <mapref>, qui vous permettent de référencer d’autres cartes dans la carte principale.
-
Un certain nombre d’éléments <reltable>, qui vous permettent de définir des relations dans votre contenu.
Remarque :
Pour plus d’information sur l’élément <map>, se référer à la norme OASIS DITA version 1.2.