Une bookmap est une spécialisation d’un fichier carte DITA, qui utilise l’élément <bookmap> à la place de l’élément <map> pour contenir ses références aux rubriques et aux cartes. Une bookmap doit contenir, à minima, un élément racine <bookmap>. L’élément <bookmap> peut contenir les éléments suivants :
-
L’élément <booktitle>, qui vous permet de nommer la bookmap (comme « Manuel du Produit X »).
-
L’élément <bookmeta>, qui défini les métadonnées de la bookmap.
-
L’élément <frontmatter>, qui contient les informations que l’on trouve généralement au début d’un livre, tel qu’une table des matières ou une préface.
-
Un certain nombre d’éléments <chapter>. Chaque élément <chapter> contient un lien vers une rubrique qui est inclue au premier niveau de la bookmap. Un élément <chapter> peut aussi contenir un certain nombre d’éléments <topicref> subordonnés.
-
L’élément <backmatter>, qui contient les informations que l’on trouve généralement à la fin d’un livre, tel qu’un index ou un glossaire.
Remarque :
Pour plus d’information sur l’élément <bookmap>, se référer à la norme OASIS DITA version 1.2.
Pratique
- Faites une copie du fichier exemples_cartes_bookmaps/exemples/_b_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 bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "bookmap.dtd">
<bookmap id="canards">
</bookmap>
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 bookmap.
La troisième ligne est la balise d’ouverture de l’élément <bookmap>, qui utilise l’identifiant unique « canards ».
La quatrième ligne utilise la balise de fermeture </bookmap> pour montrer où se termine l’élément <bookmap>.
- À l’intérieur de l’élément <bookmap>, ajoutez un élément <booktitle> 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>
</booktitle>
</bookmap>
- À l’intérieur de l’élément <booktitle>, ajoutez l’élément <mainbooktitle> 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>
<mainbooktitle>Titre principal du livre</mainbooktitle>
</booktitle>
</bookmap>
Maintenant que vous avez mis en place la structure de base de votre bookmap, vous pouvez commencer à ajouter des chapitres.
Contributeurs
