DocBook

Auparavant, lorsque DocBook était un langage SGML, un fichier DocBook était converti dans un autre format grâce à une feuille de style DSSSL spécifiant comment transformer le fichier en un document au format lisible (PDF par exemple).

À l'époque de DocBook SGML, on utilisait les DocBook-tools, un groupe de packages gratuits, fonctionnant ensemble et permettant entre autres de former des documents finis à partir de fichiers DocBook.

Parmi les formats de publication (formats finaux, simplement lisibles par l'œil humain), les fichiers DocBook peuvent être convertis notamment en HTML, DVI (TeX), PDF, PostScript, RTF,...

Pour la création de documents DocBook, il était nécessaire d'avoir :

• le package sgml-common qui contient les outils et les ressources de base nécessaires à la production de document SGML (il sert à créer et à maintenir des catalogue SGML centralisés),
• le logiciel jade qui transforme les fichiers DocBook en formats de publication à partir des DTD et des DSSSL.
• le package jadetex qui contient les macros permettant de générer un fichier TeX intermédiaire qui sera transformé ensuite en un fichier final formaté.
• la DTD DocBook : docbook-dtdXX-sgml, qui contient la version XX de la DTD de DocBook,
• et docbook-style-dsssl où se trouve, comme son nom d'indique, les feuilles de styles DSSSL.

Étaient également nécessaires les packages perl-SGMLSpm et docbook-utils. Le premier est l'interface entre Perl et SGML. Le deuxième contient un ensemble des scripts simplifiant la manipulation de jade.

Aujourd'hui, DocBook respecte le standard XML, sa conversion vers un autre format se fait par l'intermédiaire de feuilles de style XSL, une conversion est réalisée vers XSL-FO dont le processeur va ensuite pouvoir convertir le fichier vers un format final.

Les documents finaux peuvent être au format HTML, PDF, PCL, PS, SVG…

Les packages à installer sont différents et moins nombreux que pour DocBook SGML :

• docbook-dtdXX-xml qui contient le schéma DTD de la version XX de DocBook ;
• docbook-style-xsl, où se trouvent les feuilles de styles XSL ;
• libxslt (qui a besoin de la bibliothèque XML libxml2), le moteur de transformation XSLT qui permet le passage vers un document lisible.

Un environnement Java est nécessaire pour FOP (Formatting Objects Processor), le processeur XSL-FO.

Exemple pour un article en Docbook version 4

<book id="exemple_de_livre">
   <title>Livre très simple</title>
   <chapter id="exemple_de_chapitre">
      <title>Chapitre très court</title>
      <para>Bonjour tout le monde !</para>
      <para>Ceci est un autre paragraphe...</para>
   </chapter>
</book>

Exemple pour un article en Docbook version 5

<?xml version="1.0" encoding="ISO-8859-15"?>
<article version="5.0" xml:lang="fr" xmlns="http://docbook.org/ns/docbook"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         xmlns:svg="http://www.w3.org/2000/svg"
         xmlns:m="http://www.w3.org/1998/Math/MathML"
         xmlns:html="http://www.w3.org/1999/xhtml"
         xmlns:db="http://docbook.org/ns/docbook">
  <info>
    <title>Titre de l'article</title>
    <author>
      <personname><surname>Moi Même</surname></personname>
    </author>
    <pubdate>2011</pubdate>
  </info>
<section xml:id="first_section"><title>Titre de la section</title>
<para>Bonjour tout le monde !</para>
<para>Autre paragraphe...</para>
</section>
</article>

Pour tout fichier DocBook, la structure générale du document est sensiblement la même.

L'élément racine, la balise <article> ou <book> englobe la totalité des éléments du document.

DocBook définit un livre comme étant un ensemble composé d'un bloc où sont inscrits les méta informations concernant celui-ci(<bookinfo>), d'une suite de chapitres (<chapter>), éventuellement d'une suite d'annexes(<appendix>) et/ou d'un glossaire.

Le bloc <bookinfo> contient des informations telles que le nom de (ou des) auteur(s), le titre du livre, ou encore la date de sa publication. Un chapitre est une suite de sections (<sect1>), elles-mêmes pouvant être divisées en un certain nombre de sous-sections, et ce récursivement (<sect2>,...).

Les chapitres et les sections comportent tous un titre (<title>) et au moins un paragraphe (<para>). À l'intérieur de ces paragraphes, on peut trouver du texte, des images, des listes, des tableaux,...

Les annexes ont la même structure que les chapitres.

Pour les articles, la structure est allégée, on retrouve le bloc méta-information (<info>) mais les balises <chapter> n'existent plus, on passe directement aux niveaux de sections (<sect1>, <sect2>,...). De même, il n'y a plus d'annexes, ni de glossaire.

• Darwin Information Typing Architecture
• Text Encoding Initiative
• Jaxe

• (en) Site officiel de documentation
• (en) DocBook Wiki
• (en) Page d'accueil du projet sur sourceforge (dépôt des fichiers)
• (en) Site relatif à la normalisation de DocBook
• (en) FOP, le moteur XSL-FO d'Apache