wml - Dalam talian dalam Awan

JADUAL:

NAMA

WML - Bahasa META Laman Web

VERSION

2.0.12 (16-Apr-2008)

SINOPSIS

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

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

DESCRIPTION

Ini adalah program kawalan tapak web MATLAMAT Bahasa (WML), generasi HTML percuma
kit alat untuk Unix, secara dalaman terdiri daripada 9 bahasa bebas.

Idea utama WML ialah skema penapisan berjujukan di mana setiap bahasa menyediakan salah satu daripadanya
9 pas pemprosesan. Jadi wml dibaca fail input (atau daripada stdin if fail input ialah sengkang atau
hilang sepenuhnya), menggunakan pas 1-9 (atau hanya pas yang ditentukan oleh -p) dan akhirnya
menghasilkan satu atau lebih fail keluarans.

Untuk butiran lanjut mengenai skim pemprosesan ini, baca bahagian WML Pengenalan di bawah wml_intro(7)
dan juga WML tutorial di bawah wml_tutorial(7).

PILIHAN

-I, --termasuk=PATH
Tambah a direktori ke senarai pengguna sertakan laluan. Gunakan pilihan ini untuk menetapkan masa jalan
persekitaran untuk lulus 1. Lihat wml_p1_ipp(3) untuk maklumat lanjut.

-i, --includefile=PATH
Pra-muat tertentu termasuk fail, iaitu hampir menambah a

#include "PATH"

di atas fail input. Gunakan ini untuk memasukkan fail pengguna lalai secara automatik.
Jika anda ingin menyertakan sistem sertakan fail anda perlu mengelilingi fail tersebut PATH dengan sudut
kurungan, contohnya gunakan ``"-i" " "'' untuk memasukkan fail foo/bar.wml
daripada sistem termasuk kawasan. Sebagai alternatif anda boleh menggunakan sintaks khas
``"wml::foo::bar"'' seperti arahan "#use".

-D, --define=NAMA=STR
Mentakrifkan pembolehubah yang boleh diinterpolasi dalam laluan 1 (IPP) melalui "$(NAME)", dalam laluan 2
(mp4j) melalui <"get-var NAME">, dalam laluan 3 (ePerl) melalui "<:=$NAME:>" dan dalam laluan 4 (GNU m4)
melalui "m4_NAME". Varian istimewa --define=NAMA=UNDEF melakukan sebaliknya, ia memadam
takrifan sebelumnya (yang mungkin berbeza daripada tidak mentakrifkan pembolehubah ini, cth
dengan pembolehubah yang ditentukan sistem).

-D, --define=NAMA~PATH
Sama seperti di atas tetapi mentakrifkan pembolehubah yang memegang nama laluan yang dilaraskan secara automatik
(lihat di bawah). Ia boleh diinterpolasi dengan cara yang sama seperti varian "NAME=STR" daripada
atas.

-n, --noshebang
Ini memaksa WML untuk mengabaikan baris shebang yang mungkin terkandung fail input. Ini adalah
biasanya digunakan oleh WMk, kerana WMk sudah menghuraikan baris ini dan membekalkan pilihan kepada
WML.

-r, --norcfile
Ini memaksa WML untuk mengabaikan semua .wmlrc fail.

-c, --nocd
Apabila WML memproses fail input daripada direktori lain, ia melompat ke dalam direktori itu
sebelum menghuraikan .wmlrc fail, dan lompat kembali ke direktori semasa selepas. Jika pilihan ini
ditetapkan, tiada perubahan direktori dibuat dan .wmlrc fail dibaca reatif kepada semasa
direktori kerja.

-O, --optimumkan=NUM
Ini ialah pilihan pengoptimuman yang dihantar terus ke lulus 8 (htmlfix). Ia
mengawal jumlah pengoptimuman/pelucutan yang digunakan pada HTML yang dijana
kod markup.

-o, --outputfile=SLICETERM:fail keluaran[@CHMODOPT]
Ini mengubah hala output ke fail. Biasanya keseluruhan fail akan dihantar ke stdout
(sama seperti "SEMUA:-"). Anda boleh menggunakan pilihan ini lebih daripada sekali untuk menghasilkan lebih daripada satu
fail semasa menggunakan SLICETERM sebagai istilah teori set hirisan untuk menentukan yang mana
kandungan akan dimasukkan ke dalam setiap fail output tertentu. Pilihan CHMODOPT is
bertujuan untuk menentukan pilihan untuk akhirnya digunakan Chmod perintah. Contohnya penggunaan
``"u+x"'' untuk mencipta fail dengan set bit pelaksanaan (ciri XBitHack Apache).
Lihat keping(1) untuk maklumat lanjut.

-P, --prolog=PATH
Menjalankan penapis prolog ke atas fail input. Program ini menerima data untuk bertindak
sebagai STDIN dan perlu menghasilkan data yang ditapis pada STDOUT.

-E, --epilog=PATH
Menjalankan program epilog ke atas fail output yang akhirnya terhasil. Pada masa ini
program khusus WML berikut diketahui: htmlinfo, linklint, kemas and weblint. tetapi
anda boleh menentukan mana-mana program yang tersedia dalam "PATH" anda. Program ini menerima
fail untuk bertindak sebagai hujah baris arahan pertamanya. Perhatikan bahawa output tidak
diubah hala ke fail ini, jadi anda perlu menggunakan pembungkus atau program bendera khusus jika anda
ingin mengubah suai fail output.

-t, --tetapkan masa
Ini menetapkan masa pengubahsuaian semua fail output kepada masa pengubahsuaian bagi
fail input tambah 1 saat. Ini berguna kerana Pelayan Web akan menjana
Tajuk "Terakhir Diubah Suai" dan di sana masa menyunting adalah lebih penting daripada
masa generasi. Offset 1 saat adalah untuk kebergantungan Makefiles.

-M, --bergantung[=PILIHAN]
Keluarkan peraturan yang sesuai untuk `membuat' yang menerangkan kebergantungan setiap fail output, sebagai
`gcc' boleh. Ia hanya mempunyai rasa apabila -o pilihan digunakan. Tiada pemprosesan dilakukan
kecuali pas pertama.

. D pilihan bendera menulis peraturan ke fail pergantungan. Nama fail ini ialah
diperoleh dengan menggantikan akhiran fail output dengan ".d".

. M pilihan bendera memadamkan fail sistem daripada senarai kebergantungan.

-p, --lulus=STR
Menentukan pas yang diterangkan di atas sebenarnya digunakan di bawah masa jalan. The
hujah STR ialah senarai nombor pas yang dipisahkan koma dengan satu kes khas: Anda boleh
tulis "XY" untuk semua pas "X...Y". Apabila lulus 9 bukan sebahagian daripada STR yang terhasil
output ditulis kepada STDOUT. Lalai ialah rentetan ``"1-9"''.

-W, --passoption=NUM,STR
Tetapkan pilihan STR untuk pas NUM.

-s, --selamat
Ini melumpuhkan beberapa hacks Perl di dalam WML yang mempercepatkan pemprosesan dengan mengurangkan
bercabang atas kepala apabila menjalankan pelbagai hantaran.

Tanpa pilihan ini WML pra-kompil pas 1,5,6,7,8 (yang ditulis dalam Perl!)
ke ruang nama yang berbeza bagi penterjemah Perl yang sedang dijalankan dan bukannya
menjalankannya secara luaran melalui "sistem()". Kesannya ialah program ini dijalankan daripada
dalam penterjemah Perl yang sama sekali gus menjimatkan lima CPU dan "fork()" intensif masa.
Keuntungan sebenar adalah antara 2 dan 4 saat masa pemprosesan. Walaupun pengalaman
menunjukkan bahawa ia berfungsi hebat, masalah teorinya masih, bahawa pendekatan ini adalah
agak berisiko disebabkan konflik pembolehubah Perl dalaman.

Gunakan pilihan ini untuk melumpuhkan kelajuan ini dengan memaksa WML menggunakan "fork()" yang selamat
pendekatan.

-v, --verbose[=NUM]
Ini menetapkan mod verbose (dari 1 hingga 9) di mana beberapa maklumat pemprosesan akan diberikan
pada konsol. Berguna untuk nyahpepijat. Pilihan ini juga diberikan kepada beberapa
program penapisan. Lalai adalah tidak bertele-tele dan adil -v cara -v1.

-q, --senyap
Ini menetapkan mod senyap di mana prop pemprosesan tidak lagi dipaparkan. Guna ini
pilihan semasa berjalan wml sebagai kerja kelompok. Pilihan ini secara automatik dipaksa apabila
fail input sedang hilang. Kemudian WML secara automatik membaca daripada stdin dalam mod senyap.

-V, --versi[=NUM]
Memberi rentetan pengenalan versi dan penafian (no NUM or NUM >= 1), WML
membina maklumat (NUM >= 2) dan maklumat binaan Perl (NUM >= 3). Guna ini
pilihan untuk mendapatkan penerangan ringkas tentang sistem WML anda yang dipasang, terutamanya apabila
melaporkan pepijat kepada pengarang.

-h, - membantu
Mencetak halaman ringkasan penggunaan.

PERSEKITARAN

DENTIKAN PELBAGAI
Pembolehubah berikut sentiasa ditakrifkan oleh wml di bawah runtime dan biasanya
diinterpolasi melalui <"get-var NAME"> di dalam Pass 2 dan melalui $NAME dalam Pass 3.

WML_SRC_DIRNAME
Direktori kerja semasa dari mana wml telah bermula. Sistem fail Unix mutlak
laluan.

WML_SRC_FILENAME
Nama fail input daripada baris arahan. Berguna semasa berlari wml pada sebahagian besar
fail dan includefiles perlu menentukan di mana ia disertakan.

WML_SRC_BASENAME
Nama asas bagi fail input, iaitu "WML_SRC_FILENAME", tetapi dengan sambungan
sudah dibogelkan.

WML_SRC_TIME
Masa pengubahsuaian terakhir bagi fail input dalam format "masa()". Pengaki dalam berguna
apabila format tarikh tersuai diperlukan.

WML_SRC_CTIME
Masa pengubahsuaian terakhir bagi fail input dalam format "ctime()". Pengaki dalam berguna
sertakan fail.

WML_SRC_ISOTIME
Masa pengubahsuaian terakhir bagi fail input dalam format ISO "yyyy-mm-dd hh:mm:ss". Berguna
pengaki dalam termasuk fail.

WML_SRC_USERNAME
Nama pengguna Unix bagi pengguna yang memiliki fail input.

WML_SRC_REALNAME
Nama sebenar pengguna yang memiliki fail input.

WML_GEN_TIME
Masa penjanaan semasa dalam format "masa()". Pengaki dalam berguna apabila
format tarikh tersuai diperlukan.

WML_GEN_CTIME
Masa penjanaan semasa dalam format "ctime()". Pengaki dalam yang berguna termasuk
fail.

WML_GEN_ISOTIME
Masa penjanaan semasa dalam format ISO "yyyy-mm-dd hh:mm:ss". Berguna di dalam
pengaki termasuk fail.

WML_GEN_USERNAME
Nama pengguna Unix bagi pengguna yang menjalankan wml proses.

WML_GEN_REALNAME
Nama sebenar pengguna yang menjalankan wml proses.

WML_GEN_HOSTNAME
Nama hos yang wml arahan berjalan.

WML_LOC_PREFIX
Awalan lokasi tempat WML dipasang pada masa dibina.

WML_LOC_BINDIR
Direktori tempat binari WML dipasang pada masa dibina.

WML_LOC_LIBDIR
Direktori tempat fail perpustakaan WML dipasang pada masa terbina.

WML_LOC_DATADIR
Direktori tempat fail data WML dipasang pada masa terbina.

WML_LOC_MANDIR
Direktori tempat halaman manual WML dipasang pada masa dibina.

WML_VERSION
Rentetan pengenalan versi WML. Gunakan ini sebagai contoh dalam ulasan HTML
dalam header termasuk untuk mengenal pasti versi alat penjanaan.

DIGUNAKAN PELBAGAI
"WMLOPTS"
Pembolehubah ini boleh mengandungi rentetan pilihan. Biasanya ini digunakan oleh Bourne-Shell
pengguna suka

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

dan oleh pengguna C-Shell seperti

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

untuk memastikan beberapa pembolehubah ditakrifkan untuk semua larian wml.

"PAGER"
Pembolehubah ini mengandungi alat kelui WML yang akan digunakan. WML menggunakan kelui apabila dipanggil dengan
--verbose=NUM or -vNUM pilihan masing-masing dan NUM ialah 3 atau lebih tinggi dan oleh itu
menunjukkan data yang diproses selepas setiap pas. Lalai ialah 'lebih'.

"TMPDIR"
Pembolehubah ini mengandungi direktori WML menyimpan fail sementaranya. Lalai ialah
'/ tmp'.

PENGGUNA FILES

$HOME/.wmlrc and (../)*.wmlrc
Fail ini juga boleh mengandungi rentetan pilihan, satu pilihan setiap baris. Biasanya yang
kandungan adalah satu atau lebih -D pilihan, terutamanya yang dilaraskan secara automatik:

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

STANDARD TERMASUK FILES

WML dihantar dengan set standard termasuk fail. Anda boleh memasukkannya terus melalui

#use wml::category::name

dan membaca dokumentasi mereka sendiri melalui

$ man wml::category::name

Lihat wml::semua(3) untuk penerangan semua yang ada termasuk fail.

KHAS CIRI-CIRI

Bahagian hadapan kawalan WML menyediakan beberapa ciri khas sendiri:

Sokongan Talian Shebang
WML mengiktiraf a shebang baris (``"#!wml" pilihan'') di dalam .wml fail dan
secara automatik menambah pilihan kepada baris arahannya. Baris ini juga digunakan oleh WMk. dua
ciri khas berbeza dengan garisan shebang untuk pemuat Unix tersedia: WML's
garisan shebang boleh diteruskan melalui aksara sengkang terbalik dan binaan %DIR dan
% diinterpolasi (di mana %DIR ialah laluan ke direktori sumber manakala
tinggal dan %BASE ialah nama fail bagi fail sumber tanpa sebarang sambungan).

Contoh:

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

Tag Bekas Perlindungan Data
WML menyediakan teg bekas dalaman sendiri bernama "
[lulus=SPEC]>"..." " yang boleh digunakan untuk melindungi sebarang jenis data daripada menjadi
diproses oleh mana-mana pas WML. Apabila tiada atribut "lulus" diberikan SPEC lalai kepada "1-9".
Apabila anda menggunakan "lulus" kemudian SPEC boleh sama ada "#-", "-#", "#-#" atau dipisahkan koma
senarai pas, manakala "#" boleh antara 1 dan 9.

Contoh:



...
keluaran = " " + tali_bantuan + " "
...



Amaran:

Sejak WML 2.0.3, pas 1 termasuk bahan tambahan untuk membantu menyimpan maklumat tentang talian
nombor yang berkaitan (ala cpp). Jadi apabila menulis


#include 'foo'


arahan tambahan ini tidak akan ditafsirkan semasa pas 2 dan akan kekal pada output.
Untuk menyekatnya, sama ada susun dengan bendera "-W1,-N" atau tulis


#include 'foo' IPP_NOSYNCLINES

PENGARANG

Ralf S. Engelchall
[e-mel dilindungi]
www.engelschall.com

Denis Barbier
[e-mel dilindungi]

Gunakan wml dalam talian menggunakan perkhidmatan onworks.net