Les commandes PTML

2 Les commandes PTML

Les commandes PTML sont les suivantes :

include: permet l'inclusion d'un autre fichier source.
define: crée une nouvelle macro qui sera utilisé comme un raccourci.
undef: supprime la définition d'une macro.
ifdef/ifndef/endif: permettent la production conditionnelle de code HTML.

Une commande PTML doit apparaître seule sur une ligne et être précédée d'un caractère #.

2.1 La commande `#include`

Un texte commun à plusieurs fichiers peut être placé dans un fichier commun (par exemple common.ptml) et inclus dans chacun des fichiers par la commande

#include "common.ptml"

ptml remplace cette ligne par le contenu du fichier common.ptml.

Ce fichier peut contenir d'autres commandes PTML.

Le nom du fichier peut être contenu dans une macro PTML (voir ci-dessous).

2.2 La commande `#define` et l'utilisation des macros

La commande #define permet de définir des macros qui sont des noms auxquels sont associés une valeur. Par exemple

#define MY_EMAIL phm@lifl.fr

définit la macro MY_EMAIL dont la valeur est << phm@lifl.fr >>.

L'utilisation de cette macro, c'est-à-dire la substitution de son nom par sa valeur, est spécifiée dans le texte PTML par l'utilisation de chevrons :

<<MY_EMAIL>>

D'autres choses sont possibles avec les macros :

la valeur de macros peut être définie sur la ligne de commande de ptml (voir section 4) ;
il existe un certain nombre de macros prédéfinies (voir section 5) ;
il est parfaitement légal de trouver plusieurs #define pour une même macro. Il est ainsi possible de changer la valeur d'une macro lors du traitement de différentes parties de vos documents ;
la valeur d'une macro peut elle même contenir le nom d'une autre macro, par exemple :
```
#define MAILTO_ME <a href="mailto:<<MY_EMAIL>>">
```
Notez que les définitions imbriquées sont évaluées lors de leur utilisation et non lors de leur définition. Ainsi, sur l'exemple, il est possible de modifier la valeur de la macro MY_EMAIL après la définition de la macro MAILTO_ME.
la valeur d'une macro non définie est la chaîne vide.

La commande #undef supprime la définition d'une macro :

#undef MY_EMAIL

Si la macro n'existe pas préalablement, la commande ne fait rien.

2.3 Les commandes `#ifdef`, `#ifndef`, et `#endif`

Ces commandes permettent de traiter ou non un bloc de lignes PTML selon qu'une macro PTML est définie ou non. Par exemple,

#ifdef FIL_URL
<A HREF="<<FIL_URL>>">Formations en informatique de Lille</A>
#endif 
#ifndef FIL_URL
Formations en informatique de Lille
#endif

Les constructions #if*def/#endif peuvent être imbriquées.

Le #endif correspondant à un #if*def doit être dans le même fichier source PTML.

2 Les commandes PTML

2.1 La commande #include

2.2 La commande #define et l'utilisation des macros

2.3 Les commandes #ifdef, #ifndef, et #endif

2.1 La commande `#include`

2.2 La commande `#define` et l'utilisation des macros

2.3 Les commandes `#ifdef`, `#ifndef`, et `#endif`