Publié par Jérémie Bresson dans les docs Jmini (http://docs.jmini.fr) à l’adresse (http://docs.jmini.fr/listes-de-liens/liens-docbook).
Dernière mise à jour : Mardi 21 octobre 2008
Liens DocBook
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.
Fonctionnement :
A partir d’un fichier Texte source (qui sépare complètement le contenu de la forme), il est possible de générer des documents au format PDF, mais aussi des sites au format HTML, ou encore des fichiers texte au format OpenOffice, RTF, Javadoc…Pour simplifier on peut considérer que le fichier source est au format XML (dans la réalité, les fichiers sources sont également compatible avec d’autres syntaxes)
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.
Voir aussi
Les mots-clés de cet article : docbook
Cet article est dans la catégorie : Listes de liens