Un "modèle de page Web" est un fichier de type texte et
dont l'extension est ".pmd". Ce fichier doit être créé
manuellement avec un éditeur de textes tel que le "Bloc-Note"
de Windows (Notepad.exe). Son contenu est similaire à celui
d'un fichier ".ini" de Windows:
- le fichier est divisé en plusieurs sections chacune étant séparée
des autres par son identifiant placé entre crochet; cet identifiant peut être écrit
indifféremment en minuscules, en majuscules ou en mélange de minuscules et de
majuscules; il ne doit pas contenir de caractères accentués.
- chaque section comporte une ou plusieurs lignes dont le contenu
dépend de la section.
- toute ligne commençant par un "point-virgule" est
considérée comme un commentaire et ignorée par le programme
exemple: section [Params]:
[Params]
default=default.htm
index=index.htm
sizemax=150
space=10
maximum=0
individuel=1
reduc=1
Remarque importante: la création d'un
"modèle de page Web" nécessite la connaissance des principes généraux du
langage HTML
Contenu de la section [Params]
Cette section contient les paramètres généraux sous la forme: nom=valeur
- paramètre "default": nom du fichier HTML
à créer dans chaque dossier
- paramètre "index": contient une liste de
fichiers HTML; si l'un de ces fichiers existe dans un dossier, le fichier
"default" ne sera pas créé dans ce dossier et le fichier "default"
du dossier père pointera sur ce fichier au lieu du fichier "default";
- paramètre "sizemax": dimensions maximum
d'une image réduite (vignette)
- paramètre "space": espace entre image
réduite;
- paramètre "maximum": nombre maximum
d'images par dossier; si ce nombre est nul, ce paramètre est ignoré;
- paramètre "individuel": réservé à un
développement futur.
- paramètre "reduc": si différent 0,
demande la création et l'utilisation d'images réduites.
Sections [Entete], [debut_repertoires], [repertoire],
[fin_repertoires], [debut_photos], [photo], [fin_photos], [fin]
Ces sections contiennent le contenu des différentes parties du
fichier HTML créé par le programme:
Section [Entete]:
Cette section contient le début du fichier HTML: elle est appellée
une fois au début de chaque fichier HTML
Section [debut_repertoires]:
Cette section contient dans le fichier HTML le début de la liste
des sous-dossiers: elle est appellée une fois après le début de chaque fichier HTML si
le dossier en cours contient des sous-dossiers.
Section [repertoire]:
Cette section contient dans le fichier HTML la description d'un
sous-dossier: elle est appellée autant de fois que le dossier en cours contient des
sous-dossiers.
Section [fin_repertoires]:
Cette section contient dans le fichier HTML la fin de la liste des
sous-dossiers: elle est appellée une fois dans chaque fichier HTML si le dossier en cours
contient des sous-dossiers.
Section [debut_photos]:
Cette section contient dans le fichier HTML le début de la liste
des images: elle est appellée une fois dans chaque fichier HTML si le dossier en cours
contient des images.
Section [photo]:
Cette section contient dans le fichier HTML la description d'une
image contenue dans le dossier: elle est appellée autant de fois que le dossier en cours
contient d'images.
Section [fin_photos]:
Cette section contient dans le fichier HTML la fin de la liste des
images: elle est appellée une fois dans chaque fichier HTML si le dossier en cours
contient des images.
Section [fin]:
Cette section contient la fin du fichier HTML: elle est appellée
une fois à la fin de chaque fichier HTML
Variables d'environnement
Les différentes sections ci-dessus peuvent (et doivent) utiliser
des variables d'environnement:
- Variable "nphotos": dans toutes les
sections: nombre d'images contenues dans le dossier en cours
- Variable "pathroot": dans toutes les
sections: chemin d'accès au répertoire de départ
- Variable "file": dans la section [Entete]
: chemin d'accès au dossier
- Variable "file": dans la section
[repertoire] : nom du dossier (sans le chemin)
- Variable "dir": dans la section [photo] :
nom du dossier contenant l'image (sans le chemin)
- Variable "file": dans la section [photo] :
nom de l'image (avec extension, sans le chemin)
- Variable "reduc": dans la section [photo]
: nom de l'image réduite (avec extension, sans le chemin)
- Variable "width": dans la section [photo]
: largeur de l'image réduite
- Variable "height": dans la section [photo]
: hauteur de l'image réduite
- Variable "space": dans la section [photo]
: espace minimum entre images
Dans le contenu de chaque section, les variables d'environnement
sont utilisées entourées du caractèr "%" comme dans un fichier de commandes
DOS.
Exemple pour la section [photo]:
<A HREF="%file%"><img SRC="%reduc%"
height=%height% width=%width% HSPACE=%space% VSPACE=%space%></A>
N.B.: Le logiciel est installé avec un exemple de "modèle de
page Web". Ce fichier s'appelle "exemple.pmd" et
se trouve dans le répertoire d'installation du programme. Il est conseillé de ce fichier
dans un de vos dossiers de travail. |