Afin de pouvoir insérer les valeurs de certaines variables d’environnement au cours du processus d’évaluation, le générateur de document fournit plusieurs fonctions qui peuvent être utilisées dans des définitions d’entité ou des modèles :
&base(file);
supprime l’information du chemin d’accès et l’extension à partir
du fichier de spécification.
Exemple :
&base(/home/bscw/www/faq.dtm);
résultats à faq
&rel(path);
génère un nom de chemin
relatif à partir d’un nom de chemin absolu. Le nom du chemin d’accès généré est
relatif au document qui sera généré (défini dans le paramètre d’évaluation
document).
Exemple : Si l’expression
&rel(/Images);
est utilisé dans un modèle, ceci génère le
document /faq/index.htm
, cette expression sera évalué à
../Images
. Si quelqu’un utilise la même expression dans un modèle
qui génère le document /faq/question/ install.htm
, il sera évalué à
../../Images
.
&size(file, [B|K|M|G]);
retourne la
taille d’un fichier en octets, kilooctets, mégaoctets or giga-octets,
dépendamment de la valeur du second paramètre.
Exemple :
&size(/Download/bscw34.exe, M);
résultats à
8.43
&date(format);
retourne la date courante et l’heure. Les directives suivantes
peuvent être utilisées dans le format chaîne de caractères. Ils sont ici
affichés sans les spécifications optionnelles de largeur de champ et de
précision.
Directive |
Sens |
|
Nom abrégé du jour de la semaine des paramètres régionaux. |
|
Nom complet du jour de la semaine des paramètres régionaux. |
|
Nom abrégé du mois des paramètres régionaux. |
|
Nom complet du mois des paramètres régionaux. |
|
Représentation appropriée de la date et de l’heure des paramètres régionaux. |
|
Jour du mois comme un nombre décimal [01, 31]. |
|
Heure (horloge 24-heure) comme un nombre décimal [00, 23]. |
|
Heure (horloge 12-heure) comme un nombre décimal [01, 12]. |
|
Jour de l’année comme un nombre décimal [001, 366]. |
|
Mois comme un nombre décimal [01, 12]. |
|
Minute comme un nombre décimal [00, 59]. |
|
Équivalent d’AM ou PM des paramètres régionaux. |
|
Seconde comme un nombre décimal [00, 61]. |
|
Numéro de semaine de l’année (Dimanche comme le premier jour de la semaine) comme un nombre décimal [00, 53]. Tous les jours de l’année précédant le premier dimanche appartiennent à la semaine 0. |
|
Jour de la semaine comme un nombre décimal [0 (Dimanche), 6]. |
|
Numéro de la semaine de l’année (Lundi comme premier jour de la semaine) comme un nombre décimal [00, 53]. Tous les jours de l’année précédant le premier lundi font partie de la semaine 0. |
|
Représentation appropriée de la date dans les paramètres régionaux. |
|
Représentation appropriée de l’heure dans les paramètres régionaux. |
|
Année sans le siècle comme un nombre décimal [00, 99]. |
|
Année avec le siècle comme un nombre décimal. |
|
Nom du fuseau horaire (ou chaîne vide si le fuseau horaire n’existe pas). |
|
Le caractère
|
Exemple : Le 10 octobre 2005, le résultat de
&date(%B %Y);
est octobre 2005
.