<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
  "http://www.docbook.org/xml/4.3/docbookx.dtd">

<article lang="fr">
  <articleinfo>

    <title>Conversion de documents DocBook XML/SGML avec OpenJade</title>
    <subtitle>Version française de <foreignphrase>DocBook XML/SGML Processing Using OpenJade</foreignphrase></subtitle>

    <authorgroup>
    <author>
      <firstname>Saqib</firstname>
      <surname>Ali</surname>
      <affiliation>
        <address><email>saqib CHEZ seagate POINT com</email></address>
      </affiliation>
    </author>
    </authorgroup>

    <othercredit role="traduction" class="translator">
      <firstname>Guillaume</firstname>
      <surname>Audirac</surname>
      <affiliation>
        <address><email>guillaume POINT audirac CHEZ gmail POINT fr</email></address>
      </affiliation>
      <contrib>Traduction française</contrib>
      <email>guillaume POINT audirac CHEZ gmail POINT fr</email>
    </othercredit>

    <othercredit role="relecture" class="translator">
      <firstname>Encolpe</firstname>
      <surname>Degoute</surname>
      <affiliation>
        <address><email>encolpe CHEZ colpi POINT info</email></address>
      </affiliation>
      <contrib>Relecture de la version française</contrib>
      <email>encolpe CHEZ colpi POINT info</email>
    </othercredit>

   <othercredit role="publication" class="copyeditor">
     <firstname>Jean-Philippe</firstname>
     <surname>Guérard</surname>
     <affiliation>
       <address><email>jean TIRET philippe POINT guerard CHEZ corbeaunoir POINT org</email></address>
     </affiliation>
     <contrib>Préparation de la publication de la v.f.</contrib>
     <email>jean TIRET philippe POINT guerard CHEZ corbeaunoir POINT org</email>
   </othercredit>

    <pubdate>2006-05-10</pubdate>
    <releaseinfo>Version&nbsp;: 2.2.8.fr.1.1</releaseinfo>

    <revhistory>
      <revision>
        <revnumber>2.2.8.fr.1.1</revnumber>
        <date>2006-05-10</date>
        <authorinitials>JPG</authorinitials>
        <revremark>
            Mise à jour de l'adresse électronique de Guillaume Audirac.
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.8.fr.1.0</revnumber>
        <date>2003-08-29</date>
        <authorinitials>GA, ED, JPG</authorinitials>
        <revremark>
            Traduction de la version 2.2.8 de <emphasis>DocBook 
            XML/SGML Processing Using OpenJade</emphasis>. Ajout du 
            point 4 à la section «&nbsp;Installation du DSL du 
            TLDP&nbsp;».
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.8</revnumber>
        <date>2003-07-16</date>
        <authorinitials>ES</authorinitials>
        <revremark>
            Ajout d'information sur la mise à jour des JRE pour 
            Cocoon.
            (<emphasis>Added info about keeping JREs up-to-date 
            for Cocoon</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.7</revnumber>
        <date>2003-07-09</date>
        <authorinitials>ES</authorinitials>
        <revremark>
            Restitution du lien rompu et d'autres fichiers spécifiques 
            sur le XSL du TLDP.
            (<emphasis>Fixed broken links to LDP XSL and other LDP 
            XSL specific filenames.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.6</revnumber>
        <date>2003-06-16</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Vérification de l'instruction sur DocBook XSL 1.57.
            (<emphasis>Verified the instruction against docbook XSL 
            1.57.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.5</revnumber>
        <date>2003-05-16</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Restitution des liens rompus dans la partie Informations 
            supplémentaires.
            (<emphasis>Fixed the broken links in the external 
            resources section.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.4</revnumber>
        <date>2003-04-20</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Mise à jour des liens vers le nouveau site de démonstration. Ajout de 
            nouveaux liens dans la partie Informations supplémentaires.
            (<emphasis>Updated links to the new Demo Site. Added 
            new links to the resources section.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.3</revnumber>
        <date>2002-11-22</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Ajout de suggestions d'utilisateurs. Ajout de nouveaux liens 
            dans la partie Informations supplémentaires.
            (<emphasis>Added the suggestion made by users. Added 
            new links to the resources section.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.2</revnumber>
        <date>2002-10-09</date>
        <authorinitials>AS</authorinitials>
        <revremark>
            Cette mise à jour corrige quelques autres erreurs 
            typographiques, supprime quelques espaces qui défiguraient 
            le rendu HTML.
            (<emphasis>This update fixes a few more typos, removes 
            a couple of spaces that make the HTML rendering look 
            odd.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2.1</revnumber>
        <date>2002-10-09</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Correction de l'adresse URL vers le fichier d'exemples.
            (<emphasis>Fixed the URL to the Sample 
            Files.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.2</revnumber>
        <date>2002-09-29</date>
        <authorinitials>AS</authorinitials>
        <revremark>
            Corrections mineures dans la partie sur Cocoon.
            (<emphasis>Minor corrections to the Cocoon 
            section.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.1</revnumber>
        <date>2002-09-15</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Corrections mineures dans la partie sur Cocoon.
            (<emphasis>Minor corrections to the Cocoon 
            section.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>2.0</revnumber>
        <date>2002-09-10</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Ajout de la partie sur la mise à disposition de contenus 
            DocBook XML 4.1.2 à l'aide de Tomcat + Cocoon.
            (<emphasis>Added the section on serving DocBook XML 
            4.1.2 content using Tomcat + Cocoon.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>1.5</revnumber>
        <date>2002-08-11</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Ajout de la partie sur XML et du fichier d'exemples XML.
            (<emphasis>Added the XML section and the sample XML 
            file.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>1.4</revnumber>
        <date>2002-08-08</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Nombreuses et précieuses modifications et corrections 
            suggérées par Lloyd D. Budd. Merci Lloyd :)
            (<emphasis>Many valuable modifications/corrections 
            suggested by Lloyd D. Budd. Thanks Lloyd. 
            :)</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>1.3</revnumber>
        <date>2002-08-02</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Ajout de la partie Informations supplémentaires.
            (<emphasis>Added the "Additional Resources" 
            section.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>1.2</revnumber>
        <date>2002-07-23</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Ajout de la partie sur la conversion HTML -&gt; PDF en
            utilisant HTMLDOC. Merci à Luc de Louw pour cette
            suggestion.
            (<emphasis>Added the section on converting HTML -&gt; 
            PDF using HTMLDOC. Thanks to Luc De Louw for the 
            suggestion.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>1.1</revnumber>
        <date>2002-07-19</date>
        <authorinitials>KET</authorinitials>
        <revremark>
            Correction de fautes grammaticales et d'énumérations.
            (<emphasis>Fixed grammatical errors, numbered 
            processes.</emphasis>)
        </revremark>
      </revision>
      <revision>
        <revnumber>1.0</revnumber>
        <date>2002-06-29</date>
        <authorinitials>SA</authorinitials>
        <revremark>
            Version publique initiale.
            (<emphasis>Initial public release.</emphasis>)
        </revremark>
      </revision>
    </revhistory>
    <abstract>
      <para>
      Ce guide pratique (<foreignphrase>howto</foreignphrase>) vous
      explique comment configurer OpenJade pour transformer des
      documents XML et SGML.
      </para>
    </abstract>
  </articleinfo>

  <sect1 id="intro">
    <title>Introduction</title>
    <para>Quelques acronymes&nbsp;:</para>
    <orderedlist>
      <listitem>
        <para>
          SGML &mdash; Langage normalisé de balisage généralisé 
          (<foreignphrase>Standard Generalized Markup 
          Language</foreignphrase>)
        </para>
      </listitem>
      <listitem>
        <para>
          XML &mdash; Langage de balisage
          extensible (<foreignphrase>Extensible Markup
          Language</foreignphrase>)
        </para>
      </listitem>
      <listitem>
        <para>
          RTF &mdash; Format de texte avec enrichissements 
          (<foreignphrase>Rich Text Format</foreignphrase>)
        </para>
      </listitem>
      <listitem>
        <para>
          HTML &mdash; Langage de balisage hypertexte 
          (<foreignphrase>HyperText Markup 
          Language</foreignphrase>)
        </para>
      </listitem>
      <listitem>
        <para>
          PDF &mdash; Format de document portable 
          (<foreignphrase>Portable Document Format</foreignphrase>)
        </para>
      </listitem>
    </orderedlist>
    <para>
      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.
    </para>
    <sect2 id="droits">
      <title>Droits d'utilisation</title>
      <note>
        <para>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.</para>
      </note>

      <para>Copyright &copy; 2001, Saqib Ali.</para>
      <para>Copyright &copy; 2003, Guillaume Audirac, Encolpe Degoute et
      Jean-Philippe Guérard pour la version française.</para>

      <para>La version originale de ce document a été réalisée par Saqib Ali en 2001.</para>
      <para>Vous avez le droit de copier, distribuer et modifier la version originale de ce document selon les termes de la <ulink url="http://www.gnu.org/copyleft/fdl.html">licence de documentation libre GNU (GFDL)</ulink> version 1.1 ou ultérieures, telle que publiée par la <foreignphrase>Free Software Fondation (FSF)</foreignphrase>; sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture. Une copie de la licence est disponible à <ulink url="http://www.gnu.org/copyleft/fdl.html"/>.</para>
    <para>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 <ulink url="http://www.gnu.org/copyleft/fdl.html">licence de documentation libre GNU (GFDL)</ulink>; sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture. Une copie de la licence est disponible à <ulink url="http://www.gnu.org/copyleft/fdl.html"/>.</para>
    <para>Une version française non-officielle de cette licence est disponible à <ulink url="http://cesarx.free.fr/gfdlf.html"/>.</para>
    </sect2>
    <sect2 id="copyright">
      <title>Copyright et licence</title>
      <note>
        <para>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.</para>
      </note>

      <para>Copyright &copy; 2001, Saqib Ali.</para>
      <para>Copyright &copy; 2003, Guillaume Audirac, Encolpe Degoute et
      Jean-Philippe Guérard pour la version française.</para>
      
      <para><foreignphrase>Permission is granted to copy, distribute and/or modify this document under the terms of the <ulink url="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</ulink>, 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 <ulink url="http://www.gnu.org/copyleft/fdl.html"/>.</foreignphrase></para>
    <para>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 <ulink url="http://www.gnu.org/copyleft/fdl.html">licence de documentation libre GNU (GFDL)</ulink>; sans section invariante, sans texte de première de couverture ni texte de quatrième de couverture. Une copie de la licence est disponible à <ulink url="http://www.gnu.org/copyleft/fdl.html"/>.</para>
    </sect2>
    <sect2>
      <title>Remerciements</title>
      <para>Toute la gloire revient à <emphasis role="strong">Allah</emphasis>, <emphasis role="strong">le Maître des Mondes</emphasis>. Tout le mérite revient à <emphasis role="strong">Allah</emphasis>. La moindre erreur dans ce document est de ma propre faute.</para>
      <para>De plus, j'aimerais remercier les personnes suivantes pour leurs précieuses contributions à ce document&nbsp;:</para>
      <orderedlist>
        <listitem>
          <para>
            Eric Safern
            <email>esafern CHEZ lrn POINT com</email>
            pour les mises à jour concernant Cocoon et le JRE.
            <ulink url="http://www.timebytes.com/"/>.
          </para>
        </listitem>
        <listitem>
          <para>
            Greg Ferguson
            <email>gferg CHEZ hoop POINT timonium POINT sgi POINT com</email>
            pour ses judicieuses suggestions et astuces sur la liste de
            diffusion de DocBook.
          </para>
        </listitem>
        <listitem>
          <para>
            Kristin Thomas
            <email>kristint CHEZ us POINT ibm POINT com</email>
            pour la relecture initiale de la version originale de ce 
            document.
          </para>
        </listitem>
        <listitem>
          <para>
            Luc de Louw
            <email>luc CHEZ delouw POINT ch</email>
            pour avoir suggérer la partie sur HTMLDOC (PDF &rarr; HTML).
          </para>
        </listitem>
        <listitem>
          <para>
            Lloyd D. Budd
            <email>ldp CHEZ foolswisdom POINT org</email>
            pour ses propositions d'amélioration de la plupart des
            parties de ce document.
          </para>
        </listitem>
        <listitem>
          <para>
            Andrew Shugg
            <email>andrew CHEZ neep POINT com POINT au</email>
            pour la correction des erreurs de la version 2.0 de ce
            document.
            <ulink url="http://www.neep.com.au/">Neep Consulting</ulink>.
          </para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Qu'est-ce que DocBook&nbsp;?</title>
      <para>DocBook, c'est une définition de type de document (<foreignphrase>Document Type Definition</foreignphrase> 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é. </para>
      <para>Une DTD définit la syntaxe d'un document &mdash; c'est principalement un <emphasis>livre de règles</emphasis> 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 <emphasis>livre de règles</emphasis> 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. </para>
    </sect2>
    <sect2>
      <title>Qu'est ce qu'un DSSSL&nbsp;?</title>
      <para>C'est un langage de symboles et de spécifications de style de document (<foreignphrase>Document Style Semantics and Specification Language</foreignphrase> 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.</para>
    </sect2>
    <sect2>
      <title>De quoi avons-nous besoin&nbsp;?</title>
      <para>Voici les outils nécessaires à la configuration d'OpenJade pour convertir le SGML et le XML&nbsp;:</para>
      <itemizedlist>
        <listitem>
          <para>OpenJade</para>
        </listitem>
        <listitem>
          <para>Les DTD DocBook</para>
        </listitem>
        <listitem>
          <para>Les entités ISO</para>
        </listitem>
        <listitem>
          <para>Le DSSSL de Norman Walsh</para>
        </listitem>
        <listitem>
          <para>Le DSL du TLDP</para>
        </listitem>
        <listitem>
          <para>HTMLDOC (optionnel)</para>
        </listitem>
        <listitem>
          <para>Le XSL de Norman Walsh (optionnel)</para>
        </listitem>
        <listitem>
          <para>Le XSL du TLDP (optionnel)</para>
        </listitem>
      </itemizedlist>
      <note>
        <title>Note</title>
        <para>Tous ces paquets sont libres et disponibles en téléchargement sur Internet. Le chapitre suivant explique comment les télécharger.</para>
      </note>
    </sect2>
    <sect2>
      <title>Conditions</title>
      <para>Ce document considère que ce qui suit est déjà installé sur votre système&nbsp;:</para>
      <itemizedlist>
        <listitem>
          <para>gzip &mdash; disponible à <ulink url="http://www.gnu.org/directory/"/>.</para>
        </listitem>
        <listitem>
          <para>gcc et GNU make &mdash; disponible à <ulink url="http://www.gnu.org/directory/"/>.</para>
        </listitem>
        <listitem>
          <para>unzip &mdash; disponible à <ulink url="http://www.info-zip.org/pub/infozip/"/>.</para>
        </listitem>
        <listitem>
          <para>Les utilitaires Unix classiques &mdash; tar, mkdir, mv &hellip;</para>
        </listitem>
      </itemizedlist>
    </sect2>
  </sect1>
  <sect1 id="requirements">
    <title>Les indispensables</title>
    <para>Vous devrez télécharger et compiler un seul paquet (OpenJade). Ce guide pratique expliquera l'étape de compilation, mais il serait préférable que vous soyez familier des installations de code source.</para>
    <para>La plupart des paquets nécessaires sont situés sur le site Internet du projet de documentation Linux (<foreignphrase><ulink url="http://www.tldp.org/authors/index.html#resources">The Linux Documentation Project ou TLDP)</ulink></foreignphrase>.</para>
    <sect2>
      <title>Préalable</title>
      <para>Créez un dossier <filename class="directory">/tmp/downloads</filename>. Nous l'utiliserons pour stocker les codes sources téléchargés. </para>
    </sect2>
    <sect2>
      <title>OpenJade</title>
      <para>OpenJade sera utilisé pour traiter les documents DocBook. OpenJade peut être téléchargé à <ulink url="http://openjade.sourceforge.net/"/>.</para>
      <para>Lors de la rédaction de ce document, OpenJade version 1.3.1 était disponible. Téléchargez le fichier openjade-1.3.x.tar.gz.</para>
    </sect2>
    <sect2>
      <title>Les DTD DocBook</title>
      <para>Toutes les DTD DocBook sont disponibles sur le site Internet de <foreignphrase>The Linux Documentation Project</foreignphrase> à <ulink url="http://www.tldp.org/authors/index.html#resources"/>.</para>
      <para>Veuillez télécharger <ulink url="http://www.tldp.org/authors/tools/docbk41.zip">DocBook SGML v4.1</ulink>, <ulink url="http://www.tldp.org/authors/tools/docbk31.zip">DocBook SGML v3.1</ulink>, et <ulink url="http://www.tldp.org/authors/tools/docbkx412.zip">DocBook XML v4.1.2</ulink>. </para>
      <note>
        <title>Note</title>
        <para>Veuillez télécharger toutes les archives au format compressé zip.</para>
      </note>
    </sect2>
    <sect2>
      <title>Les entités ISO</title>
      <para>Le projet de documentation Linux (<foreignphrase><ulink url="http://www.tldp.org">The Linux Documentation Project</ulink></foreignphrase>) a empaqueté toutes les entités en un seul et gros fichier <emphasis>tar</emphasis>, et l'a placé à <ulink url="http://www.tldp.org/authors/tools/entities.tar.gz"/> pour le confort des utilisateurs. Remercions le TLDP pour ça.</para>
    </sect2>
    <sect2>
      <title>Le DSSSL de Norman Walsh</title>
      <para>Le DSSSL de Norman Walsh peut être téléchargé sur le site Internet du projet DocBook à <ulink url="http://sourceforge.net/project/showfiles.php?group_id=21935"/>.</para>
      <para>Lors de la rédaction de ce document, <filename>docbook-dsssl-1.76</filename> était disponible.</para>
    </sect2>
    <sect2>
      <title>Feuilles de style DSL personnalisées par le TLDP</title>
      <para>Le DSL du TLDP est une feuille de style personnalisée et utilisée par <foreignphrase><ulink url="http://www.tldp.org">The Linux Documentation Project (TLDP)</ulink></foreignphrase>. C'est une prolongation du DSSSL de Norman Walsh. Il y ajoute plusieurs choses comme un arrière-plan ou une table des matières. Il peut être téléchargé à <ulink url="http://www.tldp.org/authors/tools/ldp.dsl"/>.</para>
      <para>Le fichier <filename>ldp.dsl</filename> nécessite le DSSSL de Norman Walsh.</para>
    </sect2>
    <sect2>
      <title>HTMLDOC (optionnel)</title>
      <para>HTMLDOC peut être utilisé pour convertir le HTML en PDF. Si vous souhaitez créer des documents PDF, téléchargez HTMLDOC à <ulink url="http://www.easysw.com/htmldoc/software.php"/>.</para>
    </sect2>
    <sect2>
      <title>Le XSL de Norman Walsh (optionnel)</title>
      <para>Ceci n'est pas indispensable. Mais si vous désirez reconnaître des contenus DocBook 4.1.2 XML en utilisant Tomcat + Cocoon, vous aurez besoin des feuilles de style XML de Norman Walsh.</para>
      <para>Les feuilles de style sont téléchargeables à <ulink url="http://sourceforge.net/projects/docbook/"/>.</para>
      <para>Téléchargez le paquet nommé <filename>docbook-xsl</filename>.</para>
      <note>
        <title>Note</title>
        <para>Récemment, <filename>docbook-xsl</filename> version 1.57.0 
        a été rendu publique. Ce document est valide avec la dernière 
        version, et des changements adéquats ont été effectués. Si vous 
        rencontrez encore des erreurs, merci de m'écrire à l'adresse 
        <email>saqib CHEZ seagate POINT com</email></para>
      </note>
    </sect2>
    <sect2>
      <title>Le XSL personnalisé du TLDP (optionnel)</title>
      <para>Téléchargez également le XSL personnalisé du TLDP à <ulink url="http://my.core.com/~dhorton/docbook/tldp-xsl/"/>.</para>
    </sect2>
  </sect1>
  <sect1 id="inst-openjade">
    <title>Installation des outils de conversion &mdash; OpenJade</title>
    <para>Dans cette section, nous installerons tous les outils dans les dossiers appropriés. Tous vont dans <filename class="directory">/usr/local/dbtools/</filename>. Créez ce dossier à l'aide de la commande suivante&nbsp;:</para>
<screen>
<command># mkdir /usr/local/dbtools</command>
</screen>
    <sect2>
      <title>Installation d'OpenJade</title>
      <para>Cette procédure est la partie la plus facile, mais aussi la plus longue. Gardez à l'esprit que la compilation d'OpenJade demande du temps. Pour installer OpenJade, réalisez les opérations suivantes&nbsp;:</para>
      <orderedlist>
        <listitem>
          <para>Positionnez-vous dans le dossier <filename class="directory">/tmp/downloads</filename>.</para>
<screen>
<prompt># </prompt><command>cd /tmp/downloads</command>
</screen>
        </listitem>
        <listitem>
          <para>Décompressez le fichier.</para>
<screen>
<prompt># </prompt><command>gzip -d openjade-1.3.x.tar.gz</command>
</screen>
        </listitem>
        <listitem>
          <para>Dépaquetez le fichier.</para>
<screen>
<prompt># </prompt><command>tar -xvf openjade-1.3.x.tar</command>
</screen>
        </listitem>
        <listitem>
          <para>Déplacez-vous dans le dossier <filename class="directory">openjade-1.3</filename></para>
<screen>
<prompt># </prompt><command>cd openjade-1.3.x</command>
</screen>
        </listitem>
        <listitem>
          <para>Exécutez la commande <command>./configure</command>.</para>
<screen>
<prompt># </prompt><command>./configure --prefix=/usr/local/dbtools/openjade</command>
</screen>
        </listitem>
        <listitem>
          <para>Exécutez la commande <command>make</command>.</para>
<screen>
<prompt># </prompt><command>make</command>
</screen>
        </listitem>
        <listitem>
          <para>Exécutez la commande <command>make install</command>. Dès maintenant, les fichiers binaires d'OpenJade seront installés sous <filename class="directory">/usr/local/dbtools/openjade</filename>.</para>
<screen>
<prompt># </prompt><command>make install</command>
</screen>
        </listitem>
        <listitem>
          <para>Copiez le dossier <filename class="directory">dsssl</filename> de <filename class="directory">/tmp/downloads/openjade-1.3.x</filename> vers <filename class="directory">/usr/local/dbtools/openjade</filename>.</para>
<screen>
<prompt># </prompt><command>cp -dpR dsssl /usr/local/dbtools/openjade/</command>
</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installation du DSSSL de Norman Walsh</title>
      <para>Durant cette étape, nous installerons le DSSSL de Norman Walsh dans un endroit approprié. Le DSSSL n'a pas besoin d'être compilé.</para>
      <orderedlist>
        <listitem>
          <para>Positionnez-vous dans le dossier <filename class="directory">/tmp/downloads</filename>.</para>
<screen>
<command><prompt># </prompt>cd /tmp/downloads</command>
</screen>
        </listitem>
        <listitem>
          <para>Décompressez le fichier.</para>
<screen>
<command><prompt># </prompt>gzip -d docbook-dsssl-1.76.tar.gz</command>
</screen>
        </listitem>
        <listitem>
          <para>Dépaquetez le fichier.</para>
<screen>
<command><prompt># </prompt>tar -xvf docbook-dsssl-1.76.tar</command>
</screen>
        </listitem>
        <listitem>
          <para>Déplacez-vous dans le dossier <filename class="directory">/usr/local/dbtools/docbook-dsssl</filename>.</para>
<screen>
<command><prompt># </prompt>mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl</command>
</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installation des DTD DocBook</title>
      <para>Dans cette section, nous installerons les DTD DocBook.</para>
      <orderedlist>
        <listitem>
          <para>Positionnez-vous dans le dossier <filename class="directory">/usr/local/dbtools</filename>.</para>
<screen>
<command><prompt># </prompt>cd /usr/local/dbtools</command>
</screen>
        </listitem>
        <listitem>
          <para>Créez trois nouveaux dossiers, nommés <filename class="directory">dtd3.1</filename>, <filename class="directory">dtd4.1</filename>, et <filename class="directory">dtd4.1.2</filename>.</para>
<screen>
<command><prompt># </prompt>mkdir dtd3.1</command>
<command><prompt># </prompt>mkdir dtd4.1</command>
<command><prompt># </prompt>mkdir dtd4.1.2</command>
</screen>
        </listitem>
        <listitem>
          <para>Déplacez-vous dans le dossier <filename class="directory">dtd3.1</filename>.</para>
<screen>
<command><prompt># </prompt>cd dtd3.1</command>
</screen>
        </listitem>
        <listitem>
          <para>Décompressez le fichier DocBook SGML v3.1 dans ce dossier.</para>
<screen>
<command><prompt># </prompt>unzip /tmp/downloads/docbk31.zip</command>
</screen>
        </listitem>
        <listitem>
          <para>Déplacez-vous dans le dossier <filename class="directory">dtd4.1</filename>.</para>
<screen>
<command><prompt># </prompt>cd ../dtd4.1</command>
</screen>
        </listitem>
        <listitem>
          <para>Décompressez le fichier DocBook SGML v4.1 dans ce dossier.</para>
<screen>
<command><prompt># </prompt>unzip /tmp/downloads/docbk41.zip</command>
</screen>
        </listitem>
        <listitem>
          <para>Déplacez-vous dans le dossier <filename class="directory">dtd4.1.2</filename>.</para>
<screen>
<command><prompt># </prompt>cd ../dtd4.1.2</command>
</screen>
        </listitem>
        <listitem>
          <para>Décompressez le fichier DocBook XML v4.1.2 dans ce dossier.</para>
<screen>
<command><prompt># </prompt>unzip /tmp/downloads/docbk412.zip</command>
</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installation des entités ISO</title>
      <para>Dans cette section, nous installerons les entités ISO que nous avons téléchargées sur le site Internet du TLDP.</para>
      <para>Tout d'abord, nous installons les entités ISO pour la DTD 3.1 SGML.</para>
      <orderedlist>
        <listitem>
          <para>Positionnez-vous dans le dossier <filename class="directory">/usr/local/dbtools/dtd3.1</filename>.</para>
<screen>
<command><prompt># </prompt>cd /usr/local/dbtools/dtd3.1</command>
</screen>
        </listitem>
        <listitem>
          <para>Copiez ici le fichier <filename>/tmp/download/entities.tar.gz</filename>.</para>
<screen>
<command><prompt># </prompt>cp /tmp/download/entities.tar.gz .</command>
</screen>
        </listitem>
        <listitem>
          <para>Décompressez le fichier.</para>
<screen>
<command><prompt># </prompt>gzip -d entities.tar.gz</command>
</screen>
        </listitem>
        <listitem>
          <para>Dépaquetez le fichier.</para>
<screen>
<command><prompt># </prompt>tar -xvf entities.tar</command>
</screen>
        </listitem>
      </orderedlist>
      <para>Ensuite, nous installons les entités ISO pour la DTD 4.1 SGML.</para>
      <orderedlist>
        <listitem>
          <para>Positionnez-vous dans le dossier <filename class="directory">/usr/local/dbtools/dtd4.1</filename>.</para>
<screen>
<command><prompt># </prompt>cd /usr/local/dbtools/dtd4.1</command>
</screen>
        </listitem>
        <listitem>
          <para>Copiez ici le fichier <filename>/tmp/download/entities.tar.gz</filename>.</para>
<screen>
<command><prompt># </prompt>cp /tmp/download/entities.tar.gz .</command>
</screen>
        </listitem>
        <listitem>
          <para>Décompressez le fichier.</para>
<screen>
<command><prompt># </prompt>gzip -d entities.tar.gz</command>
</screen>
        </listitem>
        <listitem>
          <para>Dépaquetez le fichier.</para>
<screen>
<command><prompt># </prompt>tar -xvf entities.tar</command>
</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="installation-ldpdsl">
      <title>Installation du DSL du TLDP</title>
      <para>Enfin, nous installons la feuille de style personnalisée du TLDP.</para>
      <orderedlist>
        <listitem>
          <para>Positionnez-vous dans le dossier <filename class="directory">/tmp/download</filename>.</para>
<screen>
<command><prompt># </prompt>cd /tmp/download</command>
</screen>
        </listitem>
        <listitem>
          <para>Copiez le fichier <filename>ldp.dsl</filename> à l'emplacement <filename class="directory">/usr/local/dbtools/docbook-dsssl/print</filename>.</para>
<screen>
<command><prompt># </prompt>cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print</command>
</screen>
        </listitem>
        <listitem>
          <para>Copiez le fichier <filename>ldp.dsl</filename> à l'emplacement <filename class="directory">/usr/local/dbtools/docbook-dsssl/html</filename>.</para>
<screen>
<command><prompt># </prompt>cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html</command>
</screen>
        </listitem>
        <listitem id="adaptation-ldpdsl">
          <para>Le contenu du fichier <filename>ldp.dsl</filename> doit être modifié pour refléter le chemin absolu du fichier <filename>docbook.dsl</filename>. Voici la zone originale du fichier qui doit être adaptée&nbsp;:</para>
<screen>
&lt;![%html;[
&lt;!ENTITY % print "IGNORE"&gt;
&lt;!ENTITY docbook.dsl PUBLIC
         "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN"
         CDATA dsssl&gt;
]]&gt;
&lt;!ENTITY % print "INCLUDE"&gt;
&lt;![%print;[
&lt;!ENTITY docbook.dsl PUBLIC
         "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN"
         CDATA dsssl&gt;
]]&gt;     
</screen>
          <para>Éditez le fichier <filename>ldp.dsl</filename> situé à l'emplacement <filename class="directory">/usr/local/dbtools/docbook-dsssl/print</filename> avec un éditeur de texte.</para>
<screen>
<command><prompt># </prompt>emacs /usr/local/dbtools/docbook-dsssl/print/ldp.dsl</command>
</screen>
          <para>Modifiez le contenu du fichier comme suit&nbsp;:</para>
<screen>
&lt;![%html;[
&lt;!ENTITY % print "IGNORE"&gt;
&lt;!ENTITY docbook.dsl SYSTEM
         "/usr/local/dbtools/docbook-dsssl/print/docbook.dsl"
         CDATA dsssl&gt;
]]&gt;
&lt;!ENTITY % print "INCLUDE"&gt;
&lt;![%print;[
&lt;!ENTITY docbook.dsl SYSTEM
         "/usr/local/dbtools/docbook-dsssl/print/docbook.dsl"
         CDATA dsssl&gt;
]]&gt;
</screen>
          <para>Éditez le fichier <filename>ldp.dsl</filename> situé à l'emplacement <filename class="directory">/usr/local/dbtools/docbook-dsssl/html</filename> avec un éditeur de texte.</para>
<screen>
<command><prompt># </prompt>emacs /usr/local/dbtools/docbook-dsssl/html/ldp.dsl</command>
</screen>
          <para>Modifiez le contenu du fichier comme suit&nbsp;:</para>
<screen>
&lt;![%html;[
&lt;!ENTITY % print "IGNORE"&gt;
&lt;!ENTITY docbook.dsl SYSTEM
         "/usr/local/dbtools/docbook-dsssl/html/docbook.dsl"
         CDATA dsssl&gt;
]]&gt;
&lt;!ENTITY % print "INCLUDE"&gt;
&lt;![%print;[
&lt;!ENTITY docbook.dsl SYSTEM
         "/usr/local/dbtools/docbook-dsssl/html/docbook.dsl"
         CDATA dsssl&gt;
]]&gt;
</screen>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Installation de HTMLDOC</title>
      <para>Cette étape est facultative. Elle est utile seulement si vous désirez créer des documents PDF à partir de HTML.</para>
      <para>Retournez dans le dossier des téléchargements.</para>
<screen>
<command><prompt># </prompt>cd /tmp/download</command>
</screen>
      <para>Décompressez et dépaquetez le code source de HTMLDOC.</para>
<screen>
<command><prompt># </prompt>gzip -d htmldoc-1.8.xx-source.tar.gz</command>
<command><prompt># </prompt>tar -xvf htmldoc-1.8.xx-source.tar</command>
<command><prompt># </prompt>cd htmldoc-1.8.xx-1</command>
</screen>
      <para>Exécutez <command>configure</command> pour définir le chemin d'installation.</para>
<screen>
<command><prompt># </prompt>./configure --prefix=/usr/local/dbtools/htmldoc</command>
<command><prompt># </prompt>make</command>
</screen>
      <para>Lors de la rédaction de ce document, HTMLDOC version 1.8.20-1 était disponible. Cette version connaît un problème de fontes dans le fichier <filename>Makefile</filename>. Il devrait se plaindre à l'installation des fontes, parce qu'elles ne sont pas disponibles sur le système.</para>
      <para>Voici l'erreur obtenue lorsque vous exécuterez <command>make install</command>&nbsp;:</para>
<screen>
<command><prompt># </prompt>make install</command>
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
/bin/cp: cannot stat `ZapfChancery.afm': No such file or directory
/bin/cp: cannot stat `ZapfChancery.pfa': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.afm': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.pfa': No such file or directory
make[1]: *** [install] Error 1
</screen>
      <para>Pour corriger ce problème d'installation, éditez le fichier <filename>fonts/Makefile</filename> et mettez en commentaires les lignes référencées aux fontes <emphasis>ZapfChancery</emphasis> et <emphasis>ZapfDingbats</emphasis>.</para>
      <para>Ensuite, exécutez l'installation&nbsp;:</para>
<screen>
<command><prompt># </prompt>make install</command>
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
Installing in data...
Installing in doc...
Installing in htmldoc...
</screen>
    </sect2>
  </sect1>
  <sect1>
    <title>Utilisation d'OpenJade</title>
    <para>Dans cette section, nous utiliserons OpenJade pour convertir des documents DocBook SGML/XML en HTML, RTF, et PDF.</para>
    <sect2>
      <title>Traitement du SGML</title>
      <sect3>
        <title>Définition de la variable environnementale <varname>SGML_CATALOG_FILES</varname> pour le SGML</title>
        <para>La variable <varname>SGML_CATALOG_FILES</varname> doit être définie pour pointer sur les fichiers <filename>catalog</filename> appropriés. Pour définir la variable, utilisez la commande suivante pour le Bourne shell&nbsp;:</para>
<screen>
<command><prompt># </prompt>export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:\
<prompt>&gt; </prompt>/usr/local/dbtools/dtd3.1/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
        <para>Pour le C shell, utilisez cette commande&nbsp;:</para>
<screen>
<command><prompt># </prompt>setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog</command>
<command><prompt># </prompt>setenv SGML_CATALOG_FILES "$SGML_CATALOG_FILES":/usr/local/dbtools/dtd3.1/docbook.cat</command>
<command><prompt># </prompt>setenv SGML_CATALOG_FILES "$SGML_CATALOG_FILES":/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
      </sect3>
      <sect3>
        <title>SGML vers HTML</title>
        <para>Pour convertir du SGML en HTML, utilisez la commande suivante&nbsp;:</para>
<screen>
<command><prompt># </prompt>/usr/local/dbtools/openjade/bin/openjade -t sgml \
<prompt>&gt; </prompt>-d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html \
<prompt>&gt; </prompt>DocBook-OpenJade-SGML-XML-HOWTO.sgml</command>
</screen>
        <para>Pour créer un document d'une pièce (tout dans un seul fichier)&nbsp;:</para>
<screen>
<command><prompt># </prompt>/usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml \
<prompt>&gt; </prompt>-d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html \
<prompt>&gt; </prompt>DocBook-OpenJade-SGML-XML-HOWTO.sgml</command>
</screen>
      </sect3>
      <sect3>
        <title>SGML vers RTF</title>
        <para>Pour convertir du SGML en RTF, utilisez la commande suivante&nbsp;:</para>
<screen>
<command><prompt># </prompt>/usr/local/dbtools/openjade/bin/openjade -t rtf \
<prompt>&gt; </prompt>-d /usr/local/dbtools/docbook-dsssl/print/ldp.dsl#print \
<prompt>&gt; </prompt>DocBook-OpenJade-SGML-XML-HOWTO.sgml </command>
</screen>
      </sect3>
    </sect2>
    <sect2>
      <title>Traitement du XML</title>
      <para>Vous pouvez télécharger un exemple de fichier DocBook 4.1.2 XML à <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml">http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml</ulink></para>
      <sect3>
        <title>Définition de la variable environnementale <varname>SGML_CATALOG_FILES</varname> pour le XML</title>
        <para>La variable <varname>SGML_CATALOG_FILES</varname> doit être définie pour pointer sur les fichiers <filename>catalog</filename> appropriés. Pour définir la variable, utilisez la commande suivante pour le Bourne shell&nbsp;:</para>
<screen>
<command><prompt># </prompt>export SGML_CATALOG_FILES=/usr/local/dbtools/openjade/dsssl/catalog:\
<prompt>&gt; </prompt>/usr/local/dbtools/dtd4.1.2/docbook.cat:/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
        <para>Pour le C shell, utilisez cette commande&nbsp;:</para>
<screen>
<command><prompt># </prompt>setenv SGML_CATALOG_FILES /usr/local/dbtools/openjade/dsssl/catalog</command>
<command><prompt># </prompt>setenv SGML_CATALOG_FILES "$SGML_CATALOG_FILES":/usr/local/dbtools/dtd4.1.2/docbook.cat</command>
<command><prompt># </prompt>setenv SGML_CATALOG_FILES "$SGML_CATALOG_FILES":/usr/local/dbtools/docbook-dsssl/catalog</command>
</screen>
      </sect3>
      <sect3>
        <title>XML vers HTML</title>
        <para>Pour convertir du XML en HTML, utilisez la commande suivante&nbsp;:</para>
<screen>
<command><prompt># </prompt>/usr/local/dbtools/openjade/bin/openjade -t xml \
<prompt>&gt; </prompt>-d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html\
<prompt>&gt; </prompt>/usr/local/dbtools/docbook-dsssl/dtds/decls/xml.dcl \
<prompt>&gt; </prompt>DocBook-OpenJade-SGML-XML-HOWTO.xml</command>
</screen>
      </sect3>
      <sect3>
        <title>XML vers RTF</title>
        <para>Pour convertir du XML en RTF, utilisez la commande suivante&nbsp;:</para>
<screen>
<command><prompt># </prompt>/usr/local/dbtools/openjade/bin/openjade -t rtf \
<prompt>&gt; </prompt>-d /usr/local/dbtools/docbook-dsssl/print/ldp.dsl#print \
<prompt>&gt; </prompt>/usr/local/dbtools/docbook-dsssl/dtds/decls/xml.dcl \
<prompt>&gt; </prompt>DocBook-OpenJade-SGML-XML-HOWTO.xml</command>
</screen>
      </sect3>
    </sect2>
    <sect2>
      <title>HTML vers PDF (optionnel)</title>
      <para>Pour convertir du HTML en PDF, il faut utiliser HTMLDOC. Tout d'abord, créez un fichier HTML d'une pièce à partir du SGML&nbsp;:</para>
<screen>
<command><prompt># </prompt>/usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml \
<prompt>&gt; </prompt>-d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html \
<prompt>&gt; </prompt>DocBook-OpenJade-SGML-XML-HOWTO.sgml</command>
</screen>
      <para>Maintenant, exécutez HTMLDOC pour générer le PDF.</para>
<screen>
<command><prompt># </prompt>/usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html</command>
</screen>
    </sect2>
  </sect1>
  <sect1>
    <title>Publier DocBook 4.1.2 XML</title>
    <para>Il existe trois moyens de publier DocBook 4.1.2 XML sur un serveur Internet&nbsp;:</para>
    <itemizedlist>
      <listitem>
        <para>OpenJade en ligne de commande pré-interprétée (<foreignphrase>command line pre-processed OpenJade</foreignphrase>), XSLT</para>
      </listitem>
      <listitem>
        <para>Scripts &mdash; PHP, Perl, Python</para>
      </listitem>
      <listitem>
        <para>Serveur d'applications &mdash; Tomcat + Cocoon</para>
      </listitem>
    </itemizedlist>
    <para>La meilleure option est d'utiliser un serveur d'applications comme Cocoon.</para>
    <note>
      <title>Cocoon en action</title>
      <para>Pour visualiser un exemple de serveur Internet publiant des contenus DocBook 4.1.2 XML avec Tomcat + Cocoon, visitez <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/"/>.</para>
    </note>
    <para>Dans cette section, nous verrons comment publier un contenu DocBook 4.1.2 XML avec Tomcat + Cocoon.</para>
    <sect2>
      <title>Tomcat + Cocoon</title>
      <para>Tomcat est le contenant de mini-serveurs Java (<foreignphrase>Java Servlet Container</foreignphrase>). Pour plus d'informations, visitez <ulink url="http://jakarta.apache.org/tomcat/index.html"/>.</para>
      <para>Apache Cocoon est une structure de publication XML. Pour plus d'informations, visitez <ulink url="http://xml.apache.org/cocoon/index.html"/>.</para>
      <para>Ce guide pratique ne détaillera pas la configuration de Tomcat + Cocoon, puisque c'est déjà fait dans le document <ulink url="http://wiki.cocoondev.org/Wiki.jsp?page=CocoonCompetenceCenter"/>. Cette configuration est simple et ne prendra pas plus de cinq minutes.</para>
      <para>Une fois Cocoon + Tomcat configurés et opérationnels, poursuivez aux sections suivantes pour publier des contenus DocBook 4.1.2 XML.</para>
      <note><title>Avertissement important&nbsp;: </title><para>les spécialistes ont rencontré des problèmes de compatibilité avec les feuilles de styles DocBook et certaines versions de l'analyseur syntaxique XML, Xalan. En fait, Xalan est l'analyseur syntaxique fournit avec le JRE de Sun, c'est donc ce que vous utilisez par défaut.</para></note>
      <para><emphasis>En dernier lieu, assurez-vous d'utiliser la toute dernière version du JRE de Sun (1.4.2 à la rédaction de ce document).</emphasis></para>
      <para>De même, mettez à jour l'analyseur Xalan avec sa dernière version. Pour ma part, la dernière version 1.4.2 du JRE de Sun est fournie avec Xalan 2.4.1, alors que Xalan lui-même est déjà parvenu à la version 2.5.1.</para>
      <para>Pour savoir quelle est la version installée actuellement&nbsp;:</para>

<screen><command># java org.apache.xalan.xslt.EnvironmentCheck</command></screen>

      <para>Pour plus d'informations, visitez <ulink url="http://xml.apache.org/xalan-j/faq.html"/>.</para>
    </sect2>
    <sect2>
      <title>Installation du XSL de Norman Walsh</title>
      <para>Durant cette phase, nous installerons le XSL de Norman Walsh dans le dossier <filename class="directory">/usr/local/dbtools/</filename>.</para>
      <para>Positionnez-vous dans le dossier <filename class="directory">/tmp/downloads</filename>, puis décompressez et dépaquetez le fichier <filename>docbook-xsl</filename>.</para>
<screen>
<command><prompt># </prompt>cd /tmp/downloads/</command>
<command><prompt># </prompt>gzip -d docbook-xsl-1.53.0.tar.gz</command>
<command><prompt># </prompt>tar -xvf docbook-xsl-1.53.0.tar</command>
</screen>
      <para>Pour installer <filename>docbook-xsl</filename>, déplacez les fichiers dans <filename class="directory">/usr/local/dbtools</filename>.</para>
<screen>
<command><prompt># </prompt>mv docbook-xsl-1.53.0 /usr/local/dbtool/docbook-xsl</command>
</screen>
      <para>Ensuite, installez le XSL du TLDP.</para>
    </sect2>
    <sect2>
      <title>Installation du XSL du TLDP</title>
      <para>Décompressez et dépaquetez le fichier <filename>tldp-xsl-xxxxx.tar.gz</filename>, puis copiez tous les fichiers dans le dossier <filename class="directory">/usr/local/dbtools/docbook-xsl/html</filename>.</para>
<screen>
<command><prompt># </prompt>cd /tmp/downloads</command>
<command><prompt># </prompt>gzip tldp-xsl-xxxxx.tar.gz</command>
<command><prompt># </prompt>gzip tldp-xsl-xxxxx.tar</command>
<command><prompt># </prompt>mv tldp-html*.xsl /usr/local/dbtools/docbook-xsl/html</command>
</screen>
    </sect2>
    <sect2>
      <title>Configuration de <filename>sitemap.xmap</filename></title>
      <para><varname>$COCOON_HOME</varname> pointe vers le dossier d'applications Internet de Cocoon. Ce dossier s'appelle typiquement <filename class="directory">/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/</filename></para>
      <para>Créez un dossier nommé <filename class="directory">docbook</filename> dans <filename class="directory">$COCOON_HOME/mount</filename>. c'est là que nous mettrons tous nos contenus DocBook XML 4.1.2.</para>
<screen>
<command><prompt># </prompt>mkdir $COCOON_HOME/mount/docbook</command>
</screen>
      <para>Créez un fichier nommé <filename>sitemap.xmap</filename> dans <filename class="directory">$COCOON_HOME/mount/docbook</filename> avec le contenu suivant&nbsp;:</para>
<screen>
<command><prompt># </prompt>cd $COCOON_HOME/mount/docbook</command>
<command><prompt># </prompt>vi sitemap.xmap</command>
</screen>
<screen>
&lt;map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"&gt;

    &lt;!-- use the standard components --&gt;
    &lt;map:components&gt;
        &lt;map:generators default="file"/&gt;
        &lt;map:transformers default="xslt"/&gt;
        &lt;map:readers default="resource"/&gt;
        &lt;map:serializers default="html"/&gt;
        &lt;map:selectors default="browser"/&gt;
        &lt;map:matchers default="wildcard"/&gt;
        &lt;map:transformers default="xslt"/&gt;
    &lt;/map:components&gt;
      
    &lt;map:pipelines&gt;
        &lt;map:pipeline&gt;

   &lt;map:match pattern=""&gt;
    &lt;map:generate src="samples.xml"/&gt;
    &lt;map:transform
src="/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/mount/editor/stylesheets/simple-page2html.xsl"/&gt;
    &lt;map:serialize/&gt;
   &lt;/map:match&gt;

            &lt;!-- répond aux requêtes *.html avec 
                 nos documents traités par .xsl --&gt;
            &lt;map:match pattern="*.html"&gt;
                &lt;map:generate src="{1}.xml"/&gt;
                &lt;map:transform
                  src="/usr/local/dbtools/docbook-xsl/html/tldp-html.xsl"/&gt;
                &lt;map:serialize type="html"/&gt;
            &lt;/map:match&gt;
            
            &lt;!-- ensuite, répond aux requêtes *.pdf avec 
                 nos documents traités par doc2pdf.xsl --&gt;
            &lt;map:match pattern="*.pdf"&gt;
                &lt;map:generate src="{1}.xml"/&gt;
                &lt;map:transform
                  src="/usr/local/dbtools/docbook-xsl/fo/docbook.xsl"/&gt;
                &lt;map:serialize type="fo2pdf"/&gt;
            &lt;/map:match&gt;

            &lt;map:match pattern="*.xml"&gt;
                &lt;map:generate src="{1}.xml"/&gt;
                &lt;map:serialize type="xml"/&gt;
            &lt;/map:match&gt;


        &lt;/map:pipeline&gt;
    &lt;/map:pipelines&gt;
&lt;/map:sitemap&gt;
</screen>
    </sect2>
    <sect2>
      <title>Accès à un contenu DocBook 4.1.2 XML dans un navigateur Internet</title>
      <para>Placez un fichier DocBook 4.1.2 XML dans le dossier <filename class="directory">$COCOON_HOME/mount/docbook/</filename>.</para>
      <para>Un fichier d'exemple est disponible à <ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml"/>.</para>
      <para>Maintenant, vous pouvez accéder au document à l'aide d'un 
      navigateur à 
      «&nbsp;http://localhost:8080/cocoon/mount/sample.html&nbsp;» 
      (HTML) ou 
      «&nbsp;http://localhost:8080/cocoon/mount/sample.pdf&nbsp;» 
      (PDF).</para>
    </sect2>
  </sect1>
  <sect1>
    <title>Informations supplémentaires</title>
    <para>Cette section vous oriente vers des liens utiles sur l'Internet.</para>
    <para>Pour suggérer d'ajouter ici des ressources supplémentaires, 
    écrivez-moi à <email>saqib CHEZ seagate POINT com</email>. 
    Merci.</para>
    <sect2>
      <title>Groupes de nouvelles</title>
      <para>Voici quelques groupes de nouvelles dignes d'intérêt&nbsp;:</para>
      <orderedlist>
        <listitem>
          <para>comp.text.sgml (facilement accessible par <ulink url="http://groups.google.com/groups?group=comp.text.sgml">Google! Groups</ulink>)</para>
        </listitem>
        <listitem>
          <para>comp.text.xml (facilement accessible par <ulink url="http://groups.google.com/groups?group=comp.text.xml">Google! Groups</ulink>)</para>
        </listitem>
        <listitem>
          <para>htmldoc.general (serveur &mdash; <ulink url="http://news.easysw.com">news.easysw.com</ulink>)</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Listes de diffusion</title>
      <para>On trouve ici quelques listes de diffusion pertinentes.</para>
      <orderedlist>
        <listitem>
          <para>Liste de diffusion DocBook d'OASIS. Visitez <ulink 
          url="http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml"/> pour plus d'informations.</para>
        </listitem>
        <listitem>
          <para>Liste de diffusion DocBook du TLDP. Visitez <ulink 
          url="http://www.tldp.org/mailinfo.html"/> pour plus d'informations.</para>
        </listitem>
        <listitem>
          <para>xml-doc de Yahoo Groups. Visitez <ulink 
          url="http://groups.yahoo.com/group/xml-doc/"/> pour plus d'informations.</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>IRC</title>
      <orderedlist>
        <listitem>
          <para>Canal IRC DocBook en français&nbsp;: #docbook-fr sur <ulink url="irc://irc.freenode.net"/></para>
        </listitem>
        <listitem>
          <para>Canal IRC DocBook en anglais&nbsp;: #docbook sur <ulink url="irc://irc.freenode.net"/></para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Sites Internet</title>
      <orderedlist>
        <listitem>
          <para><ulink url="http://www.oasis-open.org/"/>, OASIS maintient un éventail de DTD DocBook</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.xml-dev.com/blog/"/>, XML / XHTML WebLog</para>
        </listitem>
        <listitem>
          <para><ulink url="http://docbook.org/wiki/moin.cgi/"/>, le Wiki DocBook</para>
        </listitem>
        <listitem>
          <para>
            <ulink url="http://www.docbook.org/tdg/en/"/>, version en 
            ligne (et en v.o.) du livre «&nbsp;DocBook&nbsp;: La 
            référence&nbsp;»
          </para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.bureau-cornavin.com/opensource/crash-course/index.html"/>, document sur la rédaction utilisant DocBook&nbsp;: <foreignphrase>A Crash Course</foreignphrase></para>
        </listitem>
        <listitem>
          <para><ulink url="http://www-106.ibm.com/developerworks/library/l-docbk.html"/>, un guide léger sur DocBook (excellente introduction)</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.tldp.org/LDP/LDP-Author-Guide/index.html"/>, guide d'auteur issu du projet de documentation Linux (TLDP)</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.tldp.org/authors/index.html#resources"/>, ressources DocBook fournies par le TLDP</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.traduc.org/docs/howto/lecture/DocBook-Demystification-HOWTO.html"/>, Guide pratique (<foreignphrase>HOWTO</foreignphrase>)&nbsp;: Démystification de DocBook de Eric Raymond</para>
        </listitem>
        <listitem>
          <para><ulink url="http://www.xml-dev.com:8080/cocoon/mount/docbook/"/>, site d'exemples de configuration de Tomcat + Cocoon + DocBook</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2>
      <title>Applications de rédaction et de modelage du XML</title>
      <note>
        <title>Note</title>
        <para>Une liste complète d'éditeurs XML se trouve à <ulink url="http://www.xml-dev.com/blog/#19"/></para>
      </note>
      <orderedlist>
        <listitem>
          <para>eXchaNGeR &mdash; Navigateur XML (et éditeur XML)&nbsp;: <ulink url="http://xngr.org/"/></para>
        </listitem>
        <listitem>
          <para>XERLIN &mdash; Application de modelage du XML&nbsp;: <ulink url="http://www.xerlin.org/"/></para>
        </listitem>
        <listitem>
          <para>DocPro par Command Prompt, INC&nbsp;: <ulink url="http://www.commandprompt.com/"/></para>
        </listitem>
        <listitem>
          <para>YAWC Pro par XML Workshop LTD&nbsp;: <ulink url="http://www.yawcpro.com/"/>. Peut être utilisé pour convertir des documents MS Word en simple DocBook XML.</para>
        </listitem>
        <listitem>
          <para>Logictran &mdash; Convertisseur RTF&nbsp;: <ulink url="http://www.logictran.com/"/>. Word/RTF vers HTML/XML.</para>
        </listitem>
        <listitem>
          <para>MajiX &mdash; Convertisseur Word vers XML&nbsp;: <ulink 
          url="http://www.tetrasix.com/"/></para>
        </listitem>
        <listitem>
          <para>XMETAL par SoftQuad&nbsp;: <ulink url="http://www.softquad.com/"/></para>
        </listitem>
        <listitem>
          <para>Éditeur non-balisé par i4i (DTD DocBook non-maintenues)&nbsp;: <ulink url="http://www.i4i.com/"/></para>
        </listitem>
        <listitem>
          <para>Éditeur XML par XMLmind&nbsp;: <ulink url="http://www.xmlmind.com/xmleditor/"/></para>
        </listitem>
        <listitem>
          <para>upCast et downCast par Inifinity Loop&nbsp;: <ulink url="http://www.infinity-loop.de/en/products.html"/></para>
        </listitem>
        <listitem>
          <para>W2XML par DocSoft&nbsp;: <ulink url="http://www.docsoft.com/w2xmlv2.htm"/></para>
        </listitem>
        <listitem>
          <para>XMLWrite par Wattle Software&nbsp;: <ulink url="http://xmlwriter.net/"/></para>
        </listitem>
        <listitem>
          <para>oXygen &mdash; Éditeur XML basé sur Java&nbsp;: <ulink url="http://www.oxygenxml.com/"/></para>
        </listitem>
        <listitem>
          <para>Xeena par IBM&nbsp;: <ulink url="http://www.alphaworks.ibm.com/tech/xeena"/></para>
        </listitem>
        <listitem>
          <para>Excosoft XML Client&nbsp;: <ulink url="http://www.excosoft.se/eweb/site/exc_pd.html"/></para>
        </listitem>
        <listitem>
          <para>Timelux Xpress&nbsp;: <ulink url="http://www.timelux.lu/html/Xpress2001.html"/></para>
        </listitem>
        <listitem>
          <para>Morphon&nbsp;: <ulink url="http://www.morphon.com/"/></para>
        </listitem>
        <listitem>
          <para>Conglomerate&nbsp;: <ulink url="http://conglomerate.org/"/></para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>
</article>