/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 <kmc@specialform.com></h2>
v0.2, 29 Octobre 1995 Traduction française: Thierry
Bé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çais ou en anglais, merci
de contacter <gregh@sunsite.unc.edu> )
<hr>
<em>Cette documentation a pour objet d'expliquer l'utilisation du
programme nsgmls afin de vérifier qu'un document HTML est
conforme à la définition de type de document (ou
"DTD") HTML 2.0. Parmi les définitions de HTML à
partir de SGML, ce DTD est la plus fréquemment
adoptée. Il définit ainsi un sous-ensemble du
balisage HTML correspondant à la pratique courante, ayant
les meilleures chances de portabilité 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ûts et
bénéfices</a></h2>
<p>Vous enrichirez vos documents HTML en utilisant toutes les
capacités de SGML. Mais la validation de vos documents par
référence au DTD HTML a un certain nombre d'avantages
et d'inconvénients, avant tout parce que vous avez affaire
à un dialecte de HTML plus restreint que celui qui est
utilisé actuellement. Les règles "officielles"
spécifiant la structure d'un document en HTML et les
règles concernant le balisage des donné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éduit à un ensemble
normalisé de balises.</p>
<p>Il n'existe pas de DTD couramment accepté qui
reflè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ément utilisés sur le Web autour de
juin 1994. Divers efforts visant à définir un DTD
HTML+ ou HTML 3.0 se trouvent plus ou moins dans une impasse. Et
aucun des DTD en circulation ne reconnaîtra l'ensemble des
balises rendues populaires par des éditeurs de navigateurs
comme Netscape et Microsoft.</p>
<h2><a name="ss1.2">1.2 Pour débuter</a></h2>
<p>Contrairement à 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é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âce à quelques personnes qui s'y sont
consacré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èques) prend un peu de temps, mais pas autant qu'on
pourrait le croire.</p>
<p>Au cas où vous éprouveriez l'envie de lire un
texte d'introduction à 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égré, récupérez <code>HTML
Check Toolkit</code> à 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énient du logiciel HalSoft est qu'il
utilise le vieil analyseur sgmls, qui produit des messages d'erreur
parfois (encore) plus difficiles à comprendre que ceux de
nsgmls.</p>
<p>J'ai utilisé 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é
<code>sp</code>, qui contient un analyseur et un validateur SGML,
nsgmls (c'est le successeur de l'analyseur sgmls, longtemps
considéré comme le programme de
réfé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élécharger directement depuis
<a href=
"ftp://ftp.jclark.com/pub/sp/">ftp://ftp.jclark.com/pub/sp/</a>.</p>
<p>Vouz pouvez peut-être aussi récupérer des
fichiers exécutables pour votre plateforme. Ou bien
télécharger le code source, et dans ce cas suivez les
instructions du fichier README pour lancer make.</p>
<p>Il serait utile de créer un répertoire public au
sommet de la hiérarchie, pour y mettre les fichiers relatifs
à SGML. Par exemple, sur mon PC Linux, j'ai plusieurs
ré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élécharger les
spécifications de HTML</a></h2>
<p>Le projet de norme HTML 2.0 contient le fichier de
définitions SGML dont vous aurez besoin pour utiliser
l'analyseur, c'est-à-dire le DTD (Document Type Definition),
la déclaration SGML, et le catalogue d'entité. Vous
pouvez obtenir le texte public de HTML 2.0 à 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éléchargez et installez les fichiers suivants
:</p>
<ul>
<li>DTD : html*.dtd</li>
<li>Déclaration SGML : html.decl</li>
<li>Catalogue d'entités : catalog</li>
</ul>
<p>Vous pouvez ajouter deux entrées au catalogue des
entité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éer un second catalogue contenant
ces entrées. Vous passerez ensuite ce catalogue à
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 <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ée de l'analyseur</a></h2>
<p>Votre document doit être conforme à la norme SGML,
ce qui signifie, entre autres, que le type de document doit
être déclaré au début de l'entrée
(vous pouvez contourner cette règle en spécifiant
cette information sur la ligne de commande de nsgmls).</p>
<p>Voici un document HTML simple, qui peut être
analysé sans erreur en suivant les règles que j'ai
décrites :</p>
<pre>
______________________________________________________________________
<!doctype html public "-//IETF//DTD HTML 2.0//EN">
<html>
<head>
<title>Document HTML simple.</title>
</head>
<body>
<h1>Document de test</h1>
<p>Ceci est un document de test.</p>
</body>
</html>
______________________________________________________________________
</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ée de l'entrée SGML que les systè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ète, ne
spécifiez pas l'option -s et redirigez la sortie vers un
fichier</p>
<pre>
% nsgmls -m /usr/sgml/html/catalog <test.html >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
être très difficiles à déchiffrer. Et
vous trouverez un grand nombre d'erreurs ré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 <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ères :</p>
<p>Code de retour - l'analyseur renvoit un code de sortie de 0 en
cas de succès, différent de 0 sinon.</p>
<p>Sortie - si le document est conforme au DTD, la dernière
ligne de la sortie standard contient un caractère C
unique.</p>
<h2><a name="s4">4. Liens</a></h2>
<p>"HTML Check Toolkit" de HalSoft se trouve à 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 à 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écification de HTML se trouve
à 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>
|