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.

 
Retour article précédent
Retour à l'Index général de l'aide en ligne