Pourquoi avoir besoin de docbook

pourquoi avoir besoin de docbook?

Le format DocBook a été conçu par le consortium OASIS spécifiquement pour la documentation technique. Il offre un ensemble riche de balises permettant de décrire le contenu de votre document.
Voici quelques points clés qui aident à comprendre ce qu'est DocBook :

• DocBook est un langage de balisage
  À cet égard, il ressemble beaucoup à HTML. Les balises structurent votre document et se mêlent au texte informatif.
  Cette particularité en fait une révolution du point de vue de la traduction documentaire, car la phase de PAO (mise en forme visuelle du texte) est réalisée une fois pour toutes, de manière indirecte, par le balisage du texte d'origine. Les traducteurs n'ont plus qu'à traduire « entre les balises » et, d'une simple frappe, la sortie traduite est générée.
• Conçu pour la documentation technique
  DocBook convient parfaitement à la documentation de pièces de moteur automobile. Il est toutefois fortement orienté vers la documentation des programmes informatiques.
• Techniquement, DocBook est une DTD SGML ou XML
  Cela signifie qu'il est possible de tirer parti des nombreux outils compatibles SGML et XML. Bien que DocBook en tant qu'implémentation XML soit assez récent, il a une longue histoire en tant qu'implémentation SGML.
• DocBook n'est pas un langage de présentation
  DocBook veille soigneusement à ne pas spécifier l'apparence finale de la documentation. Cela permet au rédacteur de se concentrer sur l'organisation et le sens du document qu'il rédige. Toutes les questions de présentation sont déléguées à des feuilles de style.
  Cela garantit une apparence cohérente à tous vos documents, quel que soit le rédacteur technique.
• DocBook est personnalisable
  Grâce à son organisation modulaire, il est assez facile de personnaliser la DTD pour répondre à ses besoins. Il faut toutefois veiller à le faire dans le respect des conventions SGML/XML, car cela peut introduire des incompatibilités.
  Associé aux feuilles de style modulaires de Norman Walsh, DocBook permet également de personnaliser la manière dont un fichier DocBook est imprimé ou mis en ligne.
• DocBook est complet
  Le grand nombre de balises définies dans DocBook garantit qu'il peut s'adapter à un large éventail de situations et d'attentes de traitement.
  Cela rend son apprentissage un peu plus difficile, mais on peut rédiger de la documentation en ne connaissant qu'un ensemble limité de balises et en se référant à la documentation de référence en cas de besoin.

Comments