L’élément <mapref> est structuré comme suit :
<mapref href="chemin/nomfichier.ditamap" format="ditamap">
L’attribut href contient un lien vers une autre carte qui est référencée dans votre carte principale. L’attribut format spécifie que le fichier lié est une carte DITA.
L’élément <mapref> peut uniquement contenir les éléments de métadonnées <topicmeta>, <data> et <data-about>. Avec DITA, vous ne pouvez imbriquer aucun élément <topicref> ou <mapref> à l’intérieur d’un élément <mapref>.
Tout comment l’élément <topicref> vous permet de réutiliser une rubrique dans plus d’une carte, l’élément <mapref> vous permet de réutiliser une collection de rubriques. En construisant une carte une fois et en la référençant dans d’autres cartes, vous pouvez économiser le temps et les efforts qu’il aurait fallu pour recréer la même série ou hiérarchie d’éléments <topicref> dans plusieurs cartes.
En plus de la réutilisation, l’élément <mapref> vous donne une flexibilité supplémentaire lorsque vous publiez votre contenu. Vous pouvez regrouper des cartes connexes dans une carte plus grande, de sorte que vous pouvez rapidement fournir tout le contenu pour une famille de produits entière. Vous pouvez également utiliser l’élément <mapref> pour ajouter un glossaire à une carte, comme vous apprendrez à le faire par la suite.
Remarque :
Pour plus d’information sur l’élément <mapref>, se référer à la norme OASIS DITA version 1.2.
Pratique
- Continuez d’utiliser le fichier exemples_cartes_bookmaps/exemples/_m_canards_demarrer.ditamap.
- Après le dernier élément <topicref>, ajoutez un élément <mapref> et ajoutez-y du contenu 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>
...
</topicref>
<mapref href="g_orggloss_canards.ditamap" format="ditamap"/>
</map>
Cet élément <mapref> crée un lien vers le glossaire g_orggloss_canards.ditamap. En utilisant l’élément <mapref> pour créer un lien vers le glossaire, vous pouvez éviter les tracas liés à l’utilisation des éléments <topicref> pour construire le glossaire directement dans votre carte. Cela rend également votre glossaire plus facilement disponible pour être réutilisé dans d’autres cartes.
- Utilisez le fichier d’exemple exemples_cartes_bookmaps/exemples/_m_canards.ditamap pour vérifier votre fichier exemples_cartes_bookmaps/exemples/_m_canards_demarrer.ditamap.
Pratique
- Ouvrez le fichier exemples_cartes_bookmaps/exercices/_m_cs101_debut.ditamap et utilisez-le pour assembler les rubriques dans une carte DITA, en utilisant la structure hierarchique suivante comme guide :
- Maîtriser les coûts de communication technique
- L’illusion de la documentation à faible coût
- Développement efficace du contenu technique
- Réduire le coût du support technique
- Une meilleure information technique, moins d’appels au support
- Des opérations de support plus efficaces
- Collaboration en matière de contenu au sein de l’organisation
- « Collaboration » ≠ « contenu libre pour tous »
- Marketing et visibilité des produits
- Assister le marketing avec du contenu technique
- Renforcer le message marketing
- Quand le contenu technique contredit le marketing
- Accroître la visibilité des produits
- Livres de tierces parties
- Créer une communauté d’utilisateurs et les fidéliser
- Étendre l’expérience de jeu au contenu
- Questions juridiques et réglementaires
- Éviter l’exposition juridique
- Répondre aux exigences réglementaires
- Livraison d’information
- Normes techniques
- Utiliser le fichier exemples_cartes_bookmaps/exercices/_m_cs101.ditamap pour vérifier votre fichier exemples_cartes_bookmaps/exercices/_m_cs101_debut.ditamap.
Contributeurs
