Il peut arriver que le titre d’une rubrique – en particulier une rubrique réutilisée – ne corresponde pas aux titres des autres rubriques d’une carte. Par exemple, toutes vos rubriques tâches peuvent utiliser une forme infinitive (« Imprimer le… »), mais la rubrique réutilisée peut utiliser une forme nominale (« L’impression de… »). Pour que le titre d’une rubrique soit cohérent dans votre texte et votre table des matières, utilisez l’élément <navtitle> pour spécifier un titre plus cohérent ou plus approprié.
Dans certaines cartes et bookmaps DITA plus anciennes, vous pourriez rencontrer le navtitle comme attribut pour les éléments <topicref> et autres. Il s’agit d’une forme plus ancienne et son utilisation est déconseillée. Utilisez toujours l’élément <navtitle> lorsque vous créez un nouveau contenu.
Remarque :
Pour plus d’information sur l’élément <navtitle>, se référer à la norme OASIS DITA version 1.2.
Pratique
- Continuez d’utiliser le fichier exemples_cartes_bookmaps/exemples/_b_canards_avances_debut.ditamap.
- Trouvez l’élément <topicref> pointant vers r_tnav.dita et ajoutez-y un attribut locktitle avec la valeur « yes », comme le montre l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "bookmap.dtd">
<bookmap id="canards">
...
<topicref href="r_tnav.dita" locktitle="yes"/>
...
</bookmap>
Remarque : Si vous souhaitez utiliser l’élément navtitle, vous devez placer l’attribut locktitle à « yes ». Le placer à « no » ou l’omettre résulterait à ne pas utiliser l’élément navtitle.
- Transformez l’élément <topicref> d’une balise vide (« <topicref …/> ») en une balise ouverte et fermée («<topicref…></topicref> »)
<topicref href="r_tnav.dita" locktitle="yes">
</topicref>
- À l’intérieur de l’élément <topicref>, ajoutez un élément <topicmeta> et ajoutez-y du contenu comme le montre l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "bookmap.dtd">
<bookmap id="canards">
...
<topicref href="r_tnav.dita" locktitle="yes">
<topicmeta>
<navtitle>La commande tNav</navtitle>
</topicmeta>
</topicref>
...
</bookmap>
Maintenant que vous avez spécifié un élément navtitle, la phrase « La commande tNav » apparaîtra dans la table des matières à la place du titre de cette rubrique, qui est tout simplement « tNav ».
- Utilisez le fichier exemples_cartes_bookmaps/exemples/_b_canards_avances.ditamap pour vérifier votre fichier exemples_cartes_bookmaps/exemples/_b_canards_avances_debut.ditamap.
Pratique
- Ouvrez le fichier exemples_cartes_bookmaps/exercices/_b_cs101_debut.ditamap et utilisez-le pour ajouter des métadonnées, frontmatter et backmatter à la bookmap en utilisant la structure bookmap suivante comme guide :
Auteur : Sarah O’Keefe
Auteur : Alan S. Pringle
Éditeur : Services d’édition de Scriptorium, Inc.
Création : 2012
Révision : 2014
Table des matières :
- Chapitre 1 : 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 »
- Chapitre 2 : 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
- Chapitre 3 : Questions juridiques et réglementaires
- Éviter l’exposition juridique
- Répondre aux exigences réglementaires
- Livraison d’information
- Normes techniques
Index :
- Utilisez le fichier exemples_cartes_bookmaps/exercices/_b_cs101_avances.ditamap pour vérifier votre fichier exemples_cartes_bookmaps/exercices/_b_cs101_debut.ditamap.
Contributeurs
