/usr/share/doc/HOWTO/fr-html/DocBook-Install.html is in doc-linux-fr-html 2013.01-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 25 March 2009), see www.w3.org">
<title>DocBook Install mini-HOWTO</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000" link=
"#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a name="AEN2" id="AEN2">DocBook Install
mini-HOWTO</a></h1>
<h3 class="AUTHOR"><a name="AEN4" id="AEN4">Robert B
Easter</a></h3>
<div class="AFFILIATION">
<div class="ADDRESS">
<p class="ADDRESS"> <code class="EMAIL"><<a href=
"mailto:reaster@comptechnews.com">reaster@comptechnews.com</a>></code><br>
</p>
</div>
</div>
<div class="REVHISTORY">
<table width="100%" border="0">
<tr>
<th align="left" valign="top" colspan="3"><b>Historique des
versions</b></th>
</tr>
<tr>
<td align="left">Version v1.7</td>
<td align="left">2001-03-28</td>
<td align="left">Revu par : rbe</td>
</tr>
<tr>
<td align="left" colspan="3"></td>
</tr>
</table>
</div>
<div>
<div class="ABSTRACT"><a name="AEN24" id="AEN24"></a>
<p>DocBook-Install-mini-HOWTO est un guide pratique et
détaillé pour permettre aux novices d'installer
rapidement DocBook et de générer des fichiers SGML en
HTML, PS et PDF sur un système GNU/Linux (mais cela peut
être similaire sur d'autres systèmes). La mise en
place de DocBook, qui nécessite des fichiers de plusieurs
paquetages distribués séparément, peut sembler
confuse aux débutants.</p>
</div>
</div>
<hr></div>
<div class="SECT1">
<hr>
<h2 class="SECT1"><a name="intro" id="intro">Introduction</a></h2>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="versions" id="versions">A propos de ce
document</a></h3>
<p>La dernière version de ce mini-howto peut être
trouvée sur :</p>
<p><a href="http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/"
target=
"_top">http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/</a></p>
<p>Reportez-vous à la section pour des informations sur les
copyright, licence et décharge de responsabilité
relatifs à ce document.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN35" id="AEN35">Qu'est-ce que
DocBook?</a></h3>
<p>DocBook est une Définition de Type de Documents
(<acronym class="ACRONYM">DTD</acronym> - <span class=
"emphasis"><i class="EMPHASIS">Document Type Definition</i></span>)
en Langage Standard de Balisage Généralisé
(<acronym class="ACRONYM">SGML</acronym> - <span class=
"emphasis"><i class="EMPHASIS">Standard Generalized Markup
Language</i></span>), qui définit un ensemble de balises
pour des documents littéraux, et qui fonctionne comme le
langage HTML utilisé habituellement sur le Web.</p>
<p>DocBook est destiné à la rédaction de
livres et d'articles. Comme tel, il fournit des balises
(appelées encore marqueurs) pensées
spécifiquement pour décrire des livres et des
articles. Par exemple, les balises DocBook <code class=
"SGMLTAG">book</code> et <code class="SGMLTAG">article</code> sont
utilisées pour créer les livres et les articles. Dans
ces documents, des balises <code class="SGMLTAG">chapter</code>,
<code class="SGMLTAG">sect1</code>, et <code class=
"SGMLTAG">para</code> seront utilisées. Les fichiers SGML
DocBook sont stockés dans des fichiers texte avec un suffixe
.sgml ou .gml</p>
<p>Lors de son traitement, un unique fichier SGML DocBook peut
produire des fichiers HTML, PDF, PS, TXT ou d'autres formats de
publication papier ou électronique. Le traitement est
régi par des feuilles de style (<span class=
"emphasis"><i class="EMPHASIS">stylesheets</i></span>) qui peuvent
générer automatiquement une table des
matières, la numérotation des pages, la
numérotation des chapitres et des sections, et bien d'autres
possibilités.</p>
<p>DocBook est destiné également à
l'écriture de pages de manuel unix, en utilisant la balise
<code class="SGMLTAG">refentry</code>.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN52" id="AEN52">Aperçu
rapide</a></h3>
<p>Voici une description brève des paquetages que nous
utiliserons dans les prochaines sections :</p>
<div class="FORMALPARA">
<p><b>OpenJade.</b> OpenJade est un processeur <acronym class=
"ACRONYM">DSSSL</acronym> (<span class="emphasis"><i class=
"EMPHASIS">Document Style Semantics and Specification
Language</i></span> - Langage de spécification et
Sémantique de présentation de document) pour
documents <acronym class="ACRONYM">SGML</acronym> (<span class=
"emphasis"><i class="EMPHASIS">Standard Generalized Markup
Language</i></span> - Langage Standard de Balisage
Généralisé). Il transforme des fichiers source
SGML DocBook en fichiers HTML, TEX, RTF, TXT et autres formats.
OpenJade est l'outil essentiel pour convertir un fichier DocBook
dans d'autres formats. Le format de sortie TEX est utilisé
surtout comme format intermédiaire pour obtenir des fichiers
DVI, PDF et PS par des macros TeX et des convertisseurs DVI.</p>
</div>
<div class="FORMALPARA">
<p><b>La DTD SGML DocBook.</b> Les fichiers <acronym class=
"ACRONYM">DTD</acronym> (Définition de Type de Document)
sont des fichiers SGML qui définissent le langage DocBook.
L'ensemble des balises valides et leurs règles d'utilisation
y sont définis. OpenJade a besoin d'accéder aux
fichiers DTD des documents qu'il doit traiter.</p>
</div>
<div class="FORMALPARA">
<p><b>ISO8879 ENTITY SGML.</b> Les entités
définissent la représentation des caractères
spéciaux qui n'ont pas de touche clavier associée ou
qui ont une signification particulière en SGML. Des exemples
connus en HTML sont "eacute;" pour "é","amp;" pour "" et
"gt;" pour "".</p>
</div>
<div class="FORMALPARA">
<p><b>DSSSL DocBook.</b> Les fichiers <acronym class=
"ACRONYM">DSSSL</acronym> (<span class="emphasis"><i class=
"EMPHASIS">Document Style Semantics and Specification
Language</i></span>) pour une DTD particulière, en
l'occurrence DocBook, spécifient comment convertir le
document DocBook en fichiers au format HTML, RTF, TEX, etc.</p>
</div>
<div class="FORMALPARA">
<p><b>SgmlTools-lite.</b> <span class=
"APPLICATION">SgmlTools</span> est une interface pour lancer
OpenJade et les macros TeX <span class="APPLICATION">jadetex</span>
et <span class="APPLICATION">pdfjadetex</span> qui en font partie.
La conversion d'un fichier DocBook en format PS ou PDF est un
traitement en deux ou trois étapes. OpenJade crée un
fichier TEX qu'utilise jadetex pour produire un DVI, et pdfjadetex
pour produire un document PDF. Un fichier PS s'obtient en
transformant le fichier DVI avec <span class=
"APPLICATION">dvips</span>. Les scripts SgmlTools fournissent une
commande unique pour ces tâches.</p>
</div>
<div class="FORMALPARA">
<p><b>HTMLdoc.</b> <span class="APPLICATION">HTMLdoc</span> est un
programme libre pour convertir des fichiers HTML en documents PDF
ou PS.</p>
</div>
<div class="FORMALPARA">
<p><b>SGMLSpm and docbook2X.</b> Ces deux outils sont à
utiliser pour générer des pages de manuel. SGMLSpm
est une bibliothèque modulaire Perl5 pour traiter les
résultats du travail de <tt class="FILENAME">onsgmls</tt>,
un programme inclus dans OpenJade. SGMLSpm comprend une application
appelée <tt class="FILENAME">sgmlspl</tt> permettant
d'utiliser la bibliothèque SGMLSpm. <tt class=
"FILENAME">Sgmlspl</tt> nécessite des fichiers de
spécification, disponibles sur de nombreux sites internet,
pour chaque type de document à transformer. <span class=
"APPLICATION">DocBook2X</span> est un paquetage qui fournit des
fichiers de spécification pour transformer des fichiers
DocBook en pages de manuel.</p>
</div>
</div>
</div>
<div class="SECT1">
<hr>
<h2 class="SECT1"><a name="download" id=
"download">Télécharger les paquetages</a></h2>
<p>Dans cette section, nous localiserons et
téléchargerons les logiciels sur Internet.</p>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN95" id="AEN95">OpenJade</a></h3>
<p>OpenJade est un logiciel aux sources libres (open-source),
activement maintenu, basé sur le paquetage Jade de <a href=
"http://www.jclark.com/" target="_top">James Clark</a>.
Téléchargez la dernière version stable (1.3?)
sur:</p>
<p><a href="http://openjade.sourceforge.net/" target=
"_top">http://openjade.sourceforge.net/</a></p>
<p>OpenJade inclut également le paquetage OpenSP et les
macros TeX <span class="APPLICATION">jadetex</span> et <span class=
"APPLICATION">pdfjadetex</span> pour convertir les fichiers en DVI
et en PDF. Les programmes suivants sont installés par ce
paquetage:</p>
<ul>
<li>
<p><span class="APPLICATION">openjade</span></p>
</li>
<li>
<p><span class="APPLICATION">onsgmls</span></p>
</li>
<li>
<p><span class="APPLICATION">osgmlnorm</span></p>
</li>
<li>
<p><span class="APPLICATION">ospam</span></p>
</li>
<li>
<p><span class="APPLICATION">ospent</span></p>
</li>
<li>
<p><span class="APPLICATION">osx</span></p>
</li>
</ul>
<p>Afin de pouvoir utiliser jadetex et pdfjadetex pour créer
du DVI, PS et PDF, vous devez avoir une installation de TeX qui
fonctionne. Si vous n'avez pas TeX, cherchez dans votre
distribution Linux le paquetage à installer. Sinon, vous
pouvez télécharger la distribution TeX <span class=
"APPLICATION">teTeX</span> depuis :</p>
<p><a href="http://www.tug.org/tetex/" target=
"_top">http://www.tug.org/tetex/</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN127" id="AEN127">La DTD SGML
DocBook</a></h3>
<p>Les DTD DocBook SGML et XML sont maintenues par un comité
technique à <a href="http://www.oasis-open.org/" target=
"_top">Oasis-Open.ORG</a>. Téléchargez la
dernière version (et les versions anciennes dont vous
pourriez avoir besoin) de DocBook SGML sur :</p>
<p><a href="http://www.oasis-open.org/docbook/sgml/index.html"
target=
"_top">http://www.oasis-open.org/docbook/sgml/index.html</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN133" id="AEN133">ISO8879 ENTITY
SGML</a></h3>
<p>Les entités définissent la représentation
de caractères spéciaux ou de symboles qui ne peuvent
être saisis au clavier, y compris les symboles
mathématiques et les entités qui peuvent vous
être familières avec le HTML. Ces fichiers
d'entités doivent être installés pour avoir une
configuration correcte.</p>
<ul>
<li>
<p>Ressources à <a href="http://www.oasis-open.org/" target=
"_top">OASIS</a> :</p>
<ul>
<li>
<p><a href="http://www.oasis-open.org/cover/topics.html#entities"
target=
"_top">http://www.oasis-open.org/cover/topics.html#entities</a></p>
</li>
<li>
<p><a href="http://www.oasis-open.org/cover/ISOEnts.zip" target=
"_top">http://www.oasis-open.org/cover/ISOEnts.zip</a></p>
</li>
<li>
<p><a href="http://www.oasis-open.org/cover/isoENT-tar.gz" target=
"_top">http://www.oasis-open.org/cover/isoENT-tar.gz</a></p>
</li>
</ul>
</li>
</ul>
<p>ISOEnts.zip n'a besoin que d'être décompacté
dans le répertoire de la DTD DocBook et de rien d'autre,
mais les fichiers dans isoENT-tar.gz restent nécessaires.
Les fichiers de isoENT-tar.gz doivent donc également
être décompactés dans le répertoire de
la DTD DocBook (cf. pour les détails). Mais ces fichiers
possèdent un suffixe ".ent" qui doit être
renommé en ".gml". Vous pouvez le faire manuellement, ou
bien vous pouvez télécharger et utiliser le fichier
ci-dessous, préparé par l'auteur, qui contient les
fichiers des deux archives ISOEnts.zip et isoENT-tar.gz :</p>
<p><a href=
"http://www.comptechnews.com/~reaster/iso8879-entities.tar.gz"
target=
"_top">http://www.comptechnews.com/~reaster/iso8879-entities.tar.gz</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="dsssl" id="dsssl">DSSSL DocBook</a></h3>
<p>Des fichiers DSSSL (<span class="emphasis"><i class=
"EMPHASIS">Document Style Semantics and Specification
Language</i></span>) pour la DTD DocBook (SGML/XML) sont fournis
par <a href="http://www.nwalsh.com/" target="_top">Norman
Walsh</a>. Ces fichiers, appelés <a href=
"http://nwalsh.com/docbook/dsssl/" target="_top">Modular DocBook
Stylesheets</a> (feuilles de style modulaires pour DocBook), disent
à <span class="APPLICATION">OpenJade</span> comment
convertir votre fichier SGML DocBook en un autre format. Un fichier
<tt class="FILENAME">dsl</tt> décrit par exemple la
correspondance entre une balise d'une DTD et une autre balise d'une
autre DTD, ou d'autres conversions programmées,
écrites dans un langage appelé <a href=
"http://www.nwalsh.com/" target="_top">Core Expression
Language</a>, qui est dérivé du <a href=
"http://www.gnu.org/manual/elisp-manual-20-2.5/html_chapter/elisp_2.html#SEC5"
target="_top">Scheme</a>. Le paquetage DSSSL DocBook et sa
documentation peuvent être téléchargés
sur le site de Norman Walsh:</p>
<p><a href="http://nwalsh.com/docbook/dsssl/" target=
"_top">http://nwalsh.com/docbook/dsssl/</a></p>
<a name="AEN166" id="AEN166"></a>
<blockquote class="BLOCKQUOTE"></blockquote>
</div>
</div>
</div>
</body>
</html>
|