WebSitePP : Pré-processeur HTML

Comment structurer mon site avec des sous-répertoires ?
Il suffit de les indiquer dans le nom de la page.
La page "Toto" sera à la racine du site, la page "SousRep/Toto" sera dans le sous-répertoire "SousRep".
Note: En utilisant des sous-répertoire, n'oubliez pas la commande RELPATH qui permet de gérer les chemins relatifs à l'intérieur du site.

Quelle est la structure idéale du fichier de description ?
Le fichier d'entrée comporterait seulement des commandes INCLUDE.
Les premiers includes seraient ceux des librairies génériques, puis celles spécifiques au site en cours.
Ensuite viendraient les includes pour définir les pages, un par sujet de page. Ce sont ces fichiers qui contiendrait les tags PAGE, ou les includes vers les fichiers contenant un tag PAGE pour les grandes pages.
Enfin viendraient les déclarations des pages index.html, une par répertoire, contenant une redirection vers une page du répertoire.
Un répertoire peut être consacré au images du site, un autre aux données (fichiers du site téléchargeables...)
Une déclaration de page devrait consister en un appel de macro avec pour paramètres entre autres, le titre, les mots clef, et le contenu de la page. La macro se chargerait de créer l'entête HTML et de placer le contenu au bon endroit.
Une telle structure possède l'énorme avantage de permettre un changement de look de toutes les pages associées juste en changeant la définition de la macro-instruction (elle sépare le contenu et le look, principe de CSS).

Comment faire si mon site n'utilise qu'une langue ?
Il faut déclarer au moins une langue pour le fonctionnement de WebSitePP.
Donc déclarez-en une et oubliez-la ainsi que les balises L...

Comment créer une table avec des lignes de couleurs cycliques ?
Il suffit d'insérer les tests suivants dans une macro appelée à chaque ligne de la table. Le résultat est dans la macro COLOR. Le choix des couleurs dans l'example est #111111, #222222 et #333333.
Pour deux couleurs, un simple test suffit :
<IF EQUAL COLOR #111111> <DEFINE COLOR #222222> <ELSE/> <DEFINE COLOR #111111> </IF>
Pour trois couleurs ou plus, une valeur temporaire est nécessaire (l'ordre des tests est important):
<IF EQUAL COLOR #333333> <DEFINE COLOR temp> </IF>
<IF EQUAL COLOR #222222> <DEFINE COLOR #333333> </IF>
<IF EQUAL COLOR #111111> <DEFINE COLOR #222222> </IF>
<IF EQUAL COLOR temp > <DEFINE COLOR #111111> </IF>

Comment créer un menu dont les items n'ont pas le lien inutile sur la page en cours ?
Il suffit de placer le test suivant autour de la balise <a> ainsi qu'autour de </a>, avec XPAGE la page de la ligne du menu visée par le lien : <IF NEQUAL SELF_PAGENAME XPAGE> <a href...> ou </a> </IF>

Comment avoir une variable/un paramètre au contenu vide, ce qui est utile pour les comportements par défaut ?
Une variable au contenu vide peut être créée par <DEFINE TOTO></DEFINE> mais aucun test ne pourra être effectuer dessus car la commande IF a besoin de détecter la valeur à tester comme une chaine de caractères.
Attention car dans la commande IF, ne pas indiquer de valeur correspond à tester l'existence de la macro, ce qui est différent !
Pour résoudre ce problème, il suffit de donner à la variable/macro une valeur particulière que vous choisissez, par exemple "None".

WebSitePP marche-t-il sous windows ?
Le python étant un langage portable, WebSitePP devrait fonctionner sans problème (ceci dit, aucun essai n'a été fait jusqu'à présent, mais c'est prévu !).
Une contrainte cependant : les chemins devront s'écrire en notation UNIX, c'est à dire en utilisant le caractère "/" à la place de "\".