Docbook est une DTD (Document Type Definition) pour des cocument XML qui définit des éléments qui forment la structure d'un document (au format SGML ou XML). C'est en quelque sorte la grammaire du document source. Elle est associée à des feuilles de styles (de type DSSSL ou XSL) qui vont vous permettre de publier votre document sur le web (HTML, XHTML) ou en faire une documentation imprimable (PS, PDF, RTF, ...) à partir de votre unique document source.

Le principal avantage du format Dockook est qu'il permet de séparer le contenu du document (le fond) de la forme (la présentation). Le format en question étant libre et largement documenté, il assure une très bonne pérénité à vos documents.

Les outils qui permettent de transformer le document source, sont assez génériques et peuvent fonctionner sous quasiment toutes les plateformes. Certains d'entre eux sont en Java et sont donc exploitables sur n'importe quelle architecture ayant une JVM.

Docbook est le successeur de LinuxDoc.

Pour ceux qui connaisent un peu (ou beaucoup) HTML, on retrouve le principe des balises (tags). La principale différence c'est que les balises ne définissent que des éléments de structure du document (chapter, sect1, sect2, etc ...) et pas de mise en forme (font, b, etc ...) Une balise d'un document SGML ou XML est de cette forme :

<balise param1="valeur param1" param2="valeur param2">texte contenu dans la balise</balise>

C'est assez simple, il suffit juste de connaître les principales balises. Docbook n'est en fait qu'une définition de toutes ces balises, de la façon dont on peut les imbriquer et de feuilles de style pour avoir de sorties HTML, RTF, .... Si vous avez besoin par la suite d'utiliser d'autres balises, ou d'avoir une documentation plus complète de chaque balise, je vous renvoie à la documentation de Docbook qui sera bien plus complète .

Ces deux languages très proches l'un de l'autre, parce que XML est en fait un descendant de SGML.

Il existe quelques petites différences entre les deux (XML est sensible à la casse par exemple), mais de part la variété des outils de traitement pour le XML de nos jours, on préférera utiliser ce dernier.

Le plus dur avec Docbook, c'est de commencer : il faut trouver les outils nécessaires, regarder comment ils s'emboîtent, trouver la bonne entête pour le document et la bonne ligne de commande (ouf!). Ce document essayes de vous y aider.

Après, c'est à peine plus difficile que du HTML, mais surtout beaucoup plus efficace. Les utilisateurs sont aussi souvent surpris de la qualité du rendu final et ce, quelque soit le format de sortie choisi.