03 janvier 2005
Les DTD : 4. DocBook
Pour commencer l'année, voici la suite de la saga des DTD... L'épisode du jour aborde DocBook, né
en 1992 à la suite d'un projet commun de HaL Computer Systems et
l'éditeur O'Reilly visant à faciliter l'échange de documentation UNIX.
En guise de définition, je vous propose un extrait de l'introduction du DocBook Install mini-HOWTO de Robert B. Easter (version française sur traduc.org) :
DocBook est une DTD destinée à la rédaction de livres et d'articles qui «définit un ensemble de balises pour des documents littéraux, et qui fonctionne comme le langage HTML utilisé habituellement sur le Web. (…) Lors de son traitement, un
unique fichier SGML DocBook peut produire des fichiers HTML, PDF, PS,
TXT ou d'autres formats de publication papier ou électronique. Le traitement est régi par des feuilles de style qui
peuvent générer automatiquement une table des matières, la numérotation
des pages, la numérotation des chapitres et des sections, et bien
d'autres possibilités.»
A l'instar de la TEI, DocBook sert à baliser des textes narratifs, mais on l'utilise surtout pour produire de la documentation technique dans les domaines de l'informatique, des télécommunications et des technologies de l'information qu'il vise. Comme il permet de séparer le contenu du document de sa présentation et qu'il s'agit d'un format libre et largement documenté, il garantit des documents pérennes. Il est particulièrement adapté au travail partagé de plusieurs auteurs ainsi qu'aux collections importantes de documents devant être mises à jour ou réorganisées fréquemment.
DocBook comporte près de 400 éléments répartis en 2 catégories :
- hiérarchie : éléments structurels
- information : éléments qui contiennent les données elles-mêmes (contenu)
Ses 3 éléments de départ sont :
- Set : il s'agit de l'élément de plus haut niveau (collection, recueil de livres....)
- Book : élément de départ le plus commun pour un document DocBook. Il est constitué :
- d'un titre (Title), sous-titre (Subtitle) et titre abrégé (TitleAbbrev), optionnels,
- de métainformations (BookInfo) optionnelles
- et d'un nombre quelconque, dans un ordre quelconque, d'éléments comme préface, chapitre, annexes... qui peuvent contenir des sections contenant elles-mêmes des paragraphes, des listes, des figures, des exemples, etc. - Article : constitué d'une introduction (avec des éléments titre, des métainformations..), du corps de l'article et d'une conclusion.
Pour des exemples de documents produits avec DocBook voir :
- "Utilisation simplifiée de DocBook", document réalisé dans le cadre des projets autour des logiciels libres au Ministère de l'éducation nationale.
- La feuille de style XSLT OOo2sDbk qui permet de convertir les documents OpenOffice-Writer au format Docbook simplifié.
Références et ressources :
- Site "officiel" DocBook
- Site de Norman Walsh, animateur du DocBook Technical Committee
- Le Wiki DocBook propose une liste de tutoriels en plusieurs langues dont le français
- Manuel DocBook en français et en anglais
- DocBook, la quatrième dimension de la documentation technique par Camille Bégnis (pdf, 2002)
Les épisodes précédents : introduction, EAD, TEI. Les épisodes à venir : BiblioML, conclusion
Commentaires
Poster un commentaire
Rétroliens
URL pour faire un rétrolien vers ce message :
http://www.canalblog.com/cf/fe/tb/?bid=16814&pid=238285
Liens vers des weblogs qui référencent ce message :