wml - Online nel cloud

PROGRAMMA:

NOME

WML - Linguaggio META del sito web

VERSIONE

2.0.12 (16-aprile-2008)

SINOSSI

wml [-I PERCORSO] [-i PERCORSO] [-D NOME=STR] [-D NOME~PERCORSO] [-n] [-r] [-O livello] [-o
[SLICTERM":"]PERCORSO[@CHMODOPT,-P PERCORSO] [-E PERCORSO] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [file di input]

wml [-V [NUM,-h]

DESCRIZIONE

Questo è il programma di controllo del Sito web META Lingua (WML), una generazione HTML gratuita
toolkit per Unix, composto internamente da 9 linguaggi indipendenti.

L'idea principale di WML è uno schema di filtraggio sequenziale in cui ogni lingua fornisce uno di
9 passaggi di elaborazione. Così wml legge file di input (o da stdin if file di input è un trattino o
completamente mancante), applica i passaggi 1-9 (o solo i passaggi specificati da -p) e infine
produce uno o più file di uscitas.

Per maggiori dettagli su questo schema di elaborazione leggi il WML Introduzione per wml_intro(7)
e la WML Tutorial per wml_tutorial(7).

VERSIONI

-I, --include=PERCORSO
Aggiunge un elenco all'elenco dei percorsi di inclusione utente. Usa questa opzione per impostare il runtime
ambiente per il passaggio 1. Vedi wml_p1_ipp(3) per maggiori dettagli.

-i, --includefile=PERCORSO
Precarica un particolare include filetto, cioè virtualmente aggiunge a

#include "PERCORSO"

in cima a file di input. Usalo per includere automaticamente i file di inclusione dell'utente predefinito.
Se vuoi includere un file di inclusione di sistema devi racchiudere il PERCORSO con angolo
parentesi quadre, ad esempio usa ``"-i" " "'' per includere il file foo/bar.wml
dal sistema include area. In alternativa puoi usare la sintassi speciale
``"wml::foo::bar"'' come con la direttiva "#use".

-D, --definire=NOME=STR
Definisce una variabile che può essere interpolata nel passaggio 1 (IPP) tramite "$(NAME)", nel passaggio 2
(mp4h) tramite <"get-var NAME">, nel passaggio 3 (ePerl) tramite "<:=$NAME:>" e nel passaggio 4 (GNU m4)
tramite "m4_NAME". Una variante speciale --definire=NOME=UNDEF fa il contrario, cancella
definizioni precedenti (che possono essere diverse dall'indefinire queste variabili, ad es
con variabili definite dal sistema).

-D, --definire=NOME~PERCORSO
Simile al precedente ma definisce una variabile che contiene un percorso che viene regolato automaticamente
(vedi sotto). Può essere interpolato allo stesso modo della variante "NAME=STR" di
sopra.

-n, --noshebang
Questo costringe WML a ignorare una riga di shebang eventualmente contenuta in file di input. Questo è
solitamente usato da WMk, perché WMk ha già analizzato questa riga e ha fornito le opzioni per
WML.

-r, --norcfile
Questo costringe WML a ignorare tutto .wmlrc File.

-c, --noc
Quando WML elabora un file di input da un'altra directory, salta in quella directory
prima di analizzare .wmlrc file e torna alla directory corrente dopo. Se questa opzione
è impostato, non viene effettuato alcun cambio di directory e .wmlrc i file vengono letti in base alla corrente
directory di lavoro.

-O, --ottimizzare=NUM
Questa è l'opzione di ottimizzazione che viene passata direttamente al passaggio 8 (htmlfix). è
controlla la quantità di ottimizzazione/rimozione applicata all'HTML generato
codice di marcatura.

-o, --file di output=SLICTERM:file di uscita[@CHMODOPT]
Questo reindirizza l'output a un file. Di solito l'intero file verrà inviato a stdout
(uguale a "TUTTI:-"). Puoi usare questa opzione più di una volta per produrre output su più di uno
file durante l'utilizzo di SLICTERM come un termine della teoria degli insiemi di fette per determinare quale
i contenuti saranno inclusi in ogni particolare file di output. L'opzionale CHMODOPT is
destinato a specificare le opzioni per un'applicazione definitiva chmod comando. Ad esempio usa
``"u+x"'' per creare un file con il bit di esecuzione impostato (funzione XBitHack di Apache).
See fetta(1) per maggiori dettagli.

-P, --prologo=PERCORSO
Esegue un filtro prologo sul file di input. Questo programma riceve i dati su cui agire
come STDIN e deve produrre i dati filtrati su STDOUT.

-E, --epilogo=PERCORSO
Esegue un programma di epilogo sui file di output risultanti. Attualmente il
sono noti i seguenti programmi specifici per WML: informazioni html, linklint, ordinato ed weblint. Ma
puoi specificare qualsiasi programma disponibile nel tuo "PERCORSO". Questo programma riceve
il file su cui agire come primo argomento della riga di comando. Notare che l'output non lo è
reindirizzato a questo file, quindi devi usare un wrapper o flag specifici del programma se vuoi
desidera modificare i file di output.

-t, --tempo impostato
Questo imposta l'ora di modifica di tutti i file di output sull'ora di modifica di
inputfile più 1 secondo. Questo è utile perché i server Web genereranno
Intestazioni "Last-Modified" e lì il tempo di modifica è più importante del
tempo di generazione. L'offset di 1 secondo è per le dipendenze dei Makefile.

-M, --dipendere[=VERSIONI]
Emetti una regola adatta a "make" che descriva le dipendenze di ciascun file di output, come
`gcc' lo fa. Ha senso solo quando il -o viene utilizzata l'opzione. Non viene eseguita alcuna elaborazione
tranne il primo passaggio.

I D L'opzione flag scrive la regola in un file di dipendenza. Il nome di questo file è
ottenuto sostituendo il suffisso del file di output con ".d".

I M L'opzione flag elimina i file di sistema dall'elenco delle dipendenze.

-p, --passa=STR
Specifica quali dei passaggi descritti sopra vengono effettivamente applicati in fase di runtime. Il
argomento STR è un elenco separato da virgole di numeri di pass con un caso speciale: puoi
scrivere "XY" per tutti i passaggi "X...Y". Quando il passaggio 9 non fa parte di STR il risultato
l'output è scritto in STDOUT. L'impostazione predefinita è la stringa ``"1-9"''.

-W, --passoption=NUM,STR
Imposta opzione STR per il pass NUM.

-s, --sicuro
Questo disabilita alcuni hack di Perl all'interno di WML che velocizzano l'elaborazione riducendo il
biforcazione in testa durante l'esecuzione delle varie passate.

Senza questa opzione WML precompila i passaggi 1,5,6,7,8 (che sono scritti in Perl!)
in uno spazio dei nomi diverso dell'interprete Perl attualmente in esecuzione invece di
eseguendoli esternamente tramite "system()". L'effetto è che questi programmi vengono eseguiti da
all'interno dello stesso interprete Perl risparmiando così cinque "fork()" che richiedono molta CPU e tempo.
Il guadagno effettivo è compreso tra 2 e 4 secondi di tempo di elaborazione. Sebbene l'esperienza
ha dimostrato che funziona alla grande, il problema teorico è ancora, che questo approccio è
alquanto rischioso a causa di conflitti interni di variabili Perl.

Usa questa opzione per disabilitare queste accelerazioni forzando WML a usare il "fork()" sicuro
approccio.

-v, --verboso[=NUM]
Questo imposta la modalità dettagliata (da 1 a 9) in cui verranno fornite alcune informazioni di elaborazione
sulla console. Utile per il debug. Questa opzione viene passata anche ad alcuni dei
programmi di filtraggio. L'impostazione predefinita non è verbosità e basta -v si intende -v1.

-q, --silenzioso
Questo imposta la modalità silenziosa in cui il supporto di elaborazione non viene più visualizzato. Usa questo
opzione durante l'esecuzione wml come lavoro batch. Questa opzione viene automaticamente forzata quando
file di input manca. Quindi WML legge automaticamente da stdin in modalità silenziosa.

-V, --versione[=NUM]
Fornisce la stringa di identificazione della versione e l'esclusione di responsabilità (no NUM or NUM >= 1), il WML
costruire informazioni (NUM >= 2) e le informazioni sulla build Perl (NUM >= 3). Usa questo
opzione per ottenere una breve descrizione del sistema WML installato, soprattutto quando
segnalare i bug all'autore.

-h, --Aiuto
Stampa la pagina di riepilogo dell'utilizzo.

AMBIENTE

DEFINITO VARIABILI
Le seguenti variabili sono sempre definite da wml in fase di esecuzione e di solito sono
interpolato tramite <"get-var NAME"> all'interno del Pass 2 e tramite $NAME nel Pass 3.

WML_SRC_DIRNAME
La directory di lavoro corrente da dove wml era iniziato. Un filesystem Unix assoluto
sentiero.

WML_SRC_NOMEFILE
Il nome del file di input dalla riga di comando. Utile durante la corsa wml su un grosso di
i file e gli includefile devono determinare in che modo sono inclusi.

WML_SRC_BASENAME
Il nome di base del file di input, ovvero il "WML_SRC_FILENAME", ma con l'estensione
già spogliato.

WML_SRC_TIME
L'ora dell'ultima modifica di file di input nel formato "time()". Utili piè di pagina all'interno
quando è necessario un formato data personalizzato.

WML_SRC_CTIME
L'ora dell'ultima modifica di file di input nel formato "ctime()". Utili piè di pagina all'interno
includi file.

WML_SRC_ISOTIME
L'ora dell'ultima modifica di file di input in formato ISO "aaaa-mm-gg hh:mm:ss". Utile
all'interno dei piè di pagina sono inclusi i file.

WML_SRC_NOMEUTENTE
Il nome utente Unix dell'utente proprietario file di input.

WML_SRC_REALNAME
Il vero nome dell'utente che possiede file di input.

WML_GEN_TIME
L'ora corrente di generazione in formato "time()". Utile all'interno dei piè di pagina quando
è necessario un formato di data personalizzato.

WML_GEN_CTIME
L'ora corrente di generazione in formato "ctime()". I piè di pagina interni utili includono
File.

WML_GEN_ISOTIME
L'ora corrente di generazione in formato ISO "aaaa-mm-gg hh:mm:ss". Utile all'interno
i piè di pagina includono i file.

WML_GEN_USERNAME
Il nome utente Unix dell'utente che esegue il wml processo.

WML_GEN_REALNAME
Il vero nome dell'utente che esegue il wml processo.

WML_GEN_NOMEHOST
Il nome dell'host su cui il wml il comando viene eseguito.

WML_LOC_PREFIX
Il prefisso della posizione in cui è stato installato WML in fase di compilazione.

WML_LOC_BINDIR
La directory in cui sono stati installati i binari di WML in fase di compilazione.

WML_LOC_LIBDIR
La directory in cui sono stati installati i file della libreria di WML in fase di compilazione.

WML_LOC_DATADIR
La directory in cui sono stati installati i file di dati di WML in fase di compilazione.

WML_LOC_MANDIR
La directory in cui sono state installate le pagine di manuale di WML in fase di compilazione.

VERSIONE_WML
La stringa di identificazione della versione di WML. Usa questo per esempio nei commenti HTML
all'interno dell'intestazione include per identificare la versione degli strumenti di generazione.

USATO VARIABILI
"WMLOPTS"
Questa variabile può contenere una stringa di opzioni. Di solito questo è usato da Bourne-Shell
agli utenti piace

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

e dagli utenti di C-Shell come

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

per assicurarsi che alcune variabili siano definite per tutte le esecuzioni di wml.

"PAGATORE"
Questa variabile contiene il cercapersone che WML deve utilizzare. WML usa un cercapersone quando viene chiamato con il
--verboso=NUM or -vNUM opzione rispettivamente e NUM è 3 o superiore e quindi
mostrando i dati elaborati dopo ogni passaggio. L'impostazione predefinita è "più".

"TMPDIR"
Questa variabile contiene la directory in cui WML memorizza i suoi file temporanei. L'impostazione predefinita è
'/ Tmp'.

UTENTE FILE

$HOME/.wmlrc ed (../)*.wmlrc
Questi file possono anche contenere stringhe di opzioni, un'opzione per riga. Di solito il
i contenuti sono uno o più -D opzioni, in particolare quelle regolate automaticamente:

-DROOTREL~.
-DROOTAB=http://thishost/thisarea/
:
-DNAME1=VALORE1
-DNAME2=VALORE2
:

STANDARD INCLUDERE FILE

WML viene fornito con un set standard di file di inclusione. Puoi includerli direttamente tramite

#usa wml::categoria::nome

e leggere la propria documentazione tramite

$ man wml::categoria::nome

See wml::contro tutti i(3) per una descrizione di tutti i file include disponibili.

SPECIALE CARATTERISTICHE

Il frontend di controllo WML fornisce alcune funzionalità speciali da solo:

Supporto della linea Shebang
WML riconosce a faccenda riga (``"#!wml" Opzioni'') nel .wml file e
aggiunge automaticamente Opzioni alla sua riga di comando. Questa linea è utilizzata anche da WMk. Due
sono disponibili funzioni speciali in contrasto con le linee shebang per il caricatore Unix: WML's
la linea shebang può essere continuata tramite un carattere barra rovesciata e i costrutti %DIR e
% sono interpolati (dove %DIRèil percorso della directory sorgente mentre
risiede e %BASE è il nome del file sorgente senza alcuna estensione).

Esempio:

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

Tag contenitore protezione dati
WML fornisce un proprio tag contenitore interno denominato "
[pass=SPEC]>"..." " che può essere utilizzato per proteggere qualsiasi tipo di dato dall'essere
elaborato da qualsiasi passaggio WML. Quando non viene fornito alcun attributo "pass" SPEC il valore predefinito è "1-9".
Quando usi "pass" allora SPEC può essere "#-", "-#", "#-#" o separato da virgole
elenco di passaggi, mentre "#" può essere compreso tra 1 e 9.

Esempio:



...
uscita = " " + help_string + " "
...



Attenzione:

Da WML 2.0.3, il passaggio 1 include cose extra per aiutare a mantenere le informazioni sulla linea
numeri rilevanti (a la cpp). Quindi quando scrivi


#include 'pippo'


questi comandi extra non verranno interpretati durante il passaggio 2 e rimarranno in output.
Per sopprimerli, compila con il flag "-W1,-N" o scrivi


#include 'pippo' IPP_NOSYNCLINES

AUTORI

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

Denis Barbier
[email protected]

Usa wml online utilizzando i servizi onworks.net