Chapitre 2. Produire un livre docbook [db:book]. | ||
---|---|---|
Précédent | Suivant |
Vous devez disposer d'un article au format DocBook 5 pour continuer. La production d'un article vous est proposée dans l'epub que vous pouvez télécharger en suivant ce lien. Vous pouvez aussi visualiser l'article en ligne en suivant cet autre lien.
Ouvrir l'article dans Oxygen puis l'enregistrer sous son nom de livre (différent du nom de l'article).
Vérifier que l'en-tête du fichier xml est bien une en-tête DocBook et pas l'en-tête DOA qui entraine l'utilisation d'une transformation non standard incompatible avec epub3, il faut avoir le texte ci-dessous qui peut se présenter sous la forme de trois longues lignes (sans les retours à la ligne après la définition de chaque élément) :
<?xml version="1.0" encoding="UTF-8"?> <?xml-model href="http://docbook.org/xml/5.0/rng/docbook.rng" schematypens="http://relaxng.org/ns/structure/1.0"?> <?xml-model href="http://docbook.org/xml/5.0/rng/docbook.rng" type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
Ou bien rajoutez les deux lignes manquantes si vous n'avez que :
<?xml version="1.0" encoding="UTF-8"?>
Vérifiez que la balise article ne contient plus d'attribut de type DOA. Si c'était le cas supprimez la référence pour n'obtenir que :
<article version="5.0" xml:lang="fr">
Placer le curseur sur la balise article, choisir avec un clic sur le bouton de droite le menu « Refactoring », choisir « entourer par », choisir la balise <book>.
Votre article est alors inséré au sein d'un livre.
Ce changement de contexte induit des anomalies temporaires qu'on va corriger simplement par étapes. La situation est la suivante :
<book> <article xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:mml="http://www.w3.org/1998/Math/MathML" version="5.0" xml:lang="fr">
Il faut donc couper tous les attributs de la balise <article> sauf le namespace docbook afin de ne pas avoir de doublon pour les coller dans la balise <book>.
Vous avez maintenant un livre valide mais incomplet car il ne possède ni page de garde ni informations propres au livre.
Il faut impérativement fournir ces informations sinon le livre n'apparait pas convenablement dans les outils de lecture. Deux cas sont possibles à ce stade :
Soit le livre doit contenir plusieurs articles/parties et dans ce cas la solution la plus simple est de copier /coller la balise <info> et son contenu depuis article vers <book> (au dessus de <article> et sous <book>) puis de compléter les informations pour décrire le livre comme indiqué ci-dessous.
Soit le livre ne va contenir qu'un seul article et dans ce cas les informations de l'article doivent être transférées au livre il faut alors couper /coller la balise <info> avec tout son contenu (important) et la placer après la balise <book> et avant la balise <article>. Ce déplacement a pour effet d'introduire une anomalie, en effet l'article n'a plus de titre ! Il suffit soit de copier coller la balise <title> et son contenu après la balise <article> et avant la balise <sect1>, soit d'ajouter une nouvelle balise <title> sous la balise <article> et la remplir le texte désiré.
En copiant ou déplaçant <info> on vient d'attribuer au livre le titre de l'article, vous pouvez bien sûr modifier le titre du livre et de l'article en fonction de vos besoins.
Il est possible de transformer la balise <article> en <chapter> ou de l'entourer avec une balise <part> en utilisant le menu « refactoring » vu plus haut mais nous n'avons pas testé les effets (toutes informations sont les bienvenues), probablement le passage d'un livre de type actes de colloque à un « vrai » livre et très certainement un traitement différent du formattage lors du rendu.
Votre livre n'a toujours pas de couverture, il vous faut rajouter l’image qui servira de couverture à votre livre dans dans le dossier images du dossier media rattaché à votre article. Donnez-lui un nom qui vous permette de l'identifier facilement.
Ajouter ensuite la balise <cover> dans la balise <info> de <book> avec les éléments ci-dessous :
<cover> <mediaobject> <imageobject> <imagedata fileref="http://mediaserv.climatetmeteo.fr/users/EricLeJan/NoticeBook/images/imageDeCouv.jpg"> </imagedata> </imageobject> </mediaobject> </cover>
L'image doit apparaître en mode auteur dans Oxygen.