Les explication sur le format
DocBook sont simplifiées à l'extrême.
Qu'est-ce que c'est
DocBook est un langage XML destiné à produire de la documentation technique. Ce langage se concentre sur la structure du texte non sur sa présentation, ce qui fait qu'à partir d'un seul document au format
DocBook, on génére la documentation dans plusieurs format (html, PDF, htmlhelp, PS...).
Il fait maintenant référence dans le domaine informatique. C'est le format utilisé par le projet
Linux Documentation Project, pour la documentation du projet
KDE, du projet
GNOME, et plus généralement dans le monde des logiciels libres.
Fonctionnement
Pour pouvoir produire un document au format souhaité, il suffit d'appliquer une transformation au document
DocBook grâce à un moteur de transformation XSLT et une feuille de style apdaptée au format voulue. Une feuille de style (StyleSheet) est un document XML au format XSL.
Un jeu "standard" de feuilles de style est maintenu sur le site
http://docbook.sourceforge.net.
Pour pouvoir produire un document dans un format "paginé" (PDF, PS, etc...), il faut passer par un format intermédiaire appelé FO (Formatting Objects). Ce dernier format est obtenu à l'aide du moteur de transformation XSLT et celui-ci est traité par un moteur FO pour pouvoir produire le format "paginé" voulu (PDF, PS, ...). Voir les schémas
ici.
Outils
Il existe plusieurs moteurs de transformation XSLT sous forme de logiciels libres. Les plus pertinents pour la transformation de document
DocBook sont:
Les feuilles de style XSL sont disponibles
ici (docbook-xsl-1.xx.xx.[tar.gz|zip])
Il existe également plusieurs moteurs FO:
Utilisation
Installer xsltproc (par
urpmi libxslt-proc pour linux et consulter
http://www.zlatkovic.com/libxml.en.html pour win32)
Installer le jeu de stylesheets (décompresser d'archive). (ou par
urpmi docbook-style-xsl ?)
Installer Fop pour produire du PDF
Ligne de commande pour produire du html:
xsltproc docbook-xsl-1.xx.xx/html/docbook.xsl document.xml > document.html
Pour produire du PDF, il faut passer par un format intermédiaire FO:
xsltproc docbook-xsl-1.xx.xx/fo/docbook.xsl document.xml > document.fo
puis:
fop -fo document.fo -pdf document.pdf
ou alors utiliser db2pdf (à installer par
urpmi docbook-utils-pdf)
Liens
