Le fonctionnement de base est simple :
xsltproc -o fichier_de_sortie feuille_de_style_XSL document_docbook
La seule difficulté est donc d'identifier la feuille de style XSL à utiliser. Si vous en avez envie vous pouvez écrire la vôtre (hors de propos dans le contenu de ce cours !).
Il en existe cependant quelques unes sur votre système que vous pouvez utiliser directement :
/usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl pour obtenir un seul grand document.
/usr/share/sgml/docbook/xsl-stylesheets/html/chunk.xsl pour que le document final soit découpé suivant les chapitres ou sections.
Le résultat est correct, mais manque un peu de fioritures. Vous pouvez y apporter votre grain de sel en utilisant plutôt une feuille de style intermédiaire dans laquelle vous personnaliserez certaines choses.
En voici un exemple :
<?xml version="1.0" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<!-- la feuille de style à utiliser -->
<xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets/html/chunk.xsl"/>
<!-- pour utiliser une feuille de style CSS dans le HTML produit -->
<xsl:param name="html.stylesheet" select="'monstyle.css'"/>
<!-- utiliser une "favicon" dans vos pages -->
<xsl:template name="user.head.content">
<link rel="shortcut icon" href="ma_favicon.ico" type="image/ico" />
</xsl:template>
</xsl:stylesheet>