DocBook

Qu'est-ce que c'est ?

  • Un format de fichier adapté à la réalisation de documentation.

  • Un format de fichier s'appuyant sur la syntaxe XML.

  • Un format de fichier qui peut être converti vers différents formats (pour l'instant je n'ai essayé que vers le HTML).

Qu'est-ce que ça n'est pas ?

  • Un outil qui va rédiger la documentation à ta place.

  • Un outil WYSIWIG

Comment ça marche ?

Une introduction ici : http://www.pipouyou.net/articles/docbook/ecrire

Avec les bonnes raisons d'utiliser docbook ici : http://www.pipouyou.net/articles/docbook/pourquoi

Le site officiel complétera ces présentations. Une version en-ligne du guide DocBook est notamment disponible avec la référence complète des éléments disponibles en DocBook.

Exemples

Le guide de l'administrateur CPS (XML|HTML) est un exemple de ce qu'il est possible de réaliser avec la version standard de DocBook XML.

Une extension permettant de réaliser des présentations est également disponible, j'en parle un peu plus dans .

Ce site (XML | HTML) est également réalisé à l'aide d'une extension de docbook : docbook-website.