/usr/share/doc/HOWTO/fr-html/HTML-Validation.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for HTML5 for Linux version 5.2.0">
<meta name="GENERATOR" content="LinuxDoc-Tools 0.9.72">
<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ç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
&lt;gregh@sunsite.unc.edu&gt; )
<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 &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é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>
   ______________________________________________________________________
   &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é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 &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 ê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 &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è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>
doc-linux-fr-html 2013.01-3ubuntu1 / usr / share / doc / HOWTO / fr-html / HTML-Validation.html
