wml: en línea en la nube

PROGRAMA:

NOMBRE

WML - Lenguaje META del sitio web

VERSIÓN

2.0.12 (16 de abril de 2008)

SINOPSIS

wml [-I TRAYECTORIA] [-i TRAYECTORIA] [-D NOMBRE=STR] [-D NOMBRE~TRAYECTORIA] [-n] [-r] [-O nivel] [-o
[SICETERM":"]TRAYECTORIA[@CHMODOPT]] [-P TRAYECTORIA] [-E TRAYECTORIA] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [fichero de entrada]

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

DESCRIPCIÓN

Este es el programa de control del Página web META Idioma (WML), una generación HTML gratuita
kit de herramientas para Unix, que consta internamente de 9 lenguajes independientes.

La idea principal de WML es un esquema de filtrado secuencial donde cada idioma proporciona uno de
9 pases de procesamiento. Entonces wml lee fichero de entrada (o de stdin if fichero de entrada es un guión o
falta por completo), aplica los pases 1-9 (o solo los pases especificados por -p) y finalmente
produce uno o más archivo de salidas.

Para obtener más detalles sobre este esquema de procesamiento, lea el WML Introducción bajo introducción_wml(7)
y del WML Tutorial bajo tutorial_wml(7).

CAMPUS

-I, --include =TRAYECTORIA
añade una directorio a la lista de rutas de inclusión de usuarios. Utilice esta opción para configurar el tiempo de ejecución
entorno para el pase 1. Ver wml_p1_ipp(3) para más detalles.

-i, --includefile =TRAYECTORIA
Precarga una inclusión en particular presentar, es decir, agrega virtualmente un

#include "RUTA"

en la cima de fichero de entrada. Utilice esto para incluir automáticamente los archivos de inclusión de usuario predeterminados.
Si desea incluir un archivo de inclusión de sistemas, debe rodear el TRAYECTORIA con angulo
corchetes, por ejemplo use "" -i "" "'' para incluir el archivo foo / bar.wml
del área de inclusión del sistema. Alternativamente, puede usar la sintaxis especial
`` "wml :: foo :: bar" '' como con la directiva "#use".

-D, --define =NOMBRE=STR
Define una variable que se puede interpolar en el paso 1 (IPP) a través de "$ (NAME)", en el paso 2
(mp4h) a través de <"get-var NAME">, en el paso 3 (ePerl) a través de "<: = $ NAME:>" y en el paso 4 (GNU m4)
a través de "m4_NAME". Una variante especial --define =NOMBRE= UNDEF hace lo contrario, elimina
definiciones previas (que pueden ser diferentes a no definir estas variables, p. ej.
con variables definidas por el sistema).

-D, --define =NOMBRE~TRAYECTORIA
Similar a lo anterior, pero define una variable que contiene un nombre de ruta que se ajusta automáticamente
(vea abajo). Se puede interpolar de la misma forma que la variante "NAME = STR" de
anterior.

-n, --noshebang
Esto obliga a WML a ignorar una línea shebang posiblemente contenida en fichero de entrada. Es
Usualmente utilizado por WMk, porque WMk ya analizó esta línea y proporcionó las opciones para
WML.

-r, --norcfile
Esto obliga a WML a ignorar todos .wmlrc archivos.

-c, --nocd
Cuando WML procesa un archivo de entrada de otro directorio, salta a ese directorio
antes de analizar .wmlrc archivos y volver al directorio actual después. Si esta opcion
está configurado, no se realiza ningún cambio de directorio y .wmlrc los archivos se leen en relación con el actual
directorio de trabajo.

-O, --optimize =NUM
Esta es la opción de optimización que se pasa directamente al paso 8 (htmlfix). Eso
controla la cantidad de optimización / eliminación que se aplica al HTML generado
código de marcado.

-o, --outputfile =SICETERM:archivo de salida[@CHMODOPT]
Esto redirige la salida a un archivo. Por lo general, todo el archivo se enviará a stdout
(igual que "TODOS: -"). Puede utilizar esta opción más de una vez para enviar a más de una
archivo mientras usa el SICETERM como un término de la teoría de conjuntos de rebanadas para determinar qué
el contenido se incluirá en cada archivo de salida en particular. El opcional CHMODOPT is
destinado a especificar opciones para una aplicación finalmente chmod mando. Por ejemplo, use
`` "u + x" '' para crear un archivo con el bit de ejecución establecido (función XBitHack de Apache).
See rebanada(1) para más detalles.

-P, --prólogo =TRAYECTORIA
Ejecuta un filtro de prólogo sobre el archivo de entrada. Este programa recibe los datos para actuar
como STDIN y tiene que producir los datos filtrados en STDOUT.

-E, --epilog =TRAYECTORIA
Ejecuta un programa de epílogo sobre los archivos de salida finalmente resultantes. Actualmente el
Se conocen los siguientes programas específicos de WML: información html, enlacelint, ordenado y telaraña. Sin embargo,
puede especificar cualquier programa que esté disponible en su "RUTA". Este programa recibe
el archivo sobre el que actuar como su primer argumento de línea de comando. Tenga en cuenta que la salida no es
redirigido a este archivo, por lo que debe usar un contenedor o indicadores específicos del programa si
desea modificar archivos de salida.

-t, --fijar tiempo
Esto establece la hora de modificación de todos los archivos de salida a la hora de modificación de
archivo de entrada más 1 segundo. Esto es útil porque los servidores web generarán
Encabezados "Última modificación" y allí el tiempo de edición es más importante que el
tiempo generacional. El desplazamiento de 1 segundo es para las dependencias de Makefiles.

-M, --depender[=CAMPUS]
Genere una regla adecuada para 'make' describiendo las dependencias de cada archivo de salida, como
'gcc' lo hace. Solo tiene sentido cuando el -o se utiliza la opción. No se realiza ningún procesamiento
excepto por la primera pasada.

El D La opción de bandera escribe la regla en un archivo de dependencia. El nombre de este archivo es
obtenido reemplazando el sufijo del archivo de salida por ".d".

El M La opción de bandera elimina los archivos del sistema de la lista de dependencias.

-p, --pass =STR
Especifica cuáles de las pasadas descritas anteriormente se aplican realmente en tiempo de ejecución. los
argumento STR es una lista de números de paso separados por comas con un caso especial: puede
escriba "XY" para todas las pasadas "X ... Y". Cuando el pase 9 no es parte de STR la resultante
la salida se escribe en SALIDA ESTÁNDAR. El valor predeterminado es la cadena `` "1-9" ''.

-W, --passoption =NUM,STR
Configurar opción STR por el pase NUM.

-s, --a salvo
Esto deshabilita algunos hacks de Perl dentro de WML que aceleran el procesamiento al reducir la
bifurcando por encima de la cabeza cuando se ejecutan las distintas pasadas.

Sin esta opción, WML precompila las pasadas 1,5,6,7,8 (¡que están escritas en Perl!)
en un espacio de nombres diferente del intérprete de Perl que se está ejecutando actualmente en lugar de
ejecutándolos externamente a través de "system ()". El efecto es que estos programas se ejecutan desde
dentro del mismo intérprete de Perl, lo que ahorra cinco "fork ()" que requieren mucho tiempo y CPU.
La ganancia real está entre 2 y 4 segundos de tiempo de procesamiento. Aunque la experiencia
demostró que funciona muy bien, el problema teórico sigue siendo, que este enfoque es
algo arriesgado debido a conflictos internos de variables de Perl.

Use esta opción para deshabilitar estas aceleraciones forzando a WML a usar el "fork ()" seguro
enfoque.

-v, --verboso[=NUM]
Esto establece el modo detallado (de 1 a 9) donde se proporcionará alguna información de procesamiento
en la consola. Útil para depurar. Esta opción también se pasa a algunos de los
programas de filtrado. El valor predeterminado es sin verbosidad y solo -v significa -v1.

-q, --tranquilo
Esto establece el modo silencioso donde el accesorio de procesamiento ya no se muestra. Utilizar esta
opción al correr wml como un trabajo por lotes. Esta opción se fuerza automáticamente cuando
fichero de entrada Está perdido. Entonces WML lee automáticamente desde stdin en modo silencioso.

-V, --versión[=NUM]
Proporciona la cadena de identificación de la versión y el descargo de responsabilidad (no NUM or NUM > = 1), el WML
construir informaciónNUM > = 2) y la información de compilación de Perl (NUM > = 3). Utilizar esta
opción para obtener una breve descripción de su sistema WML instalado, especialmente cuando
informar errores al autor.

-h, --ayuda
Imprime la página de resumen de uso.

MEDIO AMBIENTE

DEFINIDO VARIABLES
Las siguientes variables siempre están definidas por wml en tiempo de ejecución y normalmente
interpolado a través de <"get-var NAME"> dentro del Pase 2 y a través de $ NAME en el Paso 3.

WML_SRC_DIRNAME
El directorio de trabajo actual desde donde wml empezó. Un sistema de archivos Unix absoluto
camino.

WML_SRC_NOMBRE DE ARCHIVO
El nombre de la fichero de entrada desde la línea de comando. Útil al correr wml en la mayor parte de
archivos y archivos de inclusión tienen que determinar en qué se incluyen.

WML_SRC_NOMBREBASE
El nombre de base del fichero de entrada, es decir, "WML_SRC_FILENAME", pero con la extensión
ya despojado.

WML_SRC_TIME
La última hora de modificación de fichero de entrada en formato "hora ()". Pie de página interior útil
cuando se necesita un formato de fecha personalizado.

WML_SRC_CTIME
La última hora de modificación de fichero de entrada en formato "ctime ()". Pie de página interior útil
incluir archivos.

WML_SRC_ISOTIME
La última hora de modificación de fichero de entrada en formato ISO "aaaa-mm-dd hh: mm: ss". Útil
los pies de página interiores incluyen archivos.

WML_SRC_NOMBRE DE USUARIO
El nombre de usuario de Unix del usuario que posee fichero de entrada.

WML_SRC_NOMBRE REAL
El nombre real del usuario que posee fichero de entrada.

WML_GEN_TIME
La hora actual de generación en formato "time ()". Pie de página interior útil cuando
Se necesita un formato de fecha personalizado.

WML_GEN_CTIME
La hora actual de generación en formato "ctime ()". Entre los pies de página interiores útiles se incluyen
archivos.

WML_GEN_ISOTIME
La hora actual de generación en formato ISO "aaaa-mm-dd hh: mm: ss". Útil por dentro
los pies de página incluyen archivos.

WML_GEN_NOMBRE DE USUARIO
El nombre de usuario de Unix del usuario que ejecuta el wml .

WML_GEN_NOMBRE REAL
El nombre real del usuario que ejecuta el wml .

WML_GEN_HOSTNAME
El nombre del host en el que wml se ejecuta el comando.

WML_LOC_PREFIX
El prefijo de ubicación donde se instaló WML en el momento de la compilación.

WML_LOC_BINDIR
El directorio donde se instalaron los binarios de WML en el momento de la compilación.

WML_LOC_LIBDIR
El directorio donde se instalaron los archivos de la biblioteca de WML en el momento de la compilación.

WML_LOC_DATADIR
El directorio donde se instalaron los archivos de datos de WML en el momento de la compilación.

WML_LOC_MANDIR
El directorio donde se instalaron las páginas del manual de WML en el momento de la compilación.

WML_VERSION
La cadena de identificación de la versión de WML. Use esto, por ejemplo, en comentarios HTML
El encabezado interior incluye para identificar la versión de las herramientas de generación.

USADO VARIABLES
"WMLOPTS"
Esta variable puede contener una serie de opciones. Por lo general, esto lo usa Bourne-Shell
a los usuarios les gusta

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

y por usuarios de C-Shell como

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

para asegurarse de que algunas variables estén definidas para todas las ejecuciones de wml.

"BUSCAPERSONAS"
Esta variable contiene el buscapersonas que se utilizará WML. WML usa un buscapersonas cuando se llama con el
--verbose =NUM or -vNUM opción respectivamente y NUM es 3 o superior y por lo tanto
mostrando los datos procesados ​​después de cada pasada. El valor predeterminado es "más".

"TMPDIR"
Esta variable contiene el directorio en el que WML almacena sus archivos temporales. El valor predeterminado es
'/ Tmp'.

USUARIO ARCHIVOS

$ INICIO / .wmlrc y (../)*.wmlrc
Estos archivos también pueden contener cadenas de opciones, una opción por línea. Por lo general, el
el contenido es uno o más -D opciones, especialmente las autoajustadas:

-DROOTREL ~.
-DROOTABS =http://thishost/thisarea/
:
-DNAME1 = VALUE1
-DNAME2 = VALUE2
:

ESTANDAR INCLUIR ARCHIVOS

WML se envía con un conjunto estándar de archivos de inclusión. Puede incluirlos directamente a través de

#use wml :: categoría :: nombre

y leer su propia documentación a través de

$ man wml :: categoría :: nombre

See wml ::todos(3) para obtener una descripción de todos los archivos de inclusión disponibles.

SPECIAL CATEGORIAS

La interfaz de control WML proporciona algunas características especiales por sí sola:

Soporte de Shebang Line
WML reconoce un tinglado línea (`` "#! wml" opciones'') en el .wml y archivos
agrega automáticamente opciones a su línea de comando. Esta línea también es utilizada por WMk. Dos
características especiales en contraste con las líneas shebang para el cargador Unix están disponibles: WML
La línea shebang se puede continuar mediante un carácter de barra invertida y las construcciones% DIR y
% están interpolados (donde% DIR es la ruta al directorio de la fuente mientras
reside y% BASE es el nombre del archivo de origen sin ninguna extensión).

Ejemplo:

#! wml -o (TODO EL IDIOMA _ *) + IDIOMA_EN:% BASE.en.html \
-o (TODO EN IDIOMA _ *) + IDIOMA_DE:% BASE.de.html

Etiqueta de contenedor de protección de datos
WML proporciona una etiqueta de contenedor interna propia denominada "
[pass = SPEC]> "..." "que se puede utilizar para proteger cualquier tipo de datos
procesado por cualquier pase WML. Cuando no se proporciona ningún atributo "aprobado" SPEC por defecto es "1-9".
Cuando usas "pasar", entonces SPEC puede ser "# -", "- #", "# - #" o separados por comas
lista de pases, mientras que "#" puede estar entre 1 y 9.

Ejemplo:



...
salida = " "+ cadena_de_ayuda +" "
...



Advertencia:

Desde WML 2.0.3, el paso 1 incluye cosas adicionales para ayudar a mantener información sobre la línea
números relevantes (a la cpp). Entonces al escribir


#include 'foo'


estos comandos adicionales no se interpretarán durante la pasada 2 y permanecerán en la salida.
Para suprimirlos, compile con el indicador "-W1, -N" o escriba


#include 'foo' IPP_NOSYNCLINES

AUTORES

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

Denis Barbier
[email protected]

Use wml en línea usando los servicios de onworks.net