### Doctype

Exemple : une page html
<!DOCTYPE html> <html lang="fr"> <head> <meta charset="utf-8"> <title>Exemple de page</title> </head> <body> <p>Je suis un exemple de document HTML.</p> <p><img src="info.png">C'est le <a href="http://w3c.org">W3C</a> qui définit les balises.</p> </body> </html>

Vous avez sans doute remarqué que la première ligne du code HTML est un peu spéciale dans le sens ou sa syntaxe ne correpond pas tout à fait un celle d'une balise. Cette ligne particulière est ce qu'on appelle une déclaration de doctype (ie type de document). C'est un héritage de SGML, l'ancêtre de HTML. Cette déclaration est importante dans le sens où elle va garantir que le code HTML qui suit est (normalement) conforme au standard HTML5 (toujours en cours de définition). Le navigateur va donc faire l'analyse syntaxique de ce code (parsing) en appliquant les règles définies dans ce standard. L'utilisation de cette doctype, vous garantira une certaine homogénéité dans le résultat de cette analyse par les différents navigateurs du marché et donc un rendu du code à peu près semblable partout.

Vous devez utiliser une déclaration de type de document pour chacun de vos document HTML.

Une déclaration de type de document se fait avec le code
`<!DOCTYPE html>`

Cette déclaration DOIT être placée au tout début du code, sans être précédée d'espaces ou de sauts de lignes.

La déclaration n'est pas sensible à la casse et peut être écrite en majuscule, en minuscule, ou dans un mélange des deux.

Quirks mode
Le "mode quirks" (bizarre) sera utilisé par les navigateurs pour interpréter du code HTML qui n'aurait pas de déclaration de DOCTYPE. En résumé, le navigateur va traiter le code avec les bugs d'interprétation qu'il pouvait avoir jusqu'au début des années 2000. A éviter absolument.
What happens in quirks mode?

### Commentaires

Une autre balise utilise une syntaxe un peu particulière : c'est la balise permettant de faire des commentaires. Le contenu des commentaires n'est pas affiché par le navigateur et on peut donc les utiliser soit pour donner des précisions sur le code HTML (usage normale d'un commentaire), mais plus souvent pour tester le rendu d'une page avec une variante. Dans ce cas on entoure le code "version 1" avec des balises de commentaires et on ecrit le code "version 2" pour voir ce qu'il donne. Si on n'est pas satisfait du résultat, on peut facilement revenir à la "version 1" en décommentant la portion de code (et en supprimant la "version 2").

Un commentaire est composé de la façon suivante :

- la simili balise d'ouverture `<!--`
- un espace
- le contenu du commentaire
- un espace
- la simili balise de fermeture `-->`

Exemple : commentaires
<!DOCTYPE html> <html> <!-- En-tête du document HTML --> <head> <title>Exemple de commentaires</title> </head> <!-- Corps du document HTML --> <body> <!-- Paragraphe simple --> <p>Je suis un exemple de document HTML.</p> <!-- Paragraphe avec du contenu imbriqué --> <p><img src="info.png">C'est le <a href="http://w3c.org">W3C</a> <!-- Commentaire -->qui définit les balises.</p> </body> </html>

Comme on le voit dans l'exemple précédent, les commentaires peuvent être placés n'importe où dans le code HTML.

Exemple : masquage de code
<!DOCTYPE html> <html lang="fr"> <head> <meta charset="utf-8"> <title>Exemple de masquage de code</title> </head> <body> <p>Je suis un exemple de document HTML.</p> <!-- Paragraphe mis en commentaire <p><img src="info.png">C'est le <a href="http://w3c.org">W3C</a> qui définit les balises.</p> --> <p>C'est François Piat qui définit les balises.</p> </body> </html>