Le langage SGML/Commentaires
Les commentaires sont utiles pour expliquer la syntaxe ou le contenu sans que les explications appartiennent au contenu du document.
Syntaxe
[modifier | modifier le wikicode]Leur syntaxe est basée sur celles des balises spéciales en encadrant le texte du commentaire entre <!--
et -->
.
Exemple :
<!-- Un commentaire simple. -->
Cette syntaxe est aussi utilisée en HTML et XML.
Cependant la syntaxe est plus complexe : les commentaires commencent et se terminent par un double tiret à l'intérieur de la déclaration des types de document SGML, comme dans l'exemple ci-dessous qui est un extrait de la déclaration du type des documents XML :
<!SGML "ISO 8879:1986 (WWW)"
-- SGML Declaration for XML 1.0 --
-- from:
Final text of revised Web SGML Adaptations Annex (TC2) to ISO 8879:1986
ISO/IEC JTC1/SC34 N0029: 1998-12-06
Annex L.2 (informative): SGML Declaration for XML
changes made to accommodate validation are noted with 'VALID:'
--
CHARSET
BASESET "ISO Registration Number 177//CHARSET
ISO/IEC 10646-1:1993 UCS-4 with implementation
level 3//ESC 2/5 2/15 4/6"
--
...
--
!>
L'exemple ci-dessus contient 3 commentaires mis en évidence dans la déclaration entre <!
et !>
.
Cette syntaxe, légale en SGML, mais interdit l'utilisation d'une séquence de tirets dans les commentaires en XML et HTML.