Docbook ?
C’est un langage composé de balises (comme le HTML) qui est spécialisé dans la création de documentation.

Il est assez difficile d’appréhender DocBook, car c’est un projet assez ancien et assez complexe (tant les sous-projets et les manières de l’utiliser sont nombreuses).

Les technologies ont beaucoup évoluées, et DocBook s’est mis à niveau. Il existe des outils historiques ainsi que de nouvelles possibilités.

J’ai le sentiment que DocBook est plutôt utilisé par des techniciens et est assez difficile à mettre en place au début, lorsque l’on connaît mal les technologies et les utilitaires employés.

Cet article regroupe différents liens que j’ai choisi de conserver :

A lire pour commencer :

Je n’ai pas trouvé le bon article de référence. C’est soit trop long, trop technique, trop complet pour commencer… Mais on arrive tout de même à se faire une idée.

• (FR) DocBook – Format XML de document technique
• (FR) Comprendre DocBook (Guide pratique)
• (FR) Écrire de la documentation en utilisant DocBook
• (FR) DocBook sur Wikipédia

Ressources officielles :

• (EN) La page Sourceforge du projet DocBook (avec la page de télécharement)
• (EN) La documentation officielle

Feuille de style CSS pour fichier XML DocBook :

Les navigateurs récents savent afficher des fichiers XML et utiliser une feuille de style CSS associée (en savoir plus dans le guide du W3C : Associer les feuilles de style avec les documents XML)
Il existe donc des feuilles de styles CSS toutes prêtes pour afficher un DocBook de manière stylée :

• (EN) CSS for HTML/XHTML : une liste de ressources CSS
• (EN) DocBook Cascading Stylesheet (CSS2) : une feuille de style

Autre listes de ressources :

Je ne suis pas le seul à avoir créé des listes de liens à propos de DocBook, en voici d’autres :

• (FR) Le format Docbook : une présentation de DocBook par traduc.org.
• (EN) The DocBook Project : une page consacrée à la présentation des projets principaux.