wml - Online sa Cloud

PROGRAMA:

NAME

WML - Website META Language

VERSION

2.0.12 (16-Abr-2008)

SINOPSIS

wml [-I PATH] [-i PATH] [-D NAME=STR] [-D NAME~PATH] [-n] [-r] [-O antas] [-o
[SLICETERM":"]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [inputfile]

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

DESCRIPTION

Ito ang control program ng Website META Wika (WML), isang libreng henerasyon ng HTML
toolkit para sa Unix, panloob na binubuo ng 9 na independiyenteng mga wika.

Ang pangunahing ideya ng WML ay isang sequential filtering scheme kung saan ang bawat wika ay nagbibigay ng isa sa
9 na processing pass. Kaya wml bumabasa inputfile (o mula sa si stdin if inputfile ay isang gitling o
ganap na nawawala), nalalapat ang mga pass 1-9 (o ang mga pass lamang na tinukoy ni -p) at sa wakas
gumagawa ng isa o higit pa outputfiles.

Para sa higit pang mga detalye sa pamamaraan sa pagpoproseso na ito basahin ang WML pagpapakilala sa ilalim wml_intro(7)
at ang WML Sangguni sa ilalim wml_tutorialNa (7).

Opsyon

-I, --include=PATH
Nagdadagdag a direktoryo sa listahan ng user isama ang mga path. Gamitin ang opsyong ito para itakda ang runtime
kapaligiran para sa pass 1. Tingnan wml_p1_ipp(3) para sa higit pang mga detalye.

-i, --includefile=PATH
Pre-load ng isang partikular na kasama file, ibig sabihin, halos nagdadagdag ng a

#include "PATH"

sa ibabaw ng inputfile. Gamitin ito para awtomatikong isama ang default na user isama ang mga file.
Kung gusto mong isama ang isang system kasama ang file kailangan mong palibutan ang PATH may anggulo
mga bracket, halimbawa gumamit ng ``"-i" " "'' para isama ang file foo/bar.wml
mula sa system isama ang lugar. Bilang kahalili maaari mong gamitin ang espesyal na syntax
``"wml::foo::bar"'' tulad ng sa "#use" na direktiba.

-D, --define=NAME=STR
Tinutukoy ang isang variable na maaaring i-interpolate sa pass 1 (IPP) sa pamamagitan ng "$(NAME)", sa pass 2
(mp4h) sa pamamagitan ng <"get-var NAME">, sa pass 3 (ePerl) sa pamamagitan ng "<:=$NAME:>" at sa pass 4 (GNU m4)
sa pamamagitan ng "m4_NAME". Isang espesyal na variant --define=NAME=UNDEF ginagawa ang kabaligtaran, tinatanggal nito
nakaraang mga kahulugan (na maaaring iba kaysa sa hindi pagtukoy sa mga variable na ito, hal
na may mga variable na tinukoy ng system).

-D, --define=NAME~PATH
Katulad ng nasa itaas ngunit tumutukoy sa isang variable na may hawak na pathname na awtomatikong inaayos
(tingnan sa ibaba). Maaari itong i-interpolate sa parehong mga paraan tulad ng "NAME=STR" na variant mula sa
sa itaas.

-n, --noshebang
Pinipilit nito ang WML na huwag pansinin ang isang posibleng naglalaman ng shebang line inputfile. Ito ay
karaniwang ginagamit ng WMk, dahil na-parse na ng WMk ang linyang ito at nagbigay ng mga opsyon sa
WML.

-r, --norcfile
Pinipilit nito ang WML na huwag pansinin ang lahat .wmlrc file.

-c, --nocd
Kapag nagproseso ang WML ng isang input file mula sa isa pang direktoryo, tumalon ito sa direktoryo na iyon
bago i-parse .wmlrc file, at tumalon pabalik sa kasalukuyang direktoryo pagkatapos. Kung ang pagpipiliang ito
ay nakatakda, walang pagbabago sa direktoryo na ginawa at .wmlrc Ang mga file ay binabasa na reative sa kasalukuyang
gumaganang direktoryo.

-O, --optimize=NUM
Ito ang opsyon sa pag-optimize na direktang ipinapasa upang pumasa sa 8 (htmlfix). Ito
kinokontrol ang dami ng optimization/stripping na inilalapat sa nabuong HTML
markup code.

-o, --outputfile=SLICETERM:outputfile[@CHMODOPT]
Nire-redirect nito ang output sa isang file. Karaniwan ang buong file ay ipapadala sa stdout
(kapareho ng "LAHAT:-"). Maaari mong gamitin ang opsyong ito nang higit sa isang beses upang mag-output sa higit sa isa
file habang ginagamit ang SLICETERM bilang isang set theory term ng mga hiwa upang matukoy kung alin
ang mga nilalaman ay isasama sa bawat partikular na output file. Ang opsyonal CHMODOPT is
nilayon para sa pagtukoy ng mga opsyon para sa isang huling inilapat chmod utos. Halimbawa gamit
``"u+x"'' para gumawa ng file na may bit set ng execution (feature na XBitHack ng Apache).
Tingnan pagpira-pirasuhin(1) para sa higit pang mga detalye.

-P, --prolog=PATH
Nagpapatakbo ng prolog na filter sa input file. Ang program na ito ay tumatanggap ng data upang kumilos
bilang STDIN at kailangang gumawa ng na-filter na data sa STDOUT.

-E, --epilog=PATH
Nagpapatakbo ng isang epilogue program sa mga huling resultang output file. Sa kasalukuyan ang
ang mga sumusunod na programang tukoy sa WML ay kilala: htmlinfo, linklint, malaki na rin at weblint. Pero
maaari mong tukuyin ang anumang programa na magagamit sa iyong "PATH". Ang programang ito ay tumatanggap
ang file upang kumilos bilang unang argumento ng command line. Pansinin na ang output ay hindi
na-redirect sa file na ito, kaya kailangan mong gumamit ng isang wrapper o program na partikular na mga flag kung ikaw
gustong baguhin ang mga output file.

-t, --settime
Itinatakda nito ang oras ng pagbabago ng lahat ng mga output file sa oras ng pagbabago ng
inputfile plus 1 segundo. Ito ay kapaki-pakinabang dahil ang mga Webserver ay bubuo
"Huling Binago" na mga header at doon ang oras ng pag-edit ay mas mahalaga kaysa sa
panahon ng henerasyon. Ang 1 segundong offset ay para sa mga dependency ng Makefiles.

-M, --depende[=Opsyon]
Mag-output ng isang panuntunan na angkop para sa `make' na naglalarawan sa mga dependency ng bawat output file, bilang
ginagawa ng `gcc'. Ito ay may kahulugan lamang kapag ang -o ginagamit ang opsyon. Walang processing na ginagawa
maliban sa unang pass.

Ang D Ang opsyon sa flag ay nagsusulat ng panuntunan sa isang dependency file. Ang pangalan ng file na ito ay
nakuha sa pamamagitan ng pagpapalit ng suffix ng output file ng ".d".

Ang M Ang pagpipiliang bandila ay nagtatanggal ng mga file ng system mula sa listahan ng mga dependency.

-p, --pass=STR
Tinutukoy kung alin sa mga pass na inilarawan sa itaas ang aktwal na inilapat sa ilalim ng runtime. Ang
argumento STR ay isang listahan ng mga pass number na pinaghihiwalay ng kuwit na may isang espesyal na kaso: Maaari mo
isulat ang "XY" para sa lahat ng pass "X...Y". Kapag ang pass 9 ay hindi bahagi ng STR ang resulta
ang output ay nakasulat sa STDOUT. Default ay ang string ``"1-9"''.

-W, --passoption=NUM,STR
Itakda ang opsyon STR para sa pass NUM.

-s, --ligtas
Hindi nito pinapagana ang ilang Perl hack sa loob ng WML na nagpapabilis sa pagproseso sa pamamagitan ng pagbabawas ng
forking overhead kapag tumatakbo ang iba't ibang pass.

Kung wala ang opsyong ito, na-pre-compile ng WML ang mga pass 1,5,6,7,8 (na nakasulat sa Perl!)
sa ibang namespace ng kasalukuyang tumatakbong Perl interpreter sa halip na
pagpapatakbo ng mga ito sa labas sa pamamagitan ng "system()". Ang epekto ay ang mga programang ito ay pinapatakbo mula sa
sa loob ng parehong Perl interpreter kaya nakakatipid ng limang CPU- at time-intensive na "fork()"'s.
Ang aktwal na nakuha ay sa pagitan ng 2 at 4 na segundo ng oras ng pagproseso. Kahit na karanasan
ay nagpakita na ito ay mahusay na gumagana, ang teoretikal na problema pa rin, na ang diskarte na ito ay
medyo delikado dahil sa internal Perl variable conflicts.

Gamitin ang opsyong ito upang huwag paganahin ang mga speedup na ito sa pamamagitan ng pagpilit sa WML na gamitin ang ligtas na "fork()"
diskarte.

-v, --verbose[=NUM]
Nagtatakda ito ng verbose mode (mula 1 hanggang 9) kung saan ibibigay ang ilang impormasyon sa pagproseso
sa console. Kapaki-pakinabang para sa pag-debug. Ang opsyong ito ay naipapasa din sa ilan sa
mga programa sa pagsasala. Ang default ay walang verbosity at makatarungan -v paraan -v1.

-q, --tahimik
Nagtatakda ito ng quiet mode kung saan hindi na ipinapakita ang processing prop. Gamitin mo to
opsyon kapag tumatakbo wml bilang isang batch job. Awtomatikong pinipilit ang opsyong ito kapag
inputfile ay nawawala. Pagkatapos ay awtomatikong nagbabasa ang WML mula sa si stdin sa quiet mode.

-V, --bersyon[=NUM]
Nagbibigay ng string ng pagkakakilanlan ng bersyon at disclaimer (no NUM or NUM >= 1), ang WML
bumuo ng impormasyon (NUM >= 2) at ang Perl build information (NUM >= 3). Gamitin mo to
opsyon upang makakuha ng maikling paglalarawan ng iyong naka-install na WML system, lalo na kapag
pag-uulat ng mga bug sa may-akda.

-h, - Tumulong
Ini-print ang pahina ng buod ng paggamit.

Kapaligiran

TINUTUKOY MGA VARIABLE
Ang mga sumusunod na variable ay palaging tinutukoy ng wml sa ilalim ng runtime at karaniwan ay
interpolated sa pamamagitan ng <"get-var NAME"> sa loob ng Pass 2 at sa pamamagitan ng $NAME sa Pass 3.

WML_SRC_DIRNAME
Ang kasalukuyang gumaganang direktoryo mula sa kung saan wml ay nagsimula. Isang ganap na Unix filesystem
landas.

WML_SRC_FILENAME
Ang pangalan ng inputfile mula sa command line. Kapaki-pakinabang kapag tumatakbo wml sa isang bulk ng
Ang mga file at kasama ang mga file ay kailangang matukoy kung saan sila kasama.

WML_SRC_BASENAME
Ang basename ng inputfile, ibig sabihin, ang "WML_SRC_FILENAME", ngunit may extension
hinubaran na.

WML_SRC_TIME
Ang huling oras ng pagbabago ng inputfile sa "time()" na format. Mga kapaki-pakinabang na panloob na footer
kapag kailangan ang customized na format ng petsa.

WML_SRC_CTIME
Ang huling oras ng pagbabago ng inputfile sa "ctime()" na format. Mga kapaki-pakinabang na panloob na footer
isama ang mga file.

WML_SRC_ISOTIME
Ang huling oras ng pagbabago ng inputfile sa ISO na "yyyy-mm-dd hh:mm:ss" na format. Kapaki-pakinabang
Kasama sa mga inside footer ang mga file.

WML_SRC_USERNAME
Ang Unix username ng user na nagmamay-ari inputfile.

WML_SRC_REALNAME
Ang tunay na pangalan ng gumagamit na nagmamay-ari inputfile.

WML_GEN_TIME
Ang kasalukuyang oras ng henerasyon sa "time()" na format. Kapaki-pakinabang sa loob footer kapag
kailangan ang customized na format ng petsa.

WML_GEN_CTIME
Ang kasalukuyang oras ng henerasyon sa "ctime()" na format. Kasama sa mga kapaki-pakinabang na inside footer
file.

WML_GEN_ISOTIME
Ang kasalukuyang oras ng pagbuo sa ISO na "yyyy-mm-dd hh:mm:ss" na format. Kapaki-pakinabang sa loob
Kasama sa mga footer ang mga file.

WML_GEN_USERNAME
Ang Unix username ng user na nagpapatakbo ng wml proseso.

WML_GEN_REALNAME
Ang tunay na pangalan ng user na nagpapatakbo ng wml proseso.

WML_GEN_HOSTNAME
Ang pangalan ng host kung saan ang wml tumatakbo ang utos.

WML_LOC_PREFIX
Ang prefix ng lokasyon kung saan na-install ang WML sa oras ng pagkakagawa.

WML_LOC_BINDIR
Ang direktoryo kung saan naka-install ang mga binary ng WML sa oras na binuo.

WML_LOC_LIBDIR
Ang direktoryo kung saan naka-install ang mga file ng library ng WML sa oras na binuo.

WML_LOC_DATADIR
Ang direktoryo kung saan naka-install ang mga file ng data ng WML sa oras na binuo.

WML_LOC_MANDIR
Ang direktoryo kung saan naka-install ang mga manu-manong pahina ng WML sa oras na binuo.

WML_VERSION
Ang string ng pagkakakilanlan ng bersyon ng WML. Gamitin ito halimbawa sa mga komento sa HTML
sa loob ng header ay may kasamang upang matukoy ang bersyon ng mga tool sa pagbuo.

GINAMIT MGA VARIABLE
"WMLOPTS"
Ang variable na ito ay maaaring maglaman ng isang string ng mga opsyon. Kadalasan ito ay ginagamit ng Bourne-Shell
gusto ng mga gumagamit

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

at ng mga gumagamit ng C-Shell tulad ng

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

upang matiyak na ang ilang mga variable ay tinukoy para sa lahat ng mga pagpapatakbo ng wml.

"PAGER"
Ang variable na ito ay naglalaman ng pager na gagamitin ng WML. Gumagamit ang WML ng pager kapag tinawag kasama ang
--verbose=NUM or -vNUM opsyon ayon sa pagkakabanggit at NUM ay 3 o mas mataas at samakatuwid
ipinapakita ang naprosesong data pagkatapos ng bawat pass. Default ay 'higit pa'.

"TMPDIR"
Ang variable na ito ay naglalaman ng direktoryo kung saan iniimbak ng WML ang mga pansamantalang file nito. Ang default ay
'/ Tmp'.

USER MGA FILE

$HOME/.wmlrc at (../)*.wmlrc
Ang mga file na ito ay maaari ding maglaman ng mga string ng opsyon, isang opsyon sa bawat linya. Karaniwan ang
ang nilalaman ay isa o higit pa -D mga opsyon, lalo na ang mga awtomatikong na-adjust:

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

STANDARD MAISASALI MGA FILE

Ang WML ay ipinadala kasama ng isang karaniwang hanay ng mga file na kasama. Maaari mong direktang isama ang mga ito sa pamamagitan ng

#use wml::category::name

at basahin ang kanilang sariling dokumentasyon sa pamamagitan ng

$ man wml::category::name

Tingnan wml::lahat(3) para sa isang paglalarawan ng lahat ng magagamit isama ang mga file.

ESPESYAL TAMPOK

Ang WML control frontend ay nagbibigay ng ilang mga espesyal na tampok sa sarili nitong:

Suporta sa Shebang Line
Kinikilala ng WML ang a shebang linya (``"#!wml" pagpipilian'') nasa .wml mga file at
awtomatikong nagdaragdag pagpipilian sa command line nito. Ang linyang ito ay ginagamit din ng WMk. Dalawa
ang mga espesyal na tampok sa kaibahan sa mga linya ng shebang para sa Unix loader ay magagamit: WML's
shebang line ay maaaring ipagpatuloy sa pamamagitan ng isang backslash na character at ang mga konstruksyon na %DIR at
% ay interpolated (kung saan ang %DIR ay ang landas sa direktoryo ang pinagmulan habang
naninirahan at ang %BASE ay ang filename ng source file nang walang anumang extension).

Halimbawa:

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

Tag ng Container ng Proteksyon ng Data
Nagbibigay ang WML ng sariling tag ng panloob na container na pinangalanang "
[pass=SPEC]>"..." " na maaaring gamitin upang protektahan ang anumang uri ng data mula sa pagiging
naproseso ng anumang WML pass. Kapag walang ibinigay na attribute na "pass". SPEC default sa "1-9".
Kapag gumamit ka ng "pass" noon SPEC maaaring alinman sa "#-", "-#", "#-#" o pinaghihiwalay ng kuwit
listahan ng mga pass, habang ang "#" ay maaaring nasa pagitan ng 1 at 9.

Halimbawa:



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



Babala:

Dahil ang WML 2.0.3, ang pass 1 ay may kasamang mga karagdagang bagay upang makatulong sa pagpapanatili ng impormasyon tungkol sa linya
mga numerong nauugnay (a la cpp). Kaya kapag nagsusulat


#isama ang 'foo'


ang mga karagdagang command na ito ay hindi mabibigyang-kahulugan sa panahon ng pass 2 at mananatili sa output.
Upang sugpuin ang mga ito, mag-compile gamit ang "-W1,-N" na flag, o magsulat


#include 'foo' IPP_NOSYNCLINES

MGA AUTHORS

Ralf S. Engelchall
[protektado ng email]
www.engelschall.com

Denis Barbier
[protektado ng email]

Gumamit ng wml online gamit ang mga serbisyo ng onworks.net