Méthode & Technologies

Un standard ouvert pour le codage de l'information technique

DocBook

DocBook est une DTD standard largement utilisée pour produire de la documentation technique dans les domaines de l'informatique, des télécommunications et des technologies de l'information.

DocBook est un codage de l'information particulièrement bien adapté au travail partagé entre plusieurs auteurs, et aux collections de documents importantes qui doivent être fréquemment mises à jour, réorganisées ou réutilisées.

un standard reconnu

IBM Linux Technology Center, Sun Microsystems, MandrakeSoft, Jaluna, Linux Documentation Project, Free BSD, GNOME, PHP, KDE, sont parmi de nombreux autres utilisateurs de DocBook.

La DTD DocBook qui existe en deux versions SGML et XML, est l'oeuvre du consortium OASIS[1], responsable de son évolution depuis 1998. La DTD DocBook se présente comme la liste des éléments de contenu que l'auteur d'un document peut utiliser, avec les balises normalisées qui leur sont associées, et les relations qui existent entre les différents éléments.

En tant que grammaire XML pour décrire des documents techniques de différents types (ouvrages, articles, pages web, diapositives, etc.), DocBook XML hérite de la pérennité, de la reconnaissance et de l'ouverture du méta-langage XML normalisé par le W3C[2]. Mais je vous rassure, il est heureusement inutile de connaitre la spécification XML, pour écrire des documents en DocBook XML.

pérenne et portable

Le comité technique DocBook est animé par Norman Walsh de Sun Microsystems, qui a également mis à la disposition de tous un système de feuilles de style XSL permettant de transformer les documents codés avec DocBook XML dans différents formats de présentation tels que HTML, PDF, XHTML.

DocBook XML sera le composant de base de votre système de production de documentation, associé à des feuilles de style XSL, et à des processeurs XSLT capables de générer les différents formats de document que vous souhaitez obtenir.


[1] OASIS : Organization for the Advancement of Structured Information Standards

[2] W3C : World Wide Web Consortium