1. Introduction

Quelques acronymes :

  1. SGML — Langage normalisé de balisage généralisé (Standard Generalized Markup Language)

  2. XML — Langage de balisage extensible (Extensible Markup Language)

  3. RTF — Format de texte avec enrichissements (Rich Text Format)

  4. HTML — Langage de balisage hypertexte (HyperText Markup Language)

  5. 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.

1.1. Droits d'utilisation

[Note]Note

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.

1.2. Copyright et licence

[Note]Note

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.

1.3. Remerciements

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 :

  1. Eric Safern pour les mises à jour concernant Cocoon et le JRE. http://www.timebytes.com/.

  2. Greg Ferguson pour ses judicieuses suggestions et astuces sur la liste de diffusion de DocBook.

  3. Kristin Thomas pour la relecture initiale de la version originale de ce document.

  4. Luc de Louw pour avoir suggérer la partie sur HTMLDOC (PDF → HTML).

  5. Lloyd D. Budd pour ses propositions d'amélioration de la plupart des parties de ce document.

  6. Andrew Shugg pour la correction des erreurs de la version 2.0 de ce document. Neep Consulting.

1.4. Qu'est-ce que DocBook ?

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.

1.5. Qu'est ce qu'un DSSSL ?

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.

1.6. De quoi avons-nous besoin ?

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)

[Note]Note

Tous ces paquets sont libres et disponibles en téléchargement sur Internet. Le chapitre suivant explique comment les télécharger.

1.7. Conditions

Ce document considère que ce qui suit est déjà installé sur votre système :