wml - Online în cloud

PROGRAM:

NUME

WML - Website META Language

VERSIUNE

2.0.12 (16-apr-2008)

REZUMAT

wml [-I PATH] [-i PATH] [-D NUME=STR] [-D NUME~PATH] [-n] [-r] [-O nivel] [-o
[SLICTERM":"]PATH[@CHMODOPT,-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [fișier de intrare]

wml [-V [NUM,-h]

DESCRIERE

Acesta este programul de control al website META Limbă (WML), o generație HTML gratuită
set de instrumente pentru Unix, format intern din 9 limbi independente.

Ideea principală a WML este o schemă de filtrare secvențială în care fiecare limbă oferă una dintre ele
9 treceri de procesare. Asa de wml citește fișier de intrare (sau de la stdin if fișier de intrare este o liniuță sau
lipsește complet), aplică trecerile 1-9 (sau numai trecerile specificate de -p) și, în sfârșit
produce unul sau mai multe fisier de iesires.

Pentru mai multe detalii despre această schemă de procesare, citiți documentul WML Introducere în wml_intro(7)
si WML tutorial în wml_tutorial(7).

OPŢIUNI

-I, --include=PATH
Adăugă un director la lista de căi de includere a utilizatorilor. Utilizați această opțiune pentru a seta timpul de rulare
mediu pentru trecerea 1. Vezi wml_p1_ipp(3) pentru mai multe detalii.

-i, --includefile=PATH
Pre-încărcări o anumită include fişier, adică adaugă practic a

#include „CALEA”

în partea superioară a fișier de intrare. Utilizați aceasta pentru a include automat fișierele implicite de includere a utilizatorului.
Dacă doriți să includeți un fișier include sisteme, trebuie să înconjurați fișierul PATH cu unghi
paranteze, de exemplu, folosiți ``"-i" " „'' pentru a include fișierul foo/bar.wml
din zona de includere a sistemului. Alternativ, puteți utiliza sintaxa specială
``"wml::foo::bar"'' ca în directiva "#use".

-D, --define=NUME=STR
Definește o variabilă care poate fi interpolată în pasul 1 (IPP) prin „$(NAME)”, în pasul 2
(mp4h) prin <"get-var NAME">, în trecerea 3 (ePerl) prin "<:=$NAME:>" și în trecerea 4 (GNU m4)
prin „m4_NAME”. O varianta deosebita --define=NUME=UNDEF face invers, șterge
definiții anterioare (care pot fi diferite de nedefinirea acestor variabile, de ex
cu variabile definite de sistem).

-D, --define=NUME~PATH
Similar cu cele de mai sus, dar definește o variabilă care conține un nume de cale care este ajustat automat
(Vezi mai jos). Poate fi interpolat în aceleași moduri ca și varianta „NUME=STR” din
de mai sus.

-n, --noshebang
Acest lucru forțează WML să ignore o linie shebang posibil conținută în fișier de intrare. Acest lucru este
folosit de obicei de WMk, deoarece WMk a analizat deja această linie și a furnizat opțiunile
WML.

-r, --norcfile
Acest lucru forțează WML să ignore totul .wmlrc fișiere.

-c, --nocd
Când WML procesează un fișier de intrare dintr-un alt director, acesta sare în acel director
înainte de analizare .wmlrc fișiere și sări înapoi la directorul curent după. Dacă această opțiune
este setat, nu se face nicio schimbare de director și .wmlrc fișierele sunt citite în funcție de curent
directorul de lucru.

-O, --optimize=NUM
Aceasta este opțiunea de optimizare care este transmisă direct la trecerea 8 (htmlfix). Aceasta
controlează cantitatea de optimizare/decapare care este aplicată HTML-ului generat
cod de marcare.

-o, --outputfile=SLICTERM:fisier de iesire[@CHMODOPT]
Aceasta redirecționează rezultatul către un fișier. De obicei, întregul fișier va fi trimis către stdout
(la fel ca „TOȚI:-”). Puteți utiliza această opțiune de mai multe ori pentru a ieși la mai multe
fișier în timp ce utilizați SLICTERM ca termen al teoriei seturilor de felii pentru a determina care
conținutul va fi inclus în fiecare fișier de ieșire particular. Opționalul CHMODOPT is
destinate specificarii optiunilor pentru o aplicatie in final chmod comanda. De exemplu, folosiți
``"u+x"'' pentru a crea un fișier cu bitul de execuție setat (funcția XBitHack de la Apache).
Vedea felie(1) pentru mai multe detalii.

-P, --prolog=PATH
Rulează un filtru prolog peste fișierul de intrare. Acest program primește datele pentru a acționa
ca STDIN și trebuie să producă datele filtrate pe STDOUT.

-E, --epilog=PATH
Rulează un program epilog peste fișierele de ieșire rezultate în final. În prezent, cel
sunt cunoscute următoarele programe specifice WML: htmlinfo, linklint, ordonat și weblint. Dar
puteți specifica orice program disponibil în „PATH”. Acest program primește
fișierul pe care să acționeze ca prim argument în linia de comandă. Observați că ieșirea nu este
redirecționat către acest fișier, așa că trebuie să utilizați un wrapper sau un program de steaguri specifice dacă aveți
doriți să modificați fișierele de ieșire.

-t, --regleaza ora
Aceasta setează timpul de modificare a tuturor fișierelor de ieșire la timpul de modificare a
intrputfile plus 1 secundă. Acest lucru este util deoarece serverele web vor genera
Antetele „Last-Modified” și acolo timpul de editare este mai important decât
timpul generației. Offset-ul de 1 secundă este pentru dependențele Makefiles.

-M, --depinde[=OPŢIUNI]
Produceți o regulă potrivită pentru „make” care descrie dependențele fiecărui fișier de ieșire, cum ar fi
`gcc' face. Are sens numai atunci când -o este folosită opțiunea. Nu se face nicio prelucrare
cu excepția primei treceri.

D opțiunea flag scrie regula într-un fișier de dependență. Numele acestui fișier este
obţinut prin înlocuirea sufixului fişierului de ieşire cu „.d”.

M opțiunea flag șterge fișierele de sistem din lista de dependențe.

-p, --trece=STR
Specifică care dintre trecerile descrise mai sus sunt aplicate efectiv în timpul de execuție. The
argument STR este o listă de numere de permis, separate prin virgulă, cu un caz special: Poți
scrie "XY" pentru toate trecerile "X...Y". Când trecerea 9 nu face parte din STR rezultați
ieșirea este scrisă Stdout. Implicit este șirul ``"1-9"''.

-W, --passoption=NUM,STR
Setați opțiunea STR pentru trecere NUM.

-s, --sigur
Acest lucru dezactivează unele hack-uri Perl în interiorul WML, care accelerează procesarea prin reducerea
bifurcarea deasupra capului la rularea diferitelor treceri.

Fără această opțiune, WML precompilează trecerile 1,5,6,7,8 (care sunt scrise în Perl!)
într-un spațiu de nume diferit al interpretului Perl care rulează în prezent în loc de
rulându-le extern prin „system()”. Efectul este că aceste programe sunt rulate de la
în cadrul aceluiași interpret Perl, economisind astfel cinci CPU-uri „fork()” care necesită mult timp.
Câștigul real este între 2 și 4 secunde de timp de procesare. Deși experiență
a arătat că funcționează grozav, problema teoretică este încă, că această abordare este
oarecum riscant din cauza conflictelor interne de variabile Perl.

Utilizați această opțiune pentru a dezactiva aceste accelerații forțând WML să folosească „furcătura()” sigură
abordare.

-v, --verbos[=NUM]
Aceasta setează modul verbos (de la 1 la 9) în care vor fi date unele informații de procesare
pe consolă. Util pentru depanare. Această opțiune este transmisă și unora dintre
programe de filtrare. Implicit nu este verbozitate și just -v mijloace -v1.

-q, --Liniște
Aceasta setează modul silențios în care suportul de procesare nu mai este afișat. Foloseste asta
opțiune când rulați wml ca un lot. Această opțiune este forțată automat când
fișier de intrare lipseste. Apoi WML citește automat din stdin în modul silențios.

-V, --versiune[=NUM]
Oferă șirul de identificare a versiunii și declinarea răspunderii (nr NUM or NUM >= 1), WML
construiți informații (NUM >= 2) și informațiile de compilare Perl (NUM >= 3). Foloseste asta
opțiunea de a obține o scurtă descriere a sistemului dvs. WML instalat, mai ales când
raportarea erorilor către autor.

-h, --Ajutor
Imprimă pagina cu rezumatul utilizării.

MEDIUL

DEFINIT VARIABILE
Următoarele variabile sunt întotdeauna definite de wml în curs de execuție și sunt de obicei
interpolat prin <"get-var NAME"> în interiorul Pass 2 și prin $NAME în Pass 3.

WML_SRC_DIRNAME
Directorul de lucru curent de unde wml a fost început. Un sistem de fișiere Unix absolut
cale.

WML_SRC_FILENAME
Numele fișier de intrare din linia de comandă. Util când alergați wml pe o mare parte a
fișierele și includefiles trebuie să determine în care sunt incluse.

WML_SRC_BASENAME
Numele de bază al fișier de intrare, adică „WML_SRC_FILENAME”, dar cu extensia
deja dezbrăcat.

WML_SRC_TIME
Ora ultimei modificări a fișier de intrare în format „time()”. Subsolurile interioare utile
când este necesar un format de dată personalizat.

WML_SRC_CTIME
Ora ultimei modificări a fișier de intrare în format „ctime()”. Subsolurile interioare utile
include fișiere.

WML_SRC_ISOTIME
Ora ultimei modificări a fișier de intrare în format ISO „aaaa-mm-zz hh:mm:ss”. Util
subsolurile din interior includ fișiere.

WML_SRC_USERNAME
Numele de utilizator Unix al utilizatorului care deține fișier de intrare.

WML_SRC_REALNAME
Numele real al utilizatorului care deține fișier de intrare.

WML_GEN_TIME
Ora curentă de generare în format „time()”. Utile în interiorul subsolurilor când
este necesar un format de dată personalizat.

WML_GEN_CTIME
Ora curentă de generare în format „ctime()”. Subsolurile interioare utile includ
fișiere.

WML_GEN_ISOTIME
Ora actuală de generare în format ISO „aaaa-mm-zz hh:mm:ss”. Util în interior
subsolurile includ fișiere.

WML_GEN_USERNAME
Numele de utilizator Unix al utilizatorului care rulează wml proces.

WML_GEN_REALNAME
Numele real al utilizatorului care rulează wml proces.

WML_GEN_HOSTNAME
Numele gazdei pe care wml comanda rulează.

WML_LOC_PREFIX
Prefixul locației în care a fost instalat WML la momentul construirii.

WML_LOC_BINDIR
Directorul în care au fost instalate binarele WML la momentul construirii.

WML_LOC_LIBDIR
Directorul în care fișierele bibliotecii WML au fost instalate la momentul construirii.

WML_LOC_DATADIR
Directorul în care fișierele de date WML au fost instalate la momentul construirii.

WML_LOC_MANDIR
Directorul în care au fost instalate paginile de manual WML la momentul construirii.

WML_VERSION
Șirul de identificare a versiunii WML. Utilizați acest lucru, de exemplu, în comentariile HTML
antetul interior include pentru a identifica versiunea instrumentelor de generare.

FOLOSIT VARIABILE
„WMLOPTS”
Această variabilă poate conține un șir de opțiuni. De obicei, acesta este folosit de Bourne-Shell
utilizatorilor le place

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

și de utilizatorii C-Shell ca

$ setenv WMLOPTS „-DNAME1=VALUE2 -DNAME2=VALUE2”

pentru a vă asigura că unele variabile sunt definite pentru toate rulările de wml.

"PAGER"
Această variabilă conține paginatorul pe care trebuie să-l folosească WML. WML folosește un pager atunci când este apelat cu
--verbos=NUM or -vNUM opțiunea respectiv și NUM este 3 sau mai mare și, prin urmare
arătând datele prelucrate după fiecare trecere. Implicit este „mai mult”.

„TMPDIR”
Această variabilă conține directorul în care WML își stochează fișierele temporare. Implicit este
'/ tmp'.

USER DOSARE

$HOME/.wmlrc și (../)*.wmlrc
Aceste fișiere pot conține și șiruri de opțiuni, o opțiune pe linie. De obicei, cel
conținutul este unul sau mai multe -D opțiuni, în special cele ajustate automat:

-DROOTREL~.
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=VALOARE1
-DNAME2=VALOARE2
:

STANDARD INCLUDE DOSARE

WML este livrat cu un set standard de fișiere include. Le puteți include direct prin intermediul

#use wml::category::name

și să citească propria documentație prin

$ man wml::category::name

Vedea wml::toate(3) pentru o descriere a tuturor fișierelor includ disponibile.

SPECIAL CARACTERISTICI

Interfața de control WML oferă câteva caracteristici speciale în sine:

Asistență Shebang Line
WML recunoaște a shebang linie (``"#!wml" Opțiuni'') în .wml fișiere și
adaugă automat Opțiuni la linia sa de comandă. Această linie este folosită și de WMk. Două
Sunt disponibile caracteristici speciale în contrast cu liniile shebang pentru încărcătorul Unix: WML-uri
linia shebang poate fi continuată printr-un caracter backslash și constructele %DIR și
% sunt interpolate (unde %DIR este calea către directorul sursă în timp ce
rezidă și %BASE este numele fișierului sursă fără nicio extensie).

Exemplu:

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

Etichetă container de protecție a datelor
WML oferă o etichetă internă de container, numită „
[pass=SPEC]>"..." „care poate fi folosit pentru a proteja orice tip de date de a fi
procesate de orice trecere WML. Când nu este dat niciun atribut „pass”. SPEC implicit la „1-9”.
Când folosești „pass” atunci SPEC poate fi fie „#-”, „-#”, „#-#” sau separate prin virgulă
lista de permise, în timp ce „#” poate fi între 1 și 9.

Exemplu:



...
ieșire = " " + help_string + " "
...



Avertisment:

Începând cu WML 2.0.3, trecerea 1 include lucruri suplimentare pentru a ajuta la păstrarea informațiilor despre linie
numere relevante (a la cpp). Deci când scriu


#include „foo”


aceste comenzi suplimentare nu vor fi interpretate în timpul trecerii 2 și vor rămâne la ieșire.
Pentru a le suprima, fie compilați cu indicatorul „-W1,-N”, fie scrieți


#include „foo” IPP_NOSYNCLINES

AUTORI

Ralf S. Engelschall
[e-mail protejat]
www.engelschall.com

Denis Barbier
[e-mail protejat]

Utilizați wml online folosind serviciile onworks.net