DocBook

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

Plusieurs logiciels permettent d'enregistrer et d'ouvrir des fichiers écrits dans ce format : OpenOffice (depuis la version 3.0), XML Copy Editor

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.

Exemple de code

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>

Voir aussi

Articles connexes

• Darwin Information Typing Architecture
• Text Encoding Initiative
• Jaxe

Liens externes

• (en) Site officiel de documentation
• (en) Page d'accueil du projet sur sourceforge (dépôt des fichiers)
• (en) Site relatif à la normalisation de DocBook
• Article sur DocBook sur le wiki du LORIA