Transformation docbook -> livre [xhtml5] | ||
---|---|---|
Précédent | Chapitre 3. Transformer le livre DocBook [db:book] en livre [xhtml5] , [pdf] , [odpf:epub3] | Suivant |
Deux transformations sont possibles, l'une conduit à un fichier xhtml unique l'autre fournit un ensemble de fichiers liés proposant une structuration en "pages par chapitre". Dans le premier cas on obtient un seul fichier avec l'extension xhtml qui porte le nom du fichier DocBook, dans le second cas on obtient une série de fichiers comprenant au moins un fichier "index.html" et une série de fichiers avec une extension xhtml dont les noms sont générés automatiquement à partir du numéro d'ordre de la partie, du chapitre, de la section par exemple la section 1 du chapitre 2 s'appellera ch02s01.xhtml.
Ouvrir le fichier DocBook, cliquer sur le bouton permettant de créer une nouvelle transformation , décocher tout autre transformation qui serait enclenchée pour éviter qu'elle se reproduise, choisir le groupe Global et cocher la case à gauche de la ligne "DocBook XHTML5" qui a été créé au chapitre précédent. Sauvegarder puis lancer la transformation en cliquant sur le bouton . Un dossier "out" est créé s'il n'existe pas déjà, dans ce dossier est créé un dossier "xhtml" qui contient le fichier résultant de la transformation au format xhtml, et un fichier docbook.css qui propose une CSS sommaire pour l'affichage du fichier produit.
Par défaut une fenêtre de navigateur s'ouvre aussi pour afficher le résultat ce qui confirme que la transformation s'est bien passée. Une vérification vous permet de voir qu'une partie des informations a probablement disparu en particulier pour ce qui concerne les droits sur les média. Cette situation s'explique par un certain nombre de choix effectués par l'équipe proposant les transformations docbbok-xsl, une demande de modification a été faite mais pour le moment est sans suite.
Afin de récupérer les informations non affichées nous allons appliquer une nouvelle transformation qui prend en compte un certain nombre de règles fixées par le projet et qui affiche les informations sur les droits. S'il est besoin de modifier les choix éditoriaux faits pour tremplin il suffit de modifier le fichier xhtmlCleaner qui a été installé dans le chapitre précédent .
Ouvrir le fichier xhtml du dossier out/xhtml, ce fichier apparait sous une forme peu lisible, ne vous en préoccupez pas nous allons le reformatter.
Cliquer sur le bouton permettant de régler une nouvelle transformation , décocher tout autre transformation qui serait enclenchée pour éviter qu'elle se reproduise, choisir le groupe Global et cocher la case à gauche de la ligne de la transformation "xhtmlCleaner" qui a été créé au chapitre précédent. Sauvegarder puis 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>
Il est possible maintenant de changer la CSS utilisée en remplaçant le nom du fichier utilisé dans l'en-tête (<head>) par exemple une des propositions disponible sur le serveur de media:
<link rel="stylesheet" type="text/css" href="http://mediaserv.climatetmeteo.fr/css/eric/docbook.css"/>
Pour être totalement compatible avec la version la plus stricte on peut rajouter sous la première ligne une ligne contenant simplement :
<!DOCTYPE html>
Vous pouvez maintenant sauvegarder le fichier xhtml et le déposer en ligne dans la collection db/data-xhtml/acces à l'intérieur d'un répertoire portant le nom de votre livre.
Ouvrir le fichier DocBook, cliquer sur le bouton permettant de créer une nouvelle transformation , décocher tout autre transformation qui serait enclenchée pour éviter qu'elle se reproduise, choisir le groupe Global et cocher la case à gauche de la ligne "DocBook XHTML5 - Chunk" qui a été créé au chapitre précédent. Sauvegarder puis lancer la transformation en cliquant sur le bouton .
Un dossier "out" est créé s'il n'existe pas déjà, dans ce dossier est créé un dossier "xhtml-chunks" qui contient une famille de fichiers résultant de la transformation au format xhtml, et un fichier docbook.css qui propose une CSS sommaire pour l'affichage du fichier produit. Il y a au moins un fichier index.xhtml qui correspond à la première page du livre et ensuite une suite de fichiers correspondant chacun à une "page" du livre.
Il ne s'agit pas de pages au sens livre imprimé mais de "pages web" contenant chacune seulement un chapitre ou un sous-chapitre. Par défaut une fenêtre de navigateur s'ouvre aussi pour afficher le résultat ce qui confirme que la transformation s'est bien passée. Une vérification vous permet de voir d'une part qu'une structure complexe en pages a été produite et d'autre part que comme pour le chapitre précédent qu'une partie des informations a probablement disparu en particulier pour ce qui concerne les droits sur les média pour les raisons déjà citées.
Afin de récupérer les informations non affichées nous allons appliquer à chaque fichier xhtml la transformation spécifique, "xhtmlChunkCleaner" crée au chapitre précédent qui prend en compte les mêmes règles fixées par le projet.
Ouvrir tous les fichiers xhtml du dossier out/xhtml-chunk correspondant à cette transformation (ne pas retoucher le fichier précédent qui est correct), chaque fichier apparait sous une forme plus ou moins lisible, ne vous en préoccupez pas nous allons les reformatter.
Pour chaque fichier xhtml , cliquer sur le bouton permettant de sélectionner une nouvelle transformation , décocher tout autre transformation qui serait enclenchée pour éviter qu'elle se reproduise, choisir le groupe Global et cocher la case à gauche de la ligne de la transformation "xhtmlCleaner" qui a été créée au chapitre précédent. Sauvegarder puis 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>
Il est possible maintenant de changer la CSS utilisée en remplaçant le nom du fichier utilisé dans l'en-tête (<head>) par exemple une des propositions disponible sur le serveur de media:
<link rel="stylesheet" type="text/css" href="http://mediaserv.climatetmeteo.fr/css/eric/docbook.css"/>
Pour être totalement compatible avec la version la plus stricte on peut rajouter sous la première ligne une ligne contenant simplement :
<!DOCTYPE html>
Vous pouvez maintenant sauvegarder les fichier xhtml et les déposer en ligne dans la collection db/data-xhtml/acces à l'intérieur d'un répertoire portant le nom de votre livre. Ces fichiers se placent à coté du fichier issu de la transformation xhtmlCleaner.