<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>5. Publier DocBook 4.1.2 XML</title><link href="style.css" rel="stylesheet" type="text/css"><meta content="DocBook XSL Stylesheets V1.69.1" name="generator"><link rel="start" href="index.html" title="Conversion de documents DocBook XML/SGML avec OpenJade"><link rel="up" href="index.html" title="Conversion de documents DocBook XML/SGML avec OpenJade"><link rel="prev" href="ar01s04.html" title="4. Utilisation d'OpenJade"><link rel="next" href="ar01s06.html" title="6. Informations supplémentaires"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">5. Publier DocBook 4.1.2 XML</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="ar01s04.html">Précédent</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="ar01s06.html">Suivant</a></td></tr></table><hr></div><div class="sect1" lang="fr"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="N1070B"></a>5. Publier DocBook 4.1.2 XML</h2></div></div><div></div></div><p>Il existe trois moyens de publier DocBook 4.1.2 XML sur un serveur Internet :</p><div class="itemizedlist"><ul type="disc"><li><p>OpenJade en ligne de commande pré-interprétée (<span class="foreignphrase"><em class="foreignphrase">command line pre-processed OpenJade</em></span>), XSLT</p></li><li><p>Scripts — PHP, Perl, Python</p></li><li><p>Serveur d'applications — Tomcat + Cocoon</p></li></ul></div><p>La meilleure option est d'utiliser un serveur d'applications comme Cocoon.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note: Cocoon en action"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Cocoon en action</th></tr><tr><td valign="top" align="left"><p>Pour visualiser un exemple de serveur Internet publiant des contenus DocBook 4.1.2 XML avec Tomcat + Cocoon, visitez <a href="http://www.xml-dev.com:8080/cocoon/mount/docbook/" target="_top">http://www.xml-dev.com:8080/cocoon/mount/docbook/</a>.</p></td></tr></table></div><p>Dans cette section, nous verrons comment publier un contenu DocBook 4.1.2 XML avec Tomcat + Cocoon.</p><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N10729"></a>5.1. Tomcat + Cocoon</h3></div></div><div></div></div><p>Tomcat est le contenant de mini-serveurs Java (<span class="foreignphrase"><em class="foreignphrase">Java Servlet Container</em></span>). Pour plus d'informations, visitez <a href="http://jakarta.apache.org/tomcat/index.html" target="_top">http://jakarta.apache.org/tomcat/index.html</a>.</p><p>Apache Cocoon est une structure de publication XML. Pour plus d'informations, visitez <a href="http://xml.apache.org/cocoon/index.html" target="_top">http://xml.apache.org/cocoon/index.html</a>.</p><p>Ce guide pratique ne détaillera pas la configuration de Tomcat + Cocoon, puisque c'est déjà fait dans le document <a href="http://wiki.cocoondev.org/Wiki.jsp?page=CocoonCompetenceCenter" target="_top">http://wiki.cocoondev.org/Wiki.jsp?page=CocoonCompetenceCenter</a>. Cette configuration est simple et ne prendra pas plus de cinq minutes.</p><p>Une fois Cocoon + Tomcat configurés et opérationnels, poursuivez aux sections suivantes pour publier des contenus DocBook 4.1.2 XML.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note: Avertissement important : "><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Avertissement important : </th></tr><tr><td valign="top" align="left"><p>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.</p></td></tr></table></div><p><span class="emphasis"><em>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).</em></span></p><p>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.</p><p>Pour savoir quelle est la version installée actuellement :</p><pre class="screen"><span><strong class="command"># java org.apache.xalan.xslt.EnvironmentCheck</strong></span></pre><p>Pour plus d'informations, visitez <a href="http://xml.apache.org/xalan-j/faq.html" target="_top">http://xml.apache.org/xalan-j/faq.html</a>.</p></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N10756"></a>5.2. Installation du XSL de Norman Walsh</h3></div></div><div></div></div><p>Durant cette phase, nous installerons le XSL de Norman Walsh dans le dossier <code class="filename">/usr/local/dbtools/</code>.</p><p>Positionnez-vous dans le dossier <code class="filename">/tmp/downloads</code>, puis décompressez et dépaquetez le fichier <code class="filename">docbook-xsl</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /tmp/downloads/</strong></span>
<span><strong class="command"><code class="prompt"># </code>gzip -d docbook-xsl-1.53.0.tar.gz</strong></span>
<span><strong class="command"><code class="prompt"># </code>tar -xvf docbook-xsl-1.53.0.tar</strong></span>
</pre><p>Pour installer <code class="filename">docbook-xsl</code>, déplacez les fichiers dans <code class="filename">/usr/local/dbtools</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>mv docbook-xsl-1.53.0 /usr/local/dbtool/docbook-xsl</strong></span>
</pre><p>Ensuite, installez le XSL du TLDP.</p></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N1079A"></a>5.3. Installation du XSL du TLDP</h3></div></div><div></div></div><p>Décompressez et dépaquetez le fichier <code class="filename">tldp-xsl-xxxxx.tar.gz</code>, puis copiez tous les fichiers dans le dossier <code class="filename">/usr/local/dbtools/docbook-xsl/html</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /tmp/downloads</strong></span>
<span><strong class="command"><code class="prompt"># </code>gzip tldp-xsl-xxxxx.tar.gz</strong></span>
<span><strong class="command"><code class="prompt"># </code>gzip tldp-xsl-xxxxx.tar</strong></span>
<span><strong class="command"><code class="prompt"># </code>mv tldp-html*.xsl /usr/local/dbtools/docbook-xsl/html</strong></span>
</pre></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N107C7"></a>5.4. Configuration de <code class="filename">sitemap.xmap</code></h3></div></div><div></div></div><p><code class="varname">$COCOON_HOME</code> pointe vers le dossier d'applications Internet de Cocoon. Ce dossier s'appelle typiquement <code class="filename">/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/</code></p><p>Créez un dossier nommé <code class="filename">docbook</code> dans <code class="filename">$COCOON_HOME/mount</code>. c'est là que nous mettrons tous nos contenus DocBook XML 4.1.2.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>mkdir $COCOON_HOME/mount/docbook</strong></span>
</pre><p>Créez un fichier nommé <code class="filename">sitemap.xmap</code> dans <code class="filename">$COCOON_HOME/mount/docbook</code> avec le contenu suivant :</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd $COCOON_HOME/mount/docbook</strong></span>
<span><strong class="command"><code class="prompt"># </code>vi sitemap.xmap</strong></span>
</pre><pre class="screen">
<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">
<!-- use the standard components -->
<map:components>
<map:generators default="file"/>
<map:transformers default="xslt"/>
<map:readers default="resource"/>
<map:serializers default="html"/>
<map:selectors default="browser"/>
<map:matchers default="wildcard"/>
<map:transformers default="xslt"/>
</map:components>
<map:pipelines>
<map:pipeline>
<map:match pattern="">
<map:generate src="samples.xml"/>
<map:transform
src="/usr/local/jakarta-tomcat-4.1.9/webapps/cocoon/mount/editor/stylesheets/simple-page2html.xsl"/>
<map:serialize/>
</map:match>
<!-- répond aux requêtes *.html avec
nos documents traités par .xsl -->
<map:match pattern="*.html">
<map:generate src="{1}.xml"/>
<map:transform
src="/usr/local/dbtools/docbook-xsl/html/tldp-html.xsl"/>
<map:serialize type="html"/>
</map:match>
<!-- ensuite, répond aux requêtes *.pdf avec
nos documents traités par doc2pdf.xsl -->
<map:match pattern="*.pdf">
<map:generate src="{1}.xml"/>
<map:transform
src="/usr/local/dbtools/docbook-xsl/fo/docbook.xsl"/>
<map:serialize type="fo2pdf"/>
</map:match>
<map:match pattern="*.xml">
<map:generate src="{1}.xml"/>
<map:serialize type="xml"/>
</map:match>
</map:pipeline>
</map:pipelines>
</map:sitemap>
</pre></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N1080A"></a>5.5. Accès à un contenu DocBook 4.1.2 XML dans un navigateur Internet</h3></div></div><div></div></div><p>Placez un fichier DocBook 4.1.2 XML dans le dossier <code class="filename">$COCOON_HOME/mount/docbook/</code>.</p><p>Un fichier d'exemple est disponible à <a href="http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml" target="_top">http://www.xml-dev.com:8080/cocoon/mount/docbook/openjade.xml</a>.</p><p>Maintenant, vous pouvez accéder au document à l'aide d'un
navigateur à
« http://localhost:8080/cocoon/mount/sample.html »
(HTML) ou
« http://localhost:8080/cocoon/mount/sample.pdf »
(PDF).</p></div></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="ar01s04.html">Précédent</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="ar01s06.html">Suivant</a></td></tr><tr><td valign="top" align="left" width="40%">4. Utilisation d'OpenJade </td><td align="center" width="20%"><a accesskey="h" href="index.html">Sommaire</a></td><td valign="top" align="right" width="40%"> 6. Informations supplémentaires</td></tr></table></div></body></html>
