WebSitePP : Pré-processeur HTML

Soporifique pour les novices, cette page fournit cependant aux utilisateurs réguliers les comportements précis des tags de WebSitePP.

<PAGE NomDeLaPage>
Déclare la page web appelée NomDeLaPage.
Ce tag doit être terminé par </PAGE>.
NomDeLaPage peut contenir les caractères alphanumériques ainsi que "_" et "/".
NomDeLaPage peut contenir un chemin avant le nom de page. L'extension (".html" par défault) est ajoutée automatiquement lors de la génération des pages, c'est pourquoi il est interdit d'en déclarer une dans le nom de page.
Un tag PAGE ne peut pas être contenu dans un autre tag.
Les modifications de macro-instruction (ou variable) à l'intérieur d'une page ne sont pas visibles dans les autres pages.

<DEFINELANG NomDeLaLangue />
Déclare une langue ayant pour label NomDeLaLangue.
Ce tag est solitaire, (pas de terminaison </DEFINELANG>). Une utilisation sans le "/" final est cependant supporté.
NomDeLaLangue peut contenir les caractères alphanumériques ainsi que ".", "-", "_", "#" et "/".
Sauf la première, les langues déclarées modifient le nom de fichier généré pour une page, en y ajoutant leur nom.
Un tag DEFINELANG ne peut pas être contenu dans un autre tag.

<L NomDeLaLangue>
Le contenu de ce tag apparait uniquement dans la page pour la langue NomDeLaLangue.
Ce tag doit être terminé par </L>.
NomDeLaLangue peut contenir les caractères alphanumériques ainsi que "." et "/".
NomDeLaLangue doit avoir été déclaré au préalable comme une langue supportée.
Un tag L doit être à l'intérieur d'un tag PAGE, directement ou non.

<DEFINE NomDeLaMacro> ou
<DEFINE NomDeLaMacro Valeur />
Définit le contenu de la macro-instruction NomDeLaMacro.
NomDeLaMacro peut contenir les caractères alphanumériques majuscules ainsi que "_".
Sans second argument, ce tag doit être terminé par </DEFINE>.
Avec second argument, ce tag est solitaire, (pas de terminaison </DEFINE>) et la valeur de la macro-instruction est Valeur. Une utilisation sans le "/" final est cependant supporté. Cet appel se comporte comme une affectation de variable de type chaine de caractère. Valeur peut contenir les caractères alphanumériques ainsi que ".", "-", "_", "#" et "/".
Il peut se placer à n'importe quel endroit. Cependant, sa définition ou modification à l'intérieur d'une page ne se verra pas à l'extérieur. Ce comportement est compatible avec le "ifndef then define" par page pour y éviter les définitions multiples.
L'évaluation de la macro se fait au moment de la création de la page pour une langue donnée.

<USEPARAM NumeroParametre />
Ce tag ne se place qu'à l'intérieur d'un tag DEFINE.
Ce tag est solitaire, (pas de terminaison </USEPARAM>). Une utilisation sans le "/" final est cependant supporté.
Il est remplacé par le paramètre numéro NumeroParametre donné lors de l'appel de la macro.
NumeroParametre est un nombre. Le premier paramètre est le numéro zéro.

<PARAM>
Ce tag définit la valeur d'un paramètre lors de l'appel d'une macro.
Il doit être terminé par </PARAM>.
Il se place juste après et au même niveau hiérarchique que l'appel de la macro ( <TOTO> <L fr> <PARAM> param </PARAM> </L> est incorrect).
Sa quantité doit être compatible avec les valeurs du tag USEPARAM utilisées lors de la définition de la macro.
Il peut, entre autres, contenir des appels de macros, des tags USEPARAM si l'appel est dans une définition de macro, ...

<RELPATH NomDeFichier />
Pour NomDeFichier donné par rapport à la racine du site, ce tag est remplacé par le nom de fichier par rapport au répertoire de la page en cours.
Ce tag est solitaire, (pas de terminaison </RELPATH>). Une utilisation sans le "/" final est cependant supporté.
Si NomDeFichier prend la valeur spéciale USEPARAMn avec n un nombre, alors le nom de fichier sera la valeur du paramètre n (ceci est valable sous un tag DEFINE). Ceci compense l'interdiction de mettre un tag WebSitePP à l'intérieur de la balise d'un autre tag WebSitePP ( <TOTO <TITI> > est incorrect).

<PAGEFILENAME NomDeLaPage NomDeLaLangue />
Ce tag est remplacé par le nom de fichier de la page indiquée avec la langue indiquée, par rapport au répertoire de la page en cours.
Ce tag est solitaire, (pas de terminaison </PAGEFILENAME>. Une utilisation sans le "/" final est cependant supporté.
Le résultat prend en compte le préfixe et le suffixe des fichiers.
Si NomDeLaPage prend la valeur spéciale SELF, alors le nom de fichier est celui de la page courante.
Si NomDeLaPage prend la valeur spéciale USEPARAMn avec n un nombre, alors le nom de fichier sera la valeur du paramètre n (ceci est valable sous un tag DEFINE). Ceci compense l'interdiction de mettre un tag WebSitePP à l'intérieur de la balise d'un autre tag WebSitePP.
Si NomDeLaLangue prend la valeur spéciale SELF, alors le nom de la langue est celui de la langue courante.
Si NomDeLaLangue prend la valeur spéciale USEPARAMn avec n un nombre, alors le nom de la langue sera la valeur du paramètre n (ceci est valable sous un tag DEFINE). Ceci compense l'interdiction de mettre un tag WebSitePP à l'intérieur de la balise d'un autre tag WebSitePP.
Le noms de fichier de page pour la première langue déclarée est composé du préfixe ("Site/" par défaut), du nom de la page et du suffixe (".html" par défaut).
Les noms de fichier de page pour les langues suivantes est composé du préfixe, du nom de la page, de "_" suivi du nom de la langue, puis du suffixe.

<IF TypeDeTest NomDeLaMacro> ou
<IF TypeDeTest NomDeLaMacro Valeur>
Cette commande permet l'inclusion conditionnel de texte.
Elle doit être terminé par </IF>.
TypeDeTest doit prendre l'une des deux valeurs EQUAL ou NEQUAL.
La valeur de la macro NomDeLaMacro donne le premier terme du test.
Si Valeur est présente (chaine de caractère sans espace), elle est le second terme du test. Si elle n'est pas présente, le test est un test d'existence ou non de la définition de la macro (équivalent de ifdef et ifndef).
Si le test est satisfait (égalité ou inégalité), alors le contenu du tag est gardé, sinon il est ignoré. La présence d'un tag <ELSE/> (<ELSE> toléré) à l'interieur du tag IF délimite deux parties de texte. Si le test est vrai, la première partie est gardée, sinon la deuxième.
Si NomDeLaMacro prend la valeur spéciale SELF_PAGENAME, alors la valeur du premier terme est le nom de la page courante.
Si NomDeLaMacro prend la valeur spéciale SELF_LANG, alors la valeur du premier terme est le nom de la langue courante.
Si NomDeLaMacro prend la valeur spéciale USEPARAMn avec n un nombre, alors la valeur du premier terme est celle du paramètre n. Ceci est valable sous un tag DEFINE, et fonctionne aussi pour le test d'existence.
Si Valeur prend la valeur spéciale USEPARAMn avec n un nombre, alors la valeur du second terme est celle du paramètre n (ceci est valable sous un tag DEFINE)

<INCLUDE NomDeFichier />
Cette commande inclut le fichier de description NomDeFichier dans le fichier de description appelant.
Le répertoire de départ est l'endroit d'où l'outil a été lancé.
Ce tag est solitaire, (pas de terminaison </INCLUDE>. Une utilisation sans le "/" final est cependant supporté.
Un fichier inclu peut inclure à son tour.
Ce tag se place en dehors des tags PAGE et DEFINE.
Il est conseillé d'utiliser cette fonctionnalité pour séparer les librairies de macros génériques (HTML, Javascript, ...), les librairies de macros spécifiques au site, et les pages du site. Dans l'idéal, le fichier d'entrée n'est composé que de tags INCLUDE.

/ * Commentaires * /
La signalisation des commentaires est identique à celle du langage C.
Tout texte compris entre / * et * / ne sera pas traité, quelque soit son nombre de ligne.
Un commentaire peut commencer et s'arrêter n'importe où, même dans un tag WebSitePP.