L’élément <chapter> est structuré comme suit :
<chapter href="chemin/nomfichier.dita">
À l’exception du nom de l’élément, la structure d’un élément <chapter> correspond à la structure de l’élément <topicref>. Dans un élément <chapter>, l’attribut href contient un lien vers une rubrique qui est inclue dans la bookmap au premier niveau, ou niveau chapitre.
L’élément <chapter> peut contenir les éléments suivants :
-
L’élément <topicmeta>, qui défini les métadonnées sur la rubrique référencée au niveau chapitre.
-
Un certain nombre d’éléments <topicref>.
-
Un certain nombre d’éléments <mapref>.
Si vous utilisez une bookmap, vous allez presque certainement distribuer votre contenu sous forme imprimée ou PDF. Il est donc important de penser aux limites de l’espace physique de ce type de production lorsque vous établissez votre hiérarchie de sujets. Si vous imbriquez trop de niveaux de rubriques dans un chapitre, vous risquez de manquer de moyens pour différencier vos niveaux de titres, que ce soit en diminuant la taille des caractères ou en augmentant les retraits. Cela pourrait être source de confusion pour les personnes qui tentent de lire votre contenu.
Remarque :
Pour plus d’informations sur l’élément <chapter>, se référer à la norme OASIS DITA version 1.2.
Pratique
- Continuez d’utiliser le fichier exemples_cartes_bookmaps/exemples/_b_canards_demarrer.ditamap.
- Après la balise de fermeture de l’élément <booktitle>, ajoutez un élément <chapter> 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">
...
</booktitle>
<chapter href="c_canards_sauvages.dita">
</chapter>
</bookmap>
Cet élément <chapter> crée un lien vers le concept c_canards_sauvages.dita.
- À l’intérieur de l’élément <chapter> que vous venez d’ajouter, ajoutez un élément <topicref> 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">
...
<chapter href="c_canards_sauvages.dita">
<topicref href="c_types_canards_sauvages.dita"/>
</chapter>
</bookmap>
En plaçant cet élément <topicref> à l’intérieur de l’élément <chapter>, vous avez imbriqué la rubrique c_types_canards_sauvages.dita dans le chapitre c_canards_sauvages.dita dans la hiérarchie de votre bookmap.
- Après l’élément <topicref> que vous venez d’ajouter, ajoutez deux autres éléments <topicref> 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">
...
<chapter href="c_canards_sauvages.dita">
<topicref href="c_types_canards_sauvages.dita"/>
<topicref href="c_especes_canards_sauvages.dita"/>
<topicref href="t_observer_canards_sauvages.dita"/>
</chapter>
</bookmap>
Le chapitre c_canards_sauvages.dita contient maintenant trois rubriques imbriquées : c_types_canards_sauvages.dita, c_especes_canards_sauvages.dita et t_observer_canards_sauvages.dita.
- Après la balise de fermeture de l’élément <chapter>, ajoutez plus d’éléments <chapter> 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">
...
</chapter>
<chapter href="c_canards_domestiques.dita">
<topicref href="c_croissance_des_canards.dita"/>
<topicref href="c_nourrir_canetons.dita">
<topicref href="c_poids_du_canard.dita"/>
</topicref>
</chapter>
<chapter href="c_canarddb.dita">
<topicref href="c_ecrire_sur_canards.dita" locktitle="yes"/>
<topicref href="r_tnav.dita"/>
</chapter>
</map>
La hiérarchie de la bookmap contient maintenant trois chapitres : c_canards_sauvages.dita, c_canards_domestiques.dita et c_canarddb.dita. Chacun de ces chapitres contient plusieurs éléments <topicref> imbriqués. L’un de ces éléments <topicref> de second niveau, c_nourrir_canetons.dita, contient un élément <topicref> de troisième niveau, c_poids_du_canard.dita.
- Utilisez le fichier exemples_cartes_bookmaps/exemples/_b_canards.ditamap pour vérifier votre fichier exemples_cartes_bookmaps/exemples/_b_canards_demarrer.ditamap.
Pratique
- Ouvrez le fichier exemples_cartes_bookmaps/exercices/_b_cs101_debut.ditamap et utilisez-le pour assembler les rubriques dans une carte DITA, en utilisant la structure hiérarchique suivante comme guide :
- 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
- Utilisez le fichier exemples_cartes_bookmaps/exercices/_b_cs101.ditamap pour vérifier votre fichier exemples_cartes_bookmaps/exercices/_b_cs101_debut.ditamap.
Contributeurs
