Traiter les fichier DocBook

Comme il a été dit en cours, un fichier DocBook est un document XML qui peut être transformé en une multitude de formats. En particulier, des outils et librairies existent pour le transformer en XHTML et en XSL-FO (format qui peut être traité en lisant la section suivante).

Pour manipuler un fichier DocBook, on a besoin des outils suivants :

Suivez les instructions:

Analysons le dossier docbook-xsl. Il contient une série de sous-dossiers, en particulier fo et xhtml. Dans ces deux dossiers, vous trouverez un fichier docbook.xsl et un fichier params.xsl. Le premier est la feuille de style à utiliser pour passer de DocBook à respectivement XSL-FO et XHTML et le deuxième est un fichier de paramètres, que vous pouvez modifier à votre guise pour modifier l'affichage des résultats.

Trève de bavardages.

Note : en ligne de commande, en principe les flèches ← et → permettent de se déplacer dans la ligne et les flèches ↑ et ↓ permettent de se déplacer dans l'historique des commandes.

Transformation de documents XSL-FO

Supposez que vous ayez un document XSL-FO, soit écrit par vous, soit produit par la méthode du dessus. Comme il a été dit en classe, il est la description d'un document imprimé, avec des marges, ... Il est donc possible de le transformer en PDF.

Pour ce faire, nous allons utiliser l'outil FOP du projet Apache. Une méthode simple pour le faire fonctionner est la suivante.

Note: FOP peut raler et produire des erreurs dites SEVERE. Vous pouvez en général les ignorer, elles ne gènent en rien la production du fichier de sortie.