DocBook est un schéma XML utilisé pour créer toutes sortes de documentation. Son premier objectif était axé sur la documentation technique mais dans la mesure où son format est extrêmement riche avec une panoplie complète de balises sémantiques correspondant à tous types de livres, il peut désormais être utilisé pour écrire d'autres livres tels que les essais ou les romans par exemple.
DocBook prétends qu'il est utilisable "out of the box". A l'entendre, il semble vraiment facile à appréhender. Nous sommes heureux de constater qu'il est effectivement facile à prendre en main. Il suffit, très rapidement, de manipuler quelques balises pour mettre en place la structure de votre prochain livre : un book (livre) se divise en chapters (chapîtres) et chaque chapter (chapitre) est constitué de plusieurs paragraphes... Si vous prévoyez d'utiliser (et vous le ferez) la libraire (ou package) de feuilles de style DocBook XSL correspondante, vous n'aurez même pas à vous soucier de la numérotation des chapîtres ou de la mise en place d'un sommaire. Toutes ces options vont se générer au moment de la publication. Cependant, dès qu'il s'agit d'aborder des fonctionnalités plus pointues, il vous faudra lire la documentation plus attentivement : cela inclut le Guide Définitive de DocBook (DocBook Definitive Guide), le Guide Complet des feuilles de styles DocBook XSL (DocBook XSL Stylesheets Complete Guide) et le Manuel de Références des feuilles de styles DocBook XSL (DocBook XSL Stylesheets Reference Documentation).
L'objectif de ce tutoriel sera de créer un manuel en ligne pour une API. Nous incluerons quelques options sympathiques pour personnaliser le rendu de notre livre.