Transformation docbook -> livre [epub3] | ||
---|---|---|
Précédent | Chapitre 3. Transformer le livre DocBook [db:book] en livre [xhtml5] , [pdf] , [odpf:epub3] | Suivant |
Ouvrir le fichier DccBookLocal et vérifier en mode auteur que tous les médias sont liés localement au répertoire media.
ATTENTION, comme indiqué au chapitre 2.2, la transformation en epub est extrêmement stricte et IMPOSE que tous les media soient disponibles localement. Si besoin il sera possible de modifier cela une fois que la transformation sera effectuée.
Pour des raisons pratiques nous recommandons de travailler dans un dossier spécial qui contienne le fichier XML du livre chargé dans oXygen et le dossier media qui lui correspond.
Cliquer sur la clé avec triangle rouge, on obtient un popup dont l'illustration ci-dessous révèle le contenu :
Cocher la case configurer les scénarios de transformation DocBook epub 3 (expérimental). Veiller à bien choisir la transformation du groupe DocBook 5 si plusieurs groupes de transformation vous sont proposés.
Cliquer sur le bouton « enregistrer et fermer » puis cliquer sur le triangle rouge à côté de la clé pour exécuter la transformation.
Oxygen crée dans le dossier où se trouve le xml du livre un dossier « out » contenant :
un dossier epub3
un dossier temp
un fichier mimetype
La transformation standard est terminée on va maintenant pouvoir utiliser le fichier avec l'extension .epub qui vient d'être créé.
Dans le dossier "epub" on retrouve le fichier au format .epub, tous les fichiers temporaires qui ont servi à le construire ainsi qu'un dossier media qui ne contient que les images ou les videos. Il faudra donc compléter/remplacer ce dossier par l'original afin de conserver tous les medias reliés aux pages du livre produit.
On peut vérifier à ce stade que l'ensemble des fichiers XHTML nécessaires à la bonne présentation du livre sont présents. S'il manque le fichier de couverture, le fichier d'index ou le fichier de la table des matières c'est qu'une anomalie s'est produite lors de la transformation et la cause est fort probablement une anomalie du fichier DocBook initial :
s'il existe des messages d'erreur affichés par Oxygen les consulter et les transmettre à l'assistance,
si aucun message d'erreur n'est affiché c'est que le format du document bien que valide et transformable n'est pas conforme aux exigences d'un livre vérifier les prérequis listés dans les chapitres précédents.
Ce travail est à réaliser sur l'ensemble de fichiers produits par la transformation epub et sur le fichier DocBook original. Il peut s'avérer prudent de travailler sur une copie de ce fichier pour conserver un original ce qui évite de refaire la transformation DocBook - epub3 qui peut s'avérer longue pour des livres abondamment illustrés.
La transformation ne traite que les images, les videos de type mp4 et les audio de type mp3. La conséquence est que le dossier media inclus dans le livre au format epub ne contient pas tous les media. Il faut donc dans Oxygen glisser/déposer ou utiliser l'outil ajouter pour déposer dans le dossier media du livre tout ce qui manque en respectant l'arborescence du dossier media original.
XSL est le format des feuilles de style pour transformer les documents XML. On utilise donc une transformation xsl pour mettre en forme les éléments non traités par la transformation. On va utiliser pour faire ce travail le fichier "epubCleaner.xsl" que nous avons installé dans le chapitre précédent.
Attention ce fichier est susceptible d'être modifié au fur et à mesure de l'enrichisssement des livrets que nous produisons il faut vérifier que c'est toujours le dernier produit qui est utilisé. Il est déposé sur le site des sources.
Télechargez le fichier epub3Cleaner.xsl le plus récent et placez - le dans le répertoire qui contient le fichier DocBook qui a subi la transformation epub dans oXygen.
Il faut que ce fichier soit impérativement dans ce même répertoire pour que son exécution produise l'effet attendu sur les fichiers contenus dans le .epub.
Si le fichier est plus récent que celui que vous avez intallé lors d'un autre traitement, faites une nouvelle transformation "epu3Cleaner" l'illustration ci-dessous vous rappelle les réglages XSL URL.
Vous pouvez choisir "global" lors de la création de la transformation "epub3Cleaner" pour la conserver dans oXygen.
N'oubliez pas le réglage des paramètres l'illustration suivante vous rappelle leurs valeurs.
Dans certains livrets .epub nous intégrons du son et des vidéos. Il est possible de disposer dans la table des matières d'un accès direct aux figures contenant ce types de fichier.
Les paramètres permettent cela. Cliquez sur le bouton "paramètres" pour faire aparaître les choix possibles.
Cochez les paramètres dont vous voulez qu'ils s'appliquent lors de la transformation.
Dans les champs valeur il faut, lorsque vous voulez utiliser les options audio et video sélectioner le champ l'éditer et lui ajouter un 1 (laisser le champ vide pour ne pas effectuer le rajout de table des matières dédiées).
Pour le paramètre db-file il faut inscrire le nom du fichier qui a subi la transformation (nomdubook.xml) et qui est dans le même répertoire que la xsl.
L'illustration Figure 3.8, « Le popup de sélection des paramètres »ci-dessus montre le résultat de ces trois actions.
Pour tous les fichiers xhtml du epub ansi que pour le fichier opf lancer la transformation en cliquant sur le bouton . La transformation s'effectue au sein d'oXygen et le résultat apparait dans la fenêtre inférieure d'oXygen.
Cliquer dans cette fenêtre sélectionner la totalité de son contenu en appuyant simultanément sur les touches <Ctl><A> puis copier le contenu en appuyant simultanément sur les touches <Ctl><C>, cliquer dans la fenêtre contenant le fichier xhtml, sélectionner la totalité de son contenu en appuyant simultanément sur les touches <Ctl><A> et enfin coller le contenu en appuyant simultanément sur les touches <Ctl><V>.
Sur MacOS remplacer les <ctrl> par <cmd>
Sauvegarder les fichiers ce qui modifie automatiquement leur version dans le fichier epub.