Quelques acronymes :
SGML — Langage normalisé de balisage généralisé (Standard Generalized Markup Language)
XML — Langage de balisage extensible (Extensible Markup Language)
RTF — Format de texte avec enrichissements (Rich Text Format)
HTML — Langage de balisage hypertexte (HyperText Markup Language)
PDF — Format de document portable (Portable Document Format)
L'objectif de ce document est de configurer OpenJade pour convertir des documents DocBook 3.2 et 4.2 SGML et XML vers les formats HTML, RTF et PDF.
Le texte ci-dessous est la version française de la licence de ce document. Seule la version originale de cette licence, présentée dans la section suivante, fait foi.
Copyright © 2001, Saqib Ali.
Copyright © 2003, Guillaume Audirac, Encolpe Degoute et Jean-Philippe Guérard pour la version française.
La version originale de ce document a été réalisée par Saqib Ali en 2001.
Vous avez le droit de copier, distribuer et modifier la version originale de ce document selon les termes de la licence de documentation libre GNU (GFDL) version 1.1 ou ultérieures, telle que publiée par la Free Software Fondation (FSF); sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture. Une copie de la licence est disponible à http://www.gnu.org/copyleft/fdl.html.
La version française de ce document a été réalisée par Guillaume Audirac et Encolpe Degoute. La version française de ce guide pratique est publiée en accord avec les termes de la licence de documentation libre GNU (GFDL); sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture. Une copie de la licence est disponible à http://www.gnu.org/copyleft/fdl.html.
Une version française non-officielle de cette licence est disponible à http://cesarx.free.fr/gfdlf.html.
Le texte ci-dessous est la licence de ce document. Ce texte fait foi. Il est composé de la licence en anglais du document original, suivi de la licence en français de sa traduction.
Copyright © 2001, Saqib Ali.
Copyright © 2003, Guillaume Audirac, Encolpe Degoute et Jean-Philippe Guérard pour la version française.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is available at http://www.gnu.org/copyleft/fdl.html.
La version française de ce document a été réalisée par Guillaume Audirac et Encolpe Degoute. La version française de ce guide pratique est publiée en accord avec les termes de la licence de documentation libre GNU (GFDL); sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture. Une copie de la licence est disponible à http://www.gnu.org/copyleft/fdl.html.
Toute la gloire revient à Allah, le Maître des Mondes. Tout le mérite revient à Allah. La moindre erreur dans ce document est de ma propre faute.
De plus, j'aimerais remercier les personnes suivantes pour leurs précieuses contributions à ce document :
Eric Safern <esafern CHEZ lrn POINT com> pour les mises à jour concernant Cocoon et le JRE. http://www.timebytes.com/.
Greg Ferguson <gferg CHEZ hoop POINT timonium POINT sgi POINT com> pour ses judicieuses suggestions et astuces sur la liste de diffusion de DocBook.
Kristin Thomas <kristint CHEZ us POINT ibm POINT com> pour la relecture initiale de la version originale de ce document.
Luc de Louw <luc CHEZ delouw POINT ch> pour avoir suggérer la partie sur HTMLDOC (PDF → HTML).
Lloyd D. Budd <ldp CHEZ foolswisdom POINT org> pour ses propositions d'amélioration de la plupart des parties de ce document.
Andrew Shugg <andrew CHEZ neep POINT com POINT au> pour la correction des erreurs de la version 2.0 de ce document. Neep Consulting.
DocBook, c'est une définition de type de document (Document Type Definition ou DTD). DocBook décrit les types de structures et de formats à employer dans les documents techniques. Il est couramment utilisé du fait de sa simplicité et de son exhaustivité.
Une DTD définit la syntaxe d'un document — c'est principalement un livre de règles qui décrit un ensemble de balises et d'attributs, qui seront utilisés pour décrire des types spécifiques de contenus. Ainsi, DocBook est un livre de règles utilisé pour écrire des documents. Chaque balise utilisée dans la rédaction du document, doit être définie spécifiquement et formellement dans la DTD.
C'est un langage de symboles et de spécifications de style de document (Document Style Semantics and Specification Language ou DSSSL). Il définit comment convertir un format SGML (ou XML) vers un format affichable et lisible par l'être humain, comme HTML, RTF et PDF.
Voici les outils nécessaires à la configuration d'OpenJade pour convertir le SGML et le XML :
OpenJade
Les DTD DocBook
Les entités ISO
Le DSSSL de Norman Walsh
Le DSL du TLDP
HTMLDOC (optionnel)
Le XSL de Norman Walsh (optionnel)
Le XSL du TLDP (optionnel)
Tous ces paquets sont libres et disponibles en téléchargement sur Internet. Le chapitre suivant explique comment les télécharger.
Ce document considère que ce qui suit est déjà installé sur votre système :
gzip — disponible à http://www.gnu.org/directory/.
gcc et GNU make — disponible à http://www.gnu.org/directory/.
unzip — disponible à http://www.info-zip.org/pub/infozip/.
Les utilitaires Unix classiques — tar, mkdir, mv …