Constituants d'une page DIML

Une page DIML est composée de trois grandes entités.

Le contenu propre

Comme nous venons de le voir, un document DIML est avant tout un document HTML. Il dispose donc d'un contenu propre écrit comme un fichier HTML. Ce contenu part du premier caractère du fichier et finit au dernier caractère du fichier en sautant toutes les déclarations de templates.

Le contenu peut intégrer tous les constituants d'un fichier HTML standard, y compris scripts et autres objets "clients", ainsi que des instructions DIML qui seront traitées par le processeur ESSI pour former un HTML standard.

Pour des raisons d'implémentation, il est IMPERATIF que le document recevant la syntaxe DIML soit bien formé au sens du SGML, c'est à dire dispose d'une section <HEAD> ... </HEAD> et d'une section <BODY> ... </BODY> ou <FRAMESET> ... </FRAMESET>

Les déclarations de templates

Les déclarations de templates sont toutes effectuées par une syntaxe étendue du HTML :

<TEMPLATE ID="TemplateName">
<br>
<H1>Template content (is DIML!)</H1>
<br>
</TEMPLATE>

Conceptuellement, on peut dire qu'il s'agit d'une extension des éléments de structure HEAD et BODY qui permet de définir des morceaux de HTML "en marge" du document principal. Ces morceaux pourront alors être utilisés ou pas dans le document représenté par la page DIML elle-même.

Les instructions DIML

Les instructions DIML sont au sens propre des instructions d'injection. Elle permettent de rappeler des templates et bien d'autres choses. Leur traitement par le processeur renvoie une séquence de HTML, éventuellement vide, appelée contrepartie de l'instruction.

L'instruction DIML est caractérisée par son couple d'ouverture-fermeture <% ... %> et peut être :

Une instruction d'appel de variable.
Une instruction de structure du DIML.

La suite du tutorial expose toutes les différentes instructions et leurs utilisations possibles.

Un exemple visuel

L'exemple fourni ici visualise le source DIML de l'accueil du parcours 1 en séparant par des couleurs les différents composantes du fichier.

Voir l'exemple

On y distingue très nettement les trois constituants du source :

en jaune pâle, le HTML de base
en violet, les déclarations de templates, hors de la séquence principale
en vert, la syntaxe d'appels DIML.

précédent sommaire suivant

All material is copyleft V.G. FREMAUX (EISTI France) 1999 to 2003 except explicitly mentioned