wml - Online na nuvem

PROGRAMA:

NOME

WML - linguagem META do site

VERSÃO

2.0.12 (16 de abril de 2008)

SINOPSE

wml [-I PATH] [-i PATH] [-D NOME=STR] [-D NOME~PATH] [-n] [-r] [-O nível] [-o
[TERMO DE FATIA":"]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [Arquivo de entrada]

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

DESCRIÇÃO

Este é o programa de controle do Site META Língua (WML), uma geração de HTML grátis
kit de ferramentas para Unix, que consiste internamente em 9 linguagens independentes.

A ideia principal do WML é um esquema de filtragem sequencial onde cada linguagem fornece um de
9 passes de processamento. Então wml lê Arquivo de entrada (ou de stdin if Arquivo de entrada é um traço ou
completamente ausente), aplica-se os passes 1-9 (ou apenas os passes especificados por -p) e finalmente
produz um ou mais arquivo de saídas.

Para obter mais detalhes sobre este esquema de processamento, leia o WML Introdução para wml_intro(7)
e os votos de WML Tutorial para wml_tutorial(7).

OPÇÕES

-I, --include =PATH
Adiciona um anuário à lista de caminhos de inclusão do usuário. Use esta opção para definir o tempo de execução
ambiente para passe 1. Veja wml_p1_ipp(3) para obter mais detalhes.

-i, --includefile =PATH
Pré-carrega um include específico lima, ou seja, virtualmente adiciona um

#include "PATH"

no topo de Arquivo de entrada. Use isso para incluir automaticamente arquivos de inclusão de usuário padrão.
Se você quiser incluir um arquivo de inclusão de sistema, você deve cercar o PATH com ângulo
colchetes, por exemplo, use `` "-i" " "'' para incluir o arquivo foo / bar.wml
da área de inclusão do sistema. Alternativamente, você pode usar a sintaxe especial
`` "wml :: foo :: bar" '' como com a diretiva "#use".

-D, --define =NOME=STR
Define uma variável que pode ser interpolada na passagem 1 (IPP) via "$ (NOME)", na passagem 2
(mp4h) via <"get-var NAME">, na passagem 3 (ePerl) via "<: = $ NAME:>" e na passagem 4 (GNU m4)
via "m4_NAME". Uma variante especial --define =NOME= UNDEF faz o oposto, ele apaga
definições anteriores (que podem ser diferentes de indefinir essas variáveis, por exemplo
com variáveis ​​definidas pelo sistema).

-D, --define =NOME~PATH
Semelhante ao anterior, mas define uma variável contendo um nome de caminho que é autoajustado
(Veja abaixo). Pode ser interpolado da mesma forma que a variante "NAME = STR" de
acima.

-n, --noshebang
Isso força o WML a ignorar uma linha shebang possivelmente contida em Arquivo de entrada. Isto é
normalmente usado por WMk, porque WMk já analisou esta linha e forneceu as opções para
WML.

-r, --norcfile
Isso força o WML a ignorar todos .wmlrc arquivos.

-c, --nocd
Quando o WML processa um arquivo de entrada de outro diretório, ele salta para esse diretório
antes de analisar .wmlrc arquivos e volte para o diretório atual depois. Se esta opção
está definido, nenhuma mudança de diretório é feita e .wmlrc os arquivos são lidos reativos para o atual
diretório de trabalho.

-O, --optimize =NUM
Esta é a opção de otimização que é passada diretamente para a aprovação 8 (htmlfix) Isto
controla a quantidade de otimização / remoção que é aplicada ao HTML gerado
código de marcação.

-o, --outputfile =TERMO DE FATIA:arquivo de saída[@CHMODOPT]
Isso redireciona a saída para um arquivo. Normalmente, todo o arquivo será enviado para stdout
(o mesmo que "ALL: -"). Você pode usar esta opção mais de uma vez para enviar para mais de um
arquivo ao usar o TERMO DE FATIA como um termo de teoria de conjunto de fatias para determinar quais
o conteúdo será incluído em cada arquivo de saída específico. O opcional CHMODOPT is
destina-se a especificar opções para uma aplicação final chmod comando. Por exemplo, use
`` "u + x" '' para criar um arquivo com o bit de execução definido (recurso XBitHack do Apache).
See fatia(1) para obter mais detalhes.

-P, --prolog =PATH
Executa um filtro de prólogo no arquivo de entrada. Este programa recebe os dados para agir
como STDIN e deve produzir os dados filtrados em STDOUT.

-E, --epilog =PATH
Executa um programa epílogo sobre os arquivos de saída resultantes. Atualmente o
os seguintes programas específicos de WML são conhecidos: informações html, linklint, arrumado e weblint. Mas
você pode especificar qualquer programa que esteja disponível em seu "PATH". Este programa recebe
o arquivo para atuar como seu primeiro argumento de linha de comando. Observe que a saída não é
redirecionado para este arquivo, então você tem que usar um wrapper ou sinalizadores específicos do programa se você
deseja modificar os arquivos de saída.

-t, --definir tempo
Isso define a hora de modificação de todos os arquivos de saída para a hora de modificação de
arquivo de entrada mais 1 segundo. Isso é útil porque os servidores da Web irão gerar
Cabeçalhos "Última modificação" e aí o tempo de edição é mais importante do que o
tempo de geração. O deslocamento de 1 segundo é para as dependências de Makefiles.

-M, --depender[=OPÇÕES]
Produza uma regra adequada para `make 'descrevendo as dependências de cada arquivo de saída, como
`gcc 'faz. Só faz sentido quando o -o opção é usada. Nenhum processamento é feito
exceto para a primeira passagem.

A D A opção flag grava a regra em um arquivo de dependência. O nome deste arquivo é
obtido substituindo o sufixo do arquivo de saída por ".d".

A M A opção flag exclui os arquivos de sistema da lista de dependências.

-p, --pass =STR
Especifica quais das passagens descritas acima são realmente aplicadas em tempo de execução. o
argumento STR é uma lista separada por vírgulas de números de passagem com um caso especial: Você pode
escreva "XY" para todos os passes "X ... Y". Quando o passe 9 não faz parte de STR o resultado
saída é escrita para STDOUT. O padrão é a string `` "1-9" ''.

-W, --passoption =NUM,STR
Definir opção STR para o passe NUM.

-s, --seguro
Isso desativa alguns hacks Perl dentro do WML que aceleram o processamento, reduzindo o
bifurcação na sobrecarga ao executar as várias passagens.

Sem esta opção, o WML pré-compila os passes 1,5,6,7,8 (que são escritos em Perl!)
em um namespace diferente do interpretador Perl atualmente em execução, em vez de
rodando-os externamente através de "system ()". O efeito é que esses programas são executados a partir de
dentro do mesmo interpretador Perl, economizando cinco "fork ()" que consomem muito tempo e CPU.
O ganho real está entre 2 e 4 segundos de tempo de processamento. Embora experiência
mostrou que funciona muito bem, o problema teórico ainda é, que essa abordagem é
um tanto arriscado devido a conflitos internos de variáveis ​​Perl.

Use esta opção para desativar essas acelerações, forçando o WML a usar o "fork ()" seguro
abordagem.

-v, --verbose[=NUM]
Isso define o modo detalhado (de 1 a 9), onde algumas informações de processamento serão fornecidas
no console. Útil para depuração. Esta opção também é passada para alguns dos
programas de filtragem. O padrão é sem verbosidade e apenas -v significa -v1.

-q, --quieto
Isso define o modo silencioso em que a propriedade de processamento não é mais exibida. Usa isto
opção ao correr wml como um trabalho em lote. Esta opção é automaticamente forçada quando
Arquivo de entrada está desaparecido. Então o WML lê automaticamente a partir stdin no modo silencioso.

-V, --versão[=NUM]
Dá a string de identificação da versão e isenção de responsabilidade (não NUM or NUM > = 1), o WML
construir informações (NUM > = 2) e as informações de compilação do Perl (NUM > = 3). Usa isto
opção de obter uma breve descrição do seu sistema WML instalado, especialmente quando
relatando bugs ao autor.

-h, --Socorro
Imprime a página de resumo de uso.

MEIO AMBIENTE

DEFINIRAM VARIÁVEIS
As seguintes variáveis ​​são sempre definidas por wml em tempo de execução e geralmente são
interpolado via <"get-var NAME"> dentro da passagem 2 e via $ NAME na passagem 3.

WML_SRC_DIRNAME
O diretório de trabalho atual de onde wml Começou. Um sistema de arquivos Unix absoluto
caminho.

WML_SRC_FILENAME
O nome do Arquivo de entrada a partir da linha de comando. Útil ao correr wml em uma grande quantidade de
os arquivos e arquivos de inclusão devem determinar em quais serão incluídos.

WML_SRC_BASENAME
O nome de base do Arquivo de entrada, ou seja, o "WML_SRC_FILENAME", mas com a extensão
já despojado.

WML_SRC_TIME
A hora da última modificação de Arquivo de entrada no formato "time ()". Rodapés internos úteis
quando o formato de data personalizado é necessário.

WML_SRC_CTIME
A hora da última modificação de Arquivo de entrada no formato "ctime ()". Rodapés internos úteis
incluir arquivos.

WML_SRC_ISOTIME
A hora da última modificação de Arquivo de entrada no formato ISO "aaaa-mm-dd hh: mm: ss". Útil
rodapés internos incluem arquivos.

WML_SRC_USERNAME
O nome de usuário Unix do usuário que possui Arquivo de entrada.

WML_SRC_REALNAME
O nome real do usuário que possui Arquivo de entrada.

WML_GEN_TIME
A hora atual de geração no formato "time ()". Rodapés úteis quando
é necessário um formato de data personalizado.

WML_GEN_CTIME
A hora atual de geração no formato "ctime ()". Rodapés internos úteis incluem
arquivos.

WML_GEN_ISOTIME
A hora atual de geração no formato ISO "aaaa-mm-dd hh: mm: ss". Útil dentro
rodapés incluem arquivos.

WML_GEN_USERNAME
O nome de usuário Unix do usuário que executa o wml processo.

WML_GEN_REALNAME
O nome real do usuário que executa o wml processo.

WML_GEN_HOSTNAME
O nome do host no qual o wml o comando é executado.

WML_LOC_PREFIX
O prefixo do local onde o WML foi instalado no momento da construção.

WML_LOC_BINDIR
O diretório onde os binários do WML foram instalados no momento da construção.

WML_LOC_LIBDIR
O diretório onde os arquivos de biblioteca do WML foram instalados no momento da construção.

WML_LOC_DATADIR
O diretório onde os arquivos de dados WML foram instalados no momento da construção.

WML_LOC_MANDIR
O diretório onde as páginas de manual do WML foram instaladas no momento da construção.

WML_VERSION
A string de identificação de versão do WML. Use isso, por exemplo, em comentários HTML
o cabeçalho interno inclui para identificar a versão das ferramentas de geração.

USAVA VARIÁVEIS
"WMLOPTS"
Esta variável pode conter uma sequência de opções. Normalmente, isso é usado por Bourne-Shell
usuários gostam

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

e por usuários C-Shell como

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

para garantir que algumas variáveis ​​sejam definidas para todas as execuções de wml.

"PAGER"
Esta variável contém o pager que o WML deve usar. WML usa um pager quando chamado com o
--verbose =NUM or -vNUM opção respectivamente e NUM é 3 ou superior e, portanto,
mostrando os dados processados ​​após cada passagem. O padrão é 'mais'.

"TMPDIR"
Esta variável contém o diretório em que o WML armazena seus arquivos temporários. O padrão é
'/ Tmp'.

USUÁRIO ARQUIVOS

$ HOME / .wmlrc e (../)*.wmlrc
Esses arquivos também podem conter strings de opção, uma opção por linha. Normalmente o
o conteúdo é um ou mais -D opções, especialmente as ajustadas automaticamente:

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

PADRÃO INCLUIR ARQUIVOS

WML é fornecido com um conjunto padrão de arquivos de inclusão. Você pode incluí-los diretamente por meio de

#use wml :: category :: name

e ler sua própria documentação via

$ man wml :: categoria :: nome

See wml ::todos os(3) para obter uma descrição de todos os arquivos de inclusão disponíveis.

SPECIAL CARATERÍSTICAS

O front-end de controle WML fornece alguns recursos especiais por conta própria:

Suporte de linha Shebang
WML reconhece um cabana linha (`` "#! wml" opções'') no .wml arquivos e
adiciona automaticamente opções para sua linha de comando. Esta linha também é usada pela WMk. Dois
recursos especiais em contraste com as linhas básicas para o carregador Unix estão disponíveis: WML's
a linha shebang pode ser continuada por meio de um caractere de barra invertida e as construções% DIR e
% são interpolados (onde% DIR é o caminho para o diretório de origem enquanto
reside e% BASE é o nome do arquivo de origem sem qualquer extensão).

Exemplo:

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

Tag de contêiner de proteção de dados
WML fornece uma própria tag de contêiner interna chamada "
[pass = SPEC]> "..." "que pode ser usado para proteger qualquer tipo de dados de serem
processado por qualquer passagem WML. Quando nenhum atributo "passar" é fornecido SPEC o padrão é "1-9".
Quando você usa "passar", SPEC pode ser "# -", "- #", "# - #" ou separado por vírgulas
lista de passes, enquanto "#" pode estar entre 1 e 9.

Exemplo:



...
output = " "+ help_string +" "
...



Atenção:

Desde WML 2.0.3, a passagem 1 inclui coisas extras para ajudar a manter informações sobre a linha
números relevantes (a la cpp). Então, ao escrever


#include 'foo'


esses comandos extras não serão interpretados durante a passagem 2 e permanecerão na saída.
Para suprimi-los, compile com a sinalização "-W1, -N" ou escreva


#include 'foo' IPP_NOSYNCLINES

AUTORES

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

Denis Barbier
[email protegido]

Use wml online usando serviços onworks.net