This file is indexed.

/usr/share/doc/HOWTO/fr-html/HTML-Validation.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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 25 March 2009), see www.w3.org">
<meta name="GENERATOR" content="LinuxDoc-Tools 0.9.69">
<title>HTML Validation HOWTO</title>
</head>
<body>
<h1>HTML Validation HOWTO</h1>
<h2>Keith M. Corbett &lt;kmc@specialform.com&gt;</h2>
v0.2, 29 Octobre 1995 Traduction fran&ccedil;aise: Thierry
B&eacute;zecourt, Avril 1999. ( 14 Octobre 1997 : La mini-HOWTO
Linux HTML Validation n'est plus maintenue par son auteur. Si vous
souhaitez vous en occuper, en fran&ccedil;ais ou en anglais, merci
de contacter &lt;gregh@sunsite.unc.edu&gt; )
<hr>
<em>Cette documentation a pour objet d'expliquer l'utilisation du
programme nsgmls afin de v&eacute;rifier qu'un document HTML est
conforme &agrave; la d&eacute;finition de type de document (ou
"DTD") HTML 2.0. Parmi les d&eacute;finitions de HTML &agrave;
partir de SGML, ce DTD est la plus fr&eacute;quemment
adopt&eacute;e. Il d&eacute;finit ainsi un sous-ensemble du
balisage HTML correspondant &agrave; la pratique courante, ayant
les meilleures chances de portabilit&eacute; sur un nombre
important d'agents utilisateurs de HTML (ou "navigateurs").</em>
<hr>
<h2><a name="s1">1. Introduction</a></h2>
<p>Ceci est un guide d'utilisation de l'analyseur nsgmls pour
valider et traiter des documents HTML.</p>
<h2><a name="ss1.1">1.1 Co&ucirc;ts et
b&eacute;n&eacute;fices</a></h2>
<p>Vous enrichirez vos documents HTML en utilisant toutes les
capacit&eacute;s de SGML. Mais la validation de vos documents par
r&eacute;f&eacute;rence au DTD HTML a un certain nombre d'avantages
et d'inconv&eacute;nients, avant tout parce que vous avez affaire
&agrave; un dialecte de HTML plus restreint que celui qui est
utilis&eacute; actuellement. Les r&egrave;gles "officielles"
sp&eacute;cifiant la structure d'un document en HTML et les
r&egrave;gles concernant le balisage des donn&eacute;es en SGML
sont plus strictes que ne l'est la pratique courante sur le
Web.</p>
<p>La premier point, et le plus important, est d'avoir conscience
que le codage HTML correct se r&eacute;duit &agrave; un ensemble
normalis&eacute; de balises.</p>
<p>Il n'existe pas de DTD couramment accept&eacute; qui
refl&egrave;te exactement le "HTML des navigateurs", tel qu'il est
compris par de nombreux programmes clients de navigation. Pour
l'essentiel, le DTD HTML 2.0 contient les balises et les attributs
les plus commun&eacute;ment utilis&eacute;s sur le Web autour de
juin 1994. Divers efforts visant &agrave; d&eacute;finir un DTD
HTML+ ou HTML 3.0 se trouvent plus ou moins dans une impasse. Et
aucun des DTD en circulation ne reconna&icirc;tra l'ensemble des
balises rendues populaires par des &eacute;diteurs de navigateurs
comme Netscape et Microsoft.</p>
<h2><a name="ss1.2">1.2 Pour d&eacute;buter</a></h2>
<p>Contrairement &agrave; ce que beaucoup de gens croient, il est
possible de travailler en SGML sans y consacrer trop de temps ou
d'argent. On peut mettre en place un environnement de
d&eacute;veloppement solide en utilisant exclusivement des
logiciels disponibles gratuitement sur un grand nombre de
plateformes, y compris Linux, DOS et la plupart des stations de
travail Unix. Gr&acirc;ce &agrave; quelques personnes qui s'y sont
consacr&eacute;es, tous les outils dont vous avez besoin pour
travailler en SGML sont disponibles publiquement sur Internet.</p>
<p>La mise en place de votre environnement (l'analyseur et les
biblioth&egrave;ques) prend un peu de temps, mais pas autant qu'on
pourrait le croire.</p>
<p>Au cas o&ugrave; vous &eacute;prouveriez l'envie de lire un
texte d'introduction &agrave; SGML (en anglais) : "SGML: An
Author's Guide to the Standard Generalized Markup Language" par
Martin Bryan, ou "Practical SGML" par Eric van Herwijnen.</p>
<h2><a name="s2">2. Les Outils</a></h2>
<h2><a name="ss2.1">2.1 "HTML Check Toolkit"</a></h2>
<p>Si vous voulez un logiciel s'installant automatiquement et qui
soit bien int&eacute;gr&eacute;, r&eacute;cup&eacute;rez <code>HTML
Check Toolkit</code> &agrave; l'addresse <a href=
"http://www.halsoft.com/html-tk/index.html">http://www.halsoft.com/html-tk/index.html</a>.</p>
<p>Le seul inconv&eacute;nient du logiciel HalSoft est qu'il
utilise le vieil analyseur sgmls, qui produit des messages d'erreur
parfois (encore) plus difficiles &agrave; comprendre que ceux de
nsgmls.</p>
<p>J'ai utilis&eacute; nsgmls sur Linux et Windows (3.x et NT) ; il
marche en principe sur de nombreuses autres plateformes.</p>
<h2><a name="ss2.2">2.2 L'analyseur nsgmls</a></h2>
<p>James Clark a mis au point sun ensemble logiciel nomm&eacute;
<code>sp</code>, qui contient un analyseur et un validateur SGML,
nsgmls (c'est le successeur de l'analyseur sgmls, longtemps
consid&eacute;r&eacute; comme le programme de
r&eacute;f&eacute;rence).</p>
<p>Pour plus d'informations sur sp, voyez l'URL <a href=
"http://www.jclark.com/sp.html">http://www.jclark.com/sp.html</a>.</p>
<p>Et vous pouvez le t&eacute;l&eacute;charger directement depuis
<a href=
"ftp://ftp.jclark.com/pub/sp/">ftp://ftp.jclark.com/pub/sp/</a>.</p>
<p>Vouz pouvez peut-&ecirc;tre aussi r&eacute;cup&eacute;rer des
fichiers ex&eacute;cutables pour votre plateforme. Ou bien
t&eacute;l&eacute;charger le code source, et dans ce cas suivez les
instructions du fichier README pour lancer make.</p>
<p>Il serait utile de cr&eacute;er un r&eacute;pertoire public au
sommet de la hi&eacute;rarchie, pour y mettre les fichiers relatifs
&agrave; SGML. Par exemple, sur mon PC Linux, j'ai plusieurs
r&eacute;pertoires pour SGML, dont :</p>
<ul>
<li>/usr/sgml/bin</li>
<li>/usr/sgml/html</li>
<li>/usr/sgml/sgmls</li>
<li>/usr/sgml/sp</li>
</ul>
<h2><a name="ss2.3">2.3 T&eacute;l&eacute;charger les
sp&eacute;cifications de HTML</a></h2>
<p>Le projet de norme HTML 2.0 contient le fichier de
d&eacute;finitions SGML dont vous aurez besoin pour utiliser
l'analyseur, c'est-&agrave;-dire le DTD (Document Type Definition),
la d&eacute;claration SGML, et le catalogue d'entit&eacute;. Vous
pouvez obtenir le texte public de HTML 2.0 &agrave; l'adresse</p>
<p><a href=
"http://www.w3.org/hypertext/WWW/MarkUp/html-spec/">http://www.w3.org/hypertext/WWW/MarkUp/html-spec/</a></p>
<p>T&eacute;l&eacute;chargez et installez les fichiers suivants
:</p>
<ul>
<li>DTD : html*.dtd</li>
<li>D&eacute;claration SGML : html.decl</li>
<li>Catalogue d'entit&eacute;s : catalog</li>
</ul>
<p>Vous pouvez ajouter deux entr&eacute;es au catalogue des
entit&eacute;s HTML pour faciliter l'utilisation de nsgmls :</p>
<pre>
   ______________________________________________________________________
           -- catalog: SGML Open style entity catalog for HTML --
           -- $Id: HTML-Validation.sgml,v 1.1.1.1 2003/01/03 02:40:54 traduc Exp $ --
    :
    :
           -- Ajouts pour faciliter l'utilisation de nsgmls --
   SGMLDECL        "html.decl"
   DOCTYPE HTML    "html.dtd"
   ______________________________________________________________________
</pre>
<p>Ou bien vous pouvez cr&eacute;er un second catalogue contenant
ces entr&eacute;es. Vous passerez ensuite ce catalogue &agrave;
nsgmls comme argument, avec l'option -m.</p>
<h2><a name="s3">3. Analyser un document HTML</a></h2>
<p>Voici une "recette" pour valider un document unique. Lancez
simplement le programme nsgmls en lui passant le chemin du (ou des)
fichier(s) du catalogue HTML, ainsi que le document :</p>
<pre>
       % nsgmls -s -m /usr/sgml/html/catalog &lt;test.html
</pre>
<p>L'option -s supprime la sortie de l'analyseur (voyez
ci-dessous).</p>
<h2><a name="ss3.1">3.1 Entr&eacute;e de l'analyseur</a></h2>
<p>Votre document doit &ecirc;tre conforme &agrave; la norme SGML,
ce qui signifie, entre autres, que le type de document doit
&ecirc;tre d&eacute;clar&eacute; au d&eacute;but de l'entr&eacute;e
(vous pouvez contourner cette r&egrave;gle en sp&eacute;cifiant
cette information sur la ligne de commande de nsgmls).</p>
<p>Voici un document HTML simple, qui peut &ecirc;tre
analys&eacute; sans erreur en suivant les r&egrave;gles que j'ai
d&eacute;crites :</p>
<pre>
   ______________________________________________________________________
   &lt;!doctype html public "-//IETF//DTD HTML 2.0//EN"&gt;
   &lt;html&gt;
   &lt;head&gt;
   &lt;title&gt;Document HTML simple.&lt;/title&gt;
   &lt;/head&gt;
   &lt;body&gt;
   &lt;h1&gt;Document de test&lt;/h1&gt;
   &lt;p&gt;Ceci est un document de test.&lt;/p&gt;
   &lt;/body&gt;
   &lt;/html&gt;
   ______________________________________________________________________
</pre>
<h2><a name="ss3.2">3.2 Sortie de l'analyseur</a></h2>
<p>La sortie standard du programme nsgmls est une forme
concentr&eacute;e de l'entr&eacute;e SGML que les syst&egrave;mes
de traitement peuvent utiliser comme un analyseur lexical afin de
parcourir la structure du document. Pour les besoins de la
validation, vous pouvez oublier la sortie standard et ne vous
occuper que de l'erreur standard.</p>
<p>Si vous souhaitez avoir la sortie compl&egrave;te, ne
sp&eacute;cifiez pas l'option -s et redirigez la sortie vers un
fichier</p>
<pre>
       % nsgmls -m /usr/sgml/html/catalog &lt;test.html &gt;test.out
</pre>
<h2><a name="ss3.3">3.3 Messages de l'analyseur</a></h2>
<p>Les messages d'erreur et d'avertissement de nsgmls peuvent
&ecirc;tre tr&egrave;s difficiles &agrave; d&eacute;chiffrer. Et
vous trouverez un grand nombre d'erreurs r&eacute;sultant d'un
balisage non-conforme.</p>
<p>Pour rediriger les messages vers un fichier, utilisez l'option
-f :</p>
<pre>
       % nsgmls -s -m /usr/sgml/html/catalog -f test.err &lt;test.html
</pre>
<h2><a name="ss3.4">3.4 Code de retour</a></h2>
<p>L'analyseur indique si le document est conforme au DTD HTML de
deux mani&egrave;res :</p>
<p>Code de retour - l'analyseur renvoit un code de sortie de 0 en
cas de succ&egrave;s, diff&eacute;rent de 0 sinon.</p>
<p>Sortie - si le document est conforme au DTD, la derni&egrave;re
ligne de la sortie standard contient un caract&egrave;re C
unique.</p>
<h2><a name="s4">4. Liens</a></h2>
<p>"HTML Check Toolkit" de HalSoft se trouve &agrave; l'adresse
<a href=
"http://www.halsoft.com/html-tk/index.html">http://www.halsoft.com/html-tk/index.html</a>.</p>
<p>La page de James Clark sur sp se trouve &agrave; l'adresse
<a href=
"http://www.jclark.com/sp.html">http://www.jclark.com/sp.html</a>.</p>
<p>La page du W3C sur la sp&eacute;cification de HTML se trouve
&agrave; l'adresse <a href=
"http://www.w3.org/hypertext/WWW/MarkUp/html-spec/">http://www.w3.org/hypertext/WWW/MarkUp/html-spec/</a>.</p>
</body>
</html>