*** A Traduire ***
Les commentaires suivent une syntaxe SGML et ne sont normalement autorisés que dans une DTD. Cependant comme la Section 3.4, « Revenir au SGML » le montre, il est possible d'inclure du SGML dans vos documents.
Les délimiteurs pour les commentaires SGML sont constitués de la
chaîne de caractères “--
”. Une première
occurence ouvre le commentaire, et la seconde le ferme.
<!-- C'est le texte du commentaire --> <!-- C'est un autre commentaire --> <!-- Voici une façon de mettre un commentaire sur plusieurs lignes --> <!-- Voici une autre façon -- -- de le faire -->
Si vous avez déjà utilisé HTML auparavant, on vous a peut-être
donné des règles différentes pour les commentaires. En particulier, vous
pensez peut-être qu'ils commencent par <!--
et
ne se terminent qu'avec -->
.
Ce n'est pas le cas. Les analyseurs syntaxiques de nombreux navigateurs sont défectueux et acceptent cette syntaxe. Ceux qu'utilisent le Projet de Documentation sont plus rigoureux et rejetteront les documents qui comportent cette erreur.
>!-- C'est en commentaire -- CE N'EST PAS EN COMMENTAIRE! -- retour au commentaire -->
L'analyseur SGML traitera cela comme s'il trouvait :
<!CE N'EST PAS EN COMMENTAIRE>
Ce qui n'est pas du SGML valide et donnera des messages d'erreur source de confusion.
<!----- C'est un très mauvaise idée ----->
Comme l'exemple le suggère, ne mettez pas de commentaires de ce type.
<!--===================================================-->
C'est une (légèrement) meilleure idée, mais c'est toute de même une source de confusion potentielle pour les débutants en SGML.
Ce document, ainsi que d'autres peut être téléchargé sur ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
Pour toutes questions à propos de FreeBSD, lisez la
documentation avant de contacter
<questions@FreeBSD.org>.
Pour les questions sur cette documentation, contactez
<doc@FreeBSD.org>.