DocBook

Un article de Wikipédia, l'encyclopédie libre.

DocBook est un langage de balisage conçu à l'origine pour la documentation technique informatique (matériel et logiciel). C'est à l'origine une Définition de type de document (DTD) SGML développée par l'éditeur O'Reilly pour les besoins de l'édition technique (et plus particulièrement informatique). Elle a été portée depuis sous forme de schéma XML et de règle Relax NG pour la dernière version 5.0.

Actuellement maintenu et standardisé par le DocBook Technical Comittee du consortium OASIS, DocBook XML peut être utilisé pour tout type de documentation technique (rapports, normes, documentation, etc.).

La grande force de DocBook est d'être à la fois un format SGML et, depuis quelques années, un format XML totalement orienté sémantique, il n'inclut en effet aucune information de mise en forme ce qui permet d'utiliser ensuite la documentation ainsi structurée par tout type de support / lecteur. Un ensemble de feuille de styles XSLT est disponible pour transformer des documents DocBook vers de nombreux formats comme HTML, PDF, RTF, Javadoc, etc.

DocBook est en train de s'imposer comme le format standard pour la documentation logicielle (notamment dans la communauté Open Source) et commence à être utilisé dans l'industrie. La normalisation par l'OASIS devrait d'ailleurs le rendre de plus en plus prisé.

[modifier] Un format séparant le contenu de la présentation

Contrairement à des formats de traitement de texte, tel l'OpenDocument, le format DocBook ne contient strictement que le contenu du document, présenté de façon hiérarchisée.

DocBook n'est pas directement un format de document fini mais a plutôt pour but de produire des documents, dans les formats souhaités.

Il n'est ainsi pas possible, dans la version de base, de spécifier des couleurs de texte ou une mise en forme complexe et spécifique à certaines partie du texte. Toutefois, il est possible de créer son propre schéma XML basé sur DocBook et étendant ses capacités pour répondre à ce type de besoins.

[modifier] Exemple de code

<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>

[modifier] Articles connexes

• Darwin Information Typing Architecture

[modifier] Liens externes

• site officiel (en anglais)
• DocBook : Definitive Guide Le livre(en anglais)
• Créer des documents docBook simplifiés avec openoffice
• OOo2Dbk Utiliser OpenOffice.org pour générer de la documentation au format DocBook
• dbmanual Manuel DocBook, classant les éléments par famille
• Vex plugin Plugin graphique DocBook pour Eclipse (environnement de programmation)
• XML&DocBook Une courte introduction au XML par la DTD DocBook
• HOWTO DocBook-Install-mini-HOWTO (en francais)