Créer une nouvelle carte DITA

Utiliser les cartes DITA Leçon 1 : Créer une carte Créer une nouvelle carte DITA

Progression de la Leçon

0% Terminé

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.

Pratique

Faites une copie du fichier exemples_cartes_bookmaps/exemples/_m_canards_demarrer.ditamap et ouvrez-le dans votre éditeur.

Remarque :

Si vous utilisez un éditeur DITA, assurez-vous d’être en mode texte plutôt qu’en mode auteur ou visuel.
Vous devriez voir ceci :
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map id="canards">
 <title>xyz</title>
</map>
```
La première ligne (qui commence par <?xml) est une déclaration XML, qui est une partie standard de tous les fichiers XML.

La déclaration DOCTYPE sur la deuxième ligne identifie ce fichier comme une carte DITA.

La troisième ligne est la balise d’ouverture de l’élément <map>, qui utilise l’identifiant unique « canards ».

L’élément <title> sur la quatrième ligne contient le titre de la carte.

La cinquième ligne utilise la balise de fermeture </map> pour montrer où se termine l’élément <map>.
À l’intérieur de l’élément <title>, modifiez le texte du titre comme le montre l’exemple suivant :
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map id="canards">
   <title>Canards</title>
</map>
```
Maintenant que vous avez mis en place la structure de base de votre carte, vous pouvez commencer à référencer des rubriques.

Contributeurs

Chapitre précédent

Retour à la Leçon

Chapitre suivant