Les commandes AHP

2 Les commandes AHP

Les commandes AHP 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.
#openfile/#closefile: marquent le début et la fin de production du code HTML.

Une commande AHP doit apparaître seule sur une ligne, toutes les commandes AHP débutent par un caractère #.

Parmi les lignes d'un fichier AHP qui ne correspondent pas à des commandes, on distingue :

celles comprises entre un #openfile et un #closefile. Elles sont lues comme du code HTML et sont produites dans le fichier destination une fois les substitutions de macros réalisées ;
celles situées hors un bloc #openfile/#closefile. Elles sont ignorées.

2.1 La commande `#include`

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

#include "common.ahp"

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

Ce fichier peut contenir d'autres commandes AHP.

Le nom du fichier peut être contenu dans une macro AHP (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 AHP 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 ahp (voir section 3) ;
il existe un certain nombre de macros prédéfinies (voir section 4) ;
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.
l'utilisation d'une macro non définie provoque une erreur.

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 ou produit un avertissement (warning).

2.3 Les commandes `#openfile` et `#closefile`

Un couple de commande #openfile/#closefile détermine un bloc de lignes qui vont produire un fichier HTML.

En particulier, les lignes précédant la commande #openfile peuvent définir les macros OUTPUT_DIR et EXTENSION qui vont identifier le nom du fichier HTML qui devra être créé (voir les sections 4.3 et 4.4).

Il est possible de trouver plusieurs paires de commandes #openfile/#closefile dans un fichier AHP, mais elle ne doivent pas être imbriquées.

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

Ces commandes permettent de traiter ou non un bloc de lignes AHP selon qu'une macro AHP 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 AHP.

2 Les commandes AHP

2.1 La commande #include

2.2 La commande #define et l'utilisation des macros

2.3 Les commandes #openfile et #closefile

2.4 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 `#openfile` et `#closefile`

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