Sophie: howto-html-fr-20080722-1mdv2010.0 noarch

howto-html-fr-20080722-1mdv2010.0.noarch.rpm

<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>3.&nbsp;Installation des outils de conversion &mdash; OpenJade</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="ar01s02.html" title="2.&nbsp;Les indispensables"><link rel="next" href="ar01s04.html" title="4.&nbsp;Utilisation d'OpenJade"></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">3.&nbsp;Installation des outils de conversion &mdash; OpenJade</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="ar01s02.html">Pr&eacute;c&eacute;dent</a>&nbsp;</td><th align="center" width="60%">&nbsp;</th><td align="right" width="20%">&nbsp;<a accesskey="n" href="ar01s04.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="inst-openjade"></a>3.&nbsp;Installation des outils de conversion &mdash; OpenJade</h2></div></div><div></div></div><p>Dans cette section, nous installerons tous les outils dans les dossiers appropri&eacute;s. Tous vont dans <code class="filename">/usr/local/dbtools/</code>. Cr&eacute;ez ce dossier &agrave; l'aide de la commande suivante&nbsp;:</p><pre class="screen">
<span><strong class="command"># mkdir /usr/local/dbtools</strong></span>
</pre><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N102EF"></a>3.1.&nbsp;Installation d'OpenJade</h3></div></div><div></div></div><p>Cette proc&eacute;dure est la partie la plus facile, mais aussi la plus longue. Gardez &agrave; l'esprit que la compilation d'OpenJade demande du temps. Pour installer OpenJade, r&eacute;alisez les op&eacute;rations suivantes&nbsp;:</p><div class="orderedlist"><ol type="1"><li><p>Positionnez-vous dans le dossier <code class="filename">/tmp/downloads</code>.</p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">cd /tmp/downloads</strong></span>
</pre></li><li><p>D&eacute;compressez le fichier.</p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">gzip -d openjade-1.3.x.tar.gz</strong></span>
</pre></li><li><p>D&eacute;paquetez le fichier.</p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">tar -xvf openjade-1.3.x.tar</strong></span>
</pre></li><li><p>D&eacute;placez-vous dans le dossier <code class="filename">openjade-1.3</code></p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">cd openjade-1.3.x</strong></span>
</pre></li><li><p>Ex&eacute;cutez la commande <span><strong class="command">./configure</strong></span>.</p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">./configure --prefix=/usr/local/dbtools/openjade</strong></span>
</pre></li><li><p>Ex&eacute;cutez la commande <span><strong class="command">make</strong></span>.</p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">make</strong></span>
</pre></li><li><p>Ex&eacute;cutez la commande <span><strong class="command">make install</strong></span>. D&egrave;s maintenant, les fichiers binaires d'OpenJade seront install&eacute;s sous <code class="filename">/usr/local/dbtools/openjade</code>.</p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">make install</strong></span>
</pre></li><li><p>Copiez le dossier <code class="filename">dsssl</code> de <code class="filename">/tmp/downloads/openjade-1.3.x</code> vers <code class="filename">/usr/local/dbtools/openjade</code>.</p><pre class="screen">
<code class="prompt"># </code><span><strong class="command">cp -dpR dsssl /usr/local/dbtools/openjade/</strong></span>
</pre></li></ol></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N10388"></a>3.2.&nbsp;Installation du DSSSL de Norman Walsh</h3></div></div><div></div></div><p>Durant cette &eacute;tape, nous installerons le DSSSL de Norman Walsh dans un endroit appropri&eacute;. Le DSSSL n'a pas besoin d'&ecirc;tre compil&eacute;.</p><div class="orderedlist"><ol type="1"><li><p>Positionnez-vous dans le dossier <code class="filename">/tmp/downloads</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /tmp/downloads</strong></span>
</pre></li><li><p>D&eacute;compressez le fichier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>gzip -d docbook-dsssl-1.76.tar.gz</strong></span>
</pre></li><li><p>D&eacute;paquetez le fichier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>tar -xvf docbook-dsssl-1.76.tar</strong></span>
</pre></li><li><p>D&eacute;placez-vous dans le dossier <code class="filename">/usr/local/dbtools/docbook-dsssl</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl</strong></span>
</pre></li></ol></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N103CE"></a>3.3.&nbsp;Installation des DTD DocBook</h3></div></div><div></div></div><p>Dans cette section, nous installerons les DTD DocBook.</p><div class="orderedlist"><ol type="1"><li><p>Positionnez-vous dans le dossier <code class="filename">/usr/local/dbtools</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /usr/local/dbtools</strong></span>
</pre></li><li><p>Cr&eacute;ez trois nouveaux dossiers, nomm&eacute;s <code class="filename">dtd3.1</code>, <code class="filename">dtd4.1</code>, et <code class="filename">dtd4.1.2</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>mkdir dtd3.1</strong></span>
<span><strong class="command"><code class="prompt"># </code>mkdir dtd4.1</strong></span>
<span><strong class="command"><code class="prompt"># </code>mkdir dtd4.1.2</strong></span>
</pre></li><li><p>D&eacute;placez-vous dans le dossier <code class="filename">dtd3.1</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd dtd3.1</strong></span>
</pre></li><li><p>D&eacute;compressez le fichier DocBook SGML v3.1 dans ce dossier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>unzip /tmp/downloads/docbk31.zip</strong></span>
</pre></li><li><p>D&eacute;placez-vous dans le dossier <code class="filename">dtd4.1</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd ../dtd4.1</strong></span>
</pre></li><li><p>D&eacute;compressez le fichier DocBook SGML v4.1 dans ce dossier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>unzip /tmp/downloads/docbk41.zip</strong></span>
</pre></li><li><p>D&eacute;placez-vous dans le dossier <code class="filename">dtd4.1.2</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd ../dtd4.1.2</strong></span>
</pre></li><li><p>D&eacute;compressez le fichier DocBook XML v4.1.2 dans ce dossier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>unzip /tmp/downloads/docbk412.zip</strong></span>
</pre></li></ol></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N1046F"></a>3.4.&nbsp;Installation des entit&eacute;s ISO</h3></div></div><div></div></div><p>Dans cette section, nous installerons les entit&eacute;s ISO que nous avons t&eacute;l&eacute;charg&eacute;es sur le site Internet du TLDP.</p><p>Tout d'abord, nous installons les entit&eacute;s ISO pour la DTD 3.1 SGML.</p><div class="orderedlist"><ol type="1"><li><p>Positionnez-vous dans le dossier <code class="filename">/usr/local/dbtools/dtd3.1</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /usr/local/dbtools/dtd3.1</strong></span>
</pre></li><li><p>Copiez ici le fichier <code class="filename">/tmp/download/entities.tar.gz</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cp /tmp/download/entities.tar.gz .</strong></span>
</pre></li><li><p>D&eacute;compressez le fichier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>gzip -d entities.tar.gz</strong></span>
</pre></li><li><p>D&eacute;paquetez le fichier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>tar -xvf entities.tar</strong></span>
</pre></li></ol></div><p>Ensuite, nous installons les entit&eacute;s ISO pour la DTD 4.1 SGML.</p><div class="orderedlist"><ol type="1"><li><p>Positionnez-vous dans le dossier <code class="filename">/usr/local/dbtools/dtd4.1</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /usr/local/dbtools/dtd4.1</strong></span>
</pre></li><li><p>Copiez ici le fichier <code class="filename">/tmp/download/entities.tar.gz</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cp /tmp/download/entities.tar.gz .</strong></span>
</pre></li><li><p>D&eacute;compressez le fichier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>gzip -d entities.tar.gz</strong></span>
</pre></li><li><p>D&eacute;paquetez le fichier.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>tar -xvf entities.tar</strong></span>
</pre></li></ol></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="installation-ldpdsl"></a>3.5.&nbsp;Installation du DSL du TLDP</h3></div></div><div></div></div><p>Enfin, nous installons la feuille de style personnalis&eacute;e du TLDP.</p><div class="orderedlist"><ol type="1"><li><p>Positionnez-vous dans le dossier <code class="filename">/tmp/download</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /tmp/download</strong></span>
</pre></li><li><p>Copiez le fichier <code class="filename">ldp.dsl</code> &agrave; l'emplacement <code class="filename">/usr/local/dbtools/docbook-dsssl/print</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print</strong></span>
</pre></li><li><p>Copiez le fichier <code class="filename">ldp.dsl</code> &agrave; l'emplacement <code class="filename">/usr/local/dbtools/docbook-dsssl/html</code>.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html</strong></span>
</pre></li><li><p><a name="adaptation-ldpdsl"></a>Le contenu du fichier <code class="filename">ldp.dsl</code> doit &ecirc;tre modifi&eacute; pour refl&eacute;ter le chemin absolu du fichier <code class="filename">docbook.dsl</code>. Voici la zone originale du fichier qui doit &ecirc;tre adapt&eacute;e&nbsp;:</p><pre class="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;	   
</pre><p>&Eacute;ditez le fichier <code class="filename">ldp.dsl</code> situ&eacute; &agrave; l'emplacement <code class="filename">/usr/local/dbtools/docbook-dsssl/print</code> avec un &eacute;diteur de texte.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>emacs /usr/local/dbtools/docbook-dsssl/print/ldp.dsl</strong></span>
</pre><p>Modifiez le contenu du fichier comme suit&nbsp;:</p><pre class="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;
</pre><p>&Eacute;ditez le fichier <code class="filename">ldp.dsl</code> situ&eacute; &agrave; l'emplacement <code class="filename">/usr/local/dbtools/docbook-dsssl/html</code> avec un &eacute;diteur de texte.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>emacs /usr/local/dbtools/docbook-dsssl/html/ldp.dsl</strong></span>
</pre><p>Modifiez le contenu du fichier comme suit&nbsp;:</p><pre class="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;
</pre></li></ol></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="N10582"></a>3.6.&nbsp;Installation de HTMLDOC</h3></div></div><div></div></div><p>Cette &eacute;tape est facultative. Elle est utile seulement si vous d&eacute;sirez cr&eacute;er des documents PDF &agrave; partir de HTML.</p><p>Retournez dans le dossier des t&eacute;l&eacute;chargements.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>cd /tmp/download</strong></span>
</pre><p>D&eacute;compressez et d&eacute;paquetez le code source de HTMLDOC.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>gzip -d htmldoc-1.8.xx-source.tar.gz</strong></span>
<span><strong class="command"><code class="prompt"># </code>tar -xvf htmldoc-1.8.xx-source.tar</strong></span>
<span><strong class="command"><code class="prompt"># </code>cd htmldoc-1.8.xx-1</strong></span>
</pre><p>Ex&eacute;cutez <span><strong class="command">configure</strong></span> pour d&eacute;finir le chemin d'installation.</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>./configure --prefix=/usr/local/dbtools/htmldoc</strong></span>
<span><strong class="command"><code class="prompt"># </code>make</strong></span>
</pre><p>Lors de la r&eacute;daction de ce document, HTMLDOC version 1.8.20-1 &eacute;tait disponible. Cette version conna&icirc;t un probl&egrave;me de fontes dans le fichier <code class="filename">Makefile</code>. Il devrait se plaindre &agrave; l'installation des fontes, parce qu'elles ne sont pas disponibles sur le syst&egrave;me.</p><p>Voici l'erreur obtenue lorsque vous ex&eacute;cuterez <span><strong class="command">make install</strong></span>&nbsp;:</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>make install</strong></span>
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
</pre><p>Pour corriger ce probl&egrave;me d'installation, &eacute;ditez le fichier <code class="filename">fonts/Makefile</code> et mettez en commentaires les lignes r&eacute;f&eacute;renc&eacute;es aux fontes <span class="emphasis"><em>ZapfChancery</em></span> et <span class="emphasis"><em>ZapfDingbats</em></span>.</p><p>Ensuite, ex&eacute;cutez l'installation&nbsp;:</p><pre class="screen">
<span><strong class="command"><code class="prompt"># </code>make install</strong></span>
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...
</pre></div></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="ar01s02.html">Pr&eacute;c&eacute;dent</a>&nbsp;</td><td align="center" width="20%">&nbsp;</td><td align="right" width="40%">&nbsp;<a accesskey="n" href="ar01s04.html">Suivant</a></td></tr><tr><td valign="top" align="left" width="40%">2.&nbsp;Les indispensables&nbsp;</td><td align="center" width="20%"><a accesskey="h" href="index.html">Sommaire</a></td><td valign="top" align="right" width="40%">&nbsp;4.&nbsp;Utilisation d'OpenJade</td></tr></table></div></body></html>