wml - En ligne dans le Cloud

PROGRAMME:

Nom

WML - Langage META du site Web

VERSION

2.0.12 (16-Avr-2008)

SYNOPSIS

wml [-I PATH] [-i PATH] [-D Nom=STR] [-D Nom~PATH] [-n] [-r] [-O niveau] [-o
[SLICTERM":"]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [fichier d'entrée]

wml [-V [NUM]] [-h]

DESCRIPTION

C'est le programme de contrôle du Site Web BUT Langue (WML), une génération HTML gratuite
boîte à outils pour Unix, composée en interne de 9 langages indépendants.

L'idée principale de WML est un schéma de filtrage séquentiel où chaque langage fournit l'un des
9 passes de traitement. Donc wml lit fichier d'entrée (ou de Stdin if fichier d'entrée est un tiret ou
complètement manquant), applique les passes 1-9 (ou seulement les passes spécifiées par -p) et enfin
produit un ou plusieurs fichier de sorties.

Pour plus de détails sur ce schéma de traitement, lisez le WML Introduction sous wml_intro(7)
et par WML Tutorial sous tutoriel_wml (7).

OPTIONS

-I, --include=PATH
Ajoute un annuaire à la liste des chemins d'accès utilisateur. Utilisez cette option pour définir le temps d'exécution
environnement pour le pass 1. Voir wml_p1_ipp(3) pour plus de détails.

-i, --includefile=PATH
Pré-charge un notamment filet, c'est-à-dire ajoute virtuellement un

#inclure "CHEMIN"

Au sommet de fichier d'entrée. Utilisez-le pour inclure automatiquement les fichiers d'inclusion par défaut de l'utilisateur.
Si vous souhaitez inclure un fichier d'inclusion système, vous devez entourer le PATH avec angle
crochets, par exemple utilisez ``"-i" " "'' pour inclure le fichier foo/bar.wml
du système comprennent la zone. Alternativement, vous pouvez utiliser la syntaxe spéciale
``"wml::foo::bar"'' comme avec la directive "#use".

-D, --définir=Nom=STR
Définit une variable interpolable en passe 1 (IPP) via "$(NAME)", en passe 2
(mp4h) via <"get-var NAME">, en pass 3 (ePerl) via "<:=$NAME:>" et en pass 4 (GNU m4)
via "m4_NAME". Une variante spéciale --définir=Nom=FNUD fait le contraire, il supprime
définitions précédentes (qui peuvent être différentes de la non-définition de ces variables, par exemple
avec des variables définies par le système).

-D, --définir=Nom~PATH
Similaire à ce qui précède mais définit une variable contenant un nom de chemin qui est ajusté automatiquement
(voir ci-dessous). Elle peut être interpolée de la même manière que la variante "NAME=STR" de
au dessus.

-n, --noshebang
Cela force WML à ignorer une ligne shebang éventuellement contenue dans fichier d'entrée. C'est
généralement utilisé par WMk, car WMk a déjà analysé cette ligne et fourni les options à
WML.

-r, --norcfile
Cela force WML à ignorer tout .wmlrc fichiers.

-c, --nocd
Lorsque WML traite un fichier d'entrée d'un autre répertoire, il saute dans ce répertoire
avant l'analyse .wmlrc fichiers et revenir au répertoire actuel après. Si cette option
est défini, aucun changement de répertoire n'est effectué et .wmlrc les fichiers sont lus par rapport au courant
directeur de travail.

-O, --optimiser=NUM
C'est l'option d'optimisation qui est passée directement au pas 8 (htmlfix). Il
contrôle la quantité d'optimisation/dépouillement qui est appliquée au code HTML généré
code de balisage.

-o, --fichierdesortie=SLICTERM:fichier de sortie[@CHMODOPT]
Cela redirige la sortie vers un fichier. Habituellement, le fichier entier sera envoyé à Stdout
(identique à "TOUS :-"). Vous pouvez utiliser cette option plus d'une fois pour sortir vers plus d'un
fichier tout en utilisant le SLICTERM comme terme de la théorie des ensembles de tranches pour déterminer
le contenu sera inclus dans chaque fichier de sortie particulier. L'optionnel CHMODOPT is
destiné à spécifier des options pour une application finale chmod commander. Par exemple utiliser
``"u+x"'' pour créer un fichier avec le bit d'exécution défini (fonction XBitHack d'Apache).
See tranche(1) pour plus de détails.

-P, --prologue=PATH
Exécute un filtre prologue sur le fichier d'entrée. Ce programme reçoit les données sur lesquelles agir
comme STDIN et doit produire les données filtrées sur STDOUT.

-E, --épilogue=PATH
Exécute un programme d'épilogue sur les fichiers de sortie finalement obtenus. Actuellement le
les programmes spécifiques à WML suivants sont connus : infos html, lien, rangé ainsi que Weblint. Mais
vous pouvez spécifier n'importe quel programme disponible dans votre "PATH". Ce programme reçoit
le fichier sur lequel agir en tant que premier argument de ligne de commande. Notez que la sortie n'est pas
redirigé vers ce fichier, vous devez donc utiliser un wrapper ou des drapeaux spécifiques au programme si vous
voulez modifier les fichiers de sortie.

-t, --régler le temps
Cela définit l'heure de modification de tous les fichiers de sortie à l'heure de modification de
fichier d'entrée plus 1 seconde. Ceci est utile car les serveurs Web généreront
les en-têtes "Dernière modification" et là le temps d'édition est plus important que le
Temps de génération. Le décalage de 1 seconde est pour les dépendances des Makefiles.

-M, --dépendre[=OPTIONS]
Sortez une règle appropriée pour `make' décrivant les dépendances de chaque fichier de sortie, comme
`gcc' le fait. Il n'a de sens que lorsque le -o option est utilisée. Aucun traitement n'est effectué
sauf pour le premier passage.

La D L'option flag écrit la règle dans un fichier de dépendance. Le nom de ce fichier est
obtenu en remplaçant le suffixe du fichier de sortie par ".d".

La M L'option flag supprime les fichiers système de la liste des dépendances.

-p, --passe=STR
Spécifie lesquelles des passes décrites ci-dessus sont réellement appliquées lors de l'exécution. Les
argument STR est une liste de numéros de laissez-passer séparés par des virgules avec un cas particulier : vous pouvez
écrivez "XY" pour toutes les passes "X...Y". Lorsque le pass 9 ne fait pas partie de STR la résultante
la sortie est écrite dans SORTIE STD. La valeur par défaut est la chaîne ``"1-9"''.

-W, --passoption=NUM,STR
Définir l'option STR pour le laissez-passer NUM.

-s, --en sécurité
Cela désactive certains hacks Perl dans WML qui accélèrent le traitement en réduisant le
bifurquer au-dessus de la tête lors de l'exécution des différentes passes.

Sans cette option, WML précompile les passes 1,5,6,7,8 (qui sont écrites en Perl !)
dans un espace de noms différent de l'interpréteur Perl en cours d'exécution au lieu de
les exécuter en externe via "system()". L'effet est que ces programmes sont exécutés à partir de
dans le même interpréteur Perl économisant ainsi cinq "fork()" gourmands en temps et en CPU.
Le gain réel est compris entre 2 et 4 secondes de temps de traitement. Bien que l'expérience
a montré que cela fonctionne très bien, le problème théorique est toujours que cette approche est
quelque peu risqué en raison des conflits internes de variables Perl.

Utilisez cette option pour désactiver ces accélérations en forçant WML à utiliser le "fork()" sécurisé
approche.

-v, --verbeux[=NUM]
Cela définit le mode verbeux (de 1 à 9) où certaines informations de traitement seront données
sur la console. Utile pour le débogage. Cette option est également transmise à certains des
programmes de filtrage. Par défaut, il n'y a pas de verbosité et juste -v veux dire -v1.

-q, --silencieux
Cela définit le mode silencieux où l'accessoire de traitement n'est plus affiché. Utilisez ceci
option lors de l'exécution wml comme un travail par lots. Cette option est automatiquement forcée lorsque
fichier d'entrée est manquant. Ensuite, WML lit automatiquement à partir de Stdin en mode silencieux.

-V, --version[=NUM]
Donne la chaîne d'identification de la version et la clause de non-responsabilité (pas de NUM or NUM >= 1), le WML
informations de construction (NUM >= 2) et les informations de compilation Perl (NUM >= 3). Utilisez ceci
option pour obtenir une brève description de votre système WML installé, en particulier lorsque
signaler les bogues à l'auteur.

-h, --Aidez-moi
Imprime la page de résumé d'utilisation.

ENVIRONNEMENT

DÉFINI VARIABLES
Les variables suivantes sont toujours définies par wml sous runtime et sont généralement
interpolé via <"get-var NAME"> dans le Pass 2 et via $NAME dans le Pass 3.

WML_SRC_DIRNAME
Le répertoire de travail actuel d'où wml a été commencé. Un système de fichiers Unix absolu
chemin.

WML_SRC_FILENAME
Le nom du fichier d'entrée à partir de la ligne de commande. Utile lors de la course wml sur une masse de
les fichiers et les fichiers d'inclusion doivent déterminer dans lequel ils sont inclus.

WML_SRC_BASENAME
Le nom de base du fichier d'entrée, c'est-à-dire le "WML_SRC_FILENAME", mais avec l'extension
déjà dépouillé.

WML_SRC_TIME
L'heure de la dernière modification de fichier d'entrée au format "heure()". Pieds de page intérieurs utiles
lorsqu'un format de date personnalisé est nécessaire.

WML_SRC_CTIME
L'heure de la dernière modification de fichier d'entrée au format "ctime()". Pieds de page intérieurs utiles
inclure des fichiers.

WML_SRC_ISOTIME
L'heure de la dernière modification de fichier d'entrée au format ISO "aaaa-mm-jj hh:mm:ss". Utile
les pieds de page intérieurs incluent des fichiers.

WML_SRC_USERNAME
Le nom d'utilisateur Unix de l'utilisateur qui possède fichier d'entrée.

WML_SRC_REALNAME
Le vrai nom de l'utilisateur qui possède fichier d'entrée.

WML_GEN_TIME
L'heure actuelle de génération au format "time()". Pieds de page intérieurs utiles lorsque
un format de date personnalisé est nécessaire.

WML_GEN_CTIME
L'heure actuelle de génération au format "ctime()". Les pieds de page intérieurs utiles incluent
fichiers.

WML_GEN_ISOTIME
L'heure actuelle de génération au format ISO "aaaa-mm-jj hh:mm:ss". Utile à l'intérieur
les pieds de page contiennent des fichiers.

WML_GEN_USERNAME
Le nom d'utilisateur Unix de l'utilisateur qui exécute le wml processus.

WML_GEN_REALNAME
Le vrai nom de l'utilisateur qui exécute le wml processus.

WML_GEN_HOSTNAME
Le nom de l'hôte sur lequel le wml la commande s'exécute.

WML_LOC_PREFIX
Le préfixe d'emplacement où WML a été installé au moment de la construction.

WML_LOC_BINDIR
Le répertoire dans lequel les binaires de WML ont été installés au moment de la compilation.

WML_LOC_LIBDIR
Le répertoire dans lequel les fichiers de bibliothèque de WML ont été installés au moment de la construction.

WML_LOC_DATADIR
Le répertoire dans lequel les fichiers de données de WML ont été installés au moment de la construction.

WML_LOC_MANDIR
Le répertoire dans lequel les pages de manuel de WML ont été installées au moment de la construction.

WML_VERSION
La chaîne d'identification de version de WML. Utilisez ceci par exemple dans les commentaires HTML
à l'intérieur de l'en-tête inclut pour identifier la version des outils de génération.

OCCASION VARIABLES
"WMLOPTS"
Cette variable peut contenir une chaîne d'options. Habituellement, cela est utilisé par Bourne-Shell
les utilisateurs aiment

$ WMLOPTS="-DNAME1=VALUE2 -DNAME2=VALUE2"
$ exporter WMLOPTS

et par les utilisateurs de C-Shell comme

$ setenv WMLOPTS "-DNAME1=VALUE2 -DNAME2=VALUE2"

pour s'assurer que certaines variables sont définies pour toutes les exécutions de wml.

"PAGER"
Cette variable contient le pager que WML doit utiliser. WML utilise un pager lorsqu'il est appelé avec le
--verbeux=NUM or -vNUM option respectivement et NUM est de 3 ou plus et donc
montrant les données traitées après chaque passage. La valeur par défaut est « plus ».

"TMPDIR"
Cette variable contient le répertoire dans lequel WML stocke ses fichiers temporaires. La valeur par défaut est
'/ Tmp'.

UTILISATEUR DES DOSSIERS

$HOME/.wmlrc ainsi que (../)*.wmlrc
Ces fichiers peuvent également contenir des chaînes d'options, une option par ligne. Habituellement le
le contenu est un ou plusieurs -D options, en particulier celles auto-ajustées :

-DROOTREL~.
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=VALEUR1
-DNAME2=VALEUR2
:

STANDARD COMPRENDRE DES DOSSIERS

WML est livré avec un ensemble standard de fichiers d'inclusion. Vous pouvez les inclure directement via

#use wml::category::name

et lire leur propre documentation via

$ man wml :: catégorie :: nom

See wml ::TOUTE(3) pour une description de tous les fichiers d'inclusion disponibles.

SPECIAL CARACTERISTIQUES

L'interface de contrôle WML fournit à elle seule quelques fonctionnalités spéciales :

Prise en charge de la ligne Shebang
WML reconnaît un case ligne (``"#!wml" Options'') dans le .wml fichiers et
ajoute automatiquement Options à sa ligne de commande. Cette ligne est également utilisée par WMk. Deux
des fonctionnalités spéciales par rapport aux lignes shebang pour le chargeur Unix sont disponibles : WML's
la ligne shebang peut être continuée via un caractère antislash et les constructions %DIR et
% sont interpolés (où %DIR est le chemin d'accès au répertoire de la source tandis que
réside et %BASE est le nom de fichier du fichier source sans aucune extension).

Mise en situation :

#!wml -o (ALL-LANG_*)+LANG_EN:%BASE.en.html \
-o (ALL-LANG_*)+LANG_DE:%BASE.de.html

Balise de conteneur de protection des données
WML fournit une propre balise de conteneur interne nommée "
[pass=SPEC]>"..." " qui peut être utilisé pour protéger tout type de données d'être
traité par n'importe quel pass WML. Lorsqu'aucun attribut "pass" n'est donné SPEC la valeur par défaut est "1-9".
Lorsque vous utilisez "pass", alors SPEC peut être soit "#-", "-#", "#-#" ou une virgule séparée
liste des passes, tandis que "#" peut être compris entre 1 et 9.

Mise en situation :




sortie = " " + chaîne_aide + " "




Mise en garde:

Depuis WML 2.0.3, l'étape 1 inclut des éléments supplémentaires pour aider à conserver les informations sur la ligne
chiffres pertinents (a la cpp). Alors en écrivant


#include 'foo'


ces commandes supplémentaires ne seront pas interprétées lors de la passe 2 et resteront en sortie.
Pour les supprimer, compilez avec le drapeau "-W1,-N", ou écrivez


#include 'foo' IPP_NOSYNCLINES

AUTEURS

Ralf S.Engelschall
[email protected]
www.engelschall.com

Denis Barbier
[email protected]

Utiliser wml en ligne à l'aide des services onworks.net