wml - آنلاین در ابر

برنامه:

نام

WML - زبان متا وب سایت

نسخه

2.0.12 (16-آوریل 2008)

خلاصه

wml [-I PATH] [-i PATH] [-D نام=STR] [-D نام~PATH] [-n] [-r] [-O سطح] [-o
[SLICETERM":"]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [فایل ورودی]

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

شرح

این برنامه کنترلی است سایت اینترنتی متا زبان (WML)، یک نسل HTML رایگان
جعبه ابزار برای یونیکس، به صورت داخلی از 9 زبان مستقل تشکیل شده است.

ایده اصلی WML یک طرح فیلتر متوالی است که در آن هر زبان یکی از آنها را ارائه می دهد
9 پاس پردازش. بنابراین wml می خواند فایل ورودی (یا از stdin if فایل ورودی یک خط تیره یا
به طور کامل از دست رفته)، پاس های 1-9 را اعمال می کند (یا فقط پاس های مشخص شده توسط -p) و در نهایت
یک یا چند تولید می کند فایل خروجیs.

برای جزئیات بیشتر در مورد این طرح پردازش را بخوانید WML معرفی زیر wml_intro(7)
و WML آموزش زیر wml_tutorial(7).

OPTIONS

-I, --شامل=PATH
اضافه می کند a فهرست راهنما به لیست کاربر شامل مسیرها. از این گزینه برای تنظیم زمان اجرا استفاده کنید
محیط برای پاس 1. ببینید wml_p1_ipp(3) برای جزئیات بیشتر.

-i, --includefile=PATH
از پیش بارگذاری یک خاص شامل می شود پرونده، یعنی به صورت مجازی a اضافه می کند

#شامل "PATH"

در بالای فایل ورودی. از این برای درج خودکار فایل های شامل کاربر پیش فرض استفاده کنید.
اگر می‌خواهید یک فایل شامل سیستم‌ها اضافه کنید، باید آن را احاطه کنید PATH با زاویه
براکت ها، به عنوان مثال از ``"-i" " استفاده کنید "'' برای گنجاندن فایل foo/bar.wml
از سیستم شامل منطقه است. یا می توانید از نحو خاص استفاده کنید
"wml::foo::bar"" مانند دستورالعمل "#use".

-D, --define=نام=STR
متغیری را تعریف می کند که می تواند در پاس 1 (IPP) از طریق "$(NAME)"، در گذر 2 درون یابی شود.
(mp4h) از طریق <"get-var NAME">، در pass 3 (ePerl) از طریق "<:=$NAME:>" و در pass 4 (GNU m4)
از طریق "m4_NAME". یک نوع خاص --define=نام=UNDEF برعکس انجام می دهد، حذف می کند
تعاریف قبلی (که ممکن است با تعریف نکردن این متغیرها متفاوت باشد، به عنوان مثال
با متغیرهای تعریف شده سیستم).

-D, --define=نام~PATH
شبیه به بالا، اما متغیری را تعریف می‌کند که نام مسیر را در خود جای داده است
(پایین را ببینید). می‌توان آن را به همان روش‌هایی که نوع «NAME=STR» از آن وارد کرد
در بالا.

-n, --نوشه بانگ
این امر WML را مجبور می کند که یک خط احتمالاً حاوی shebang را نادیده بگیرد فایل ورودی. این هست
معمولاً توسط WMk استفاده می شود، زیرا WMk قبلاً این خط را تجزیه کرده و گزینه های آن را ارائه کرده است
WML.

-r, --norcfile
این امر WML را مجبور می کند که همه را نادیده بگیرد wmlrc فایل های.

-c, --nocd
هنگامی که WML یک فایل ورودی را از دایرکتوری دیگری پردازش می کند، به آن دایرکتوری می پرد
قبل از تجزیه wmlrc فایل‌ها، و بعد از آن به فهرست فعلی برگردید. اگر این گزینه
تنظیم شده است، هیچ تغییر دایرکتوری انجام نمی شود و wmlrc فایل ها مطابق با جریان خوانده می شوند
دایرکتوری کار

-O, --بهینه سازی=NUM
این گزینه بهینه سازی است که مستقیماً به 8 پاس داده می شود (html تعمیر) آی تی
میزان بهینه سازی/برداشتن اعمال شده بر روی HTML تولید شده را کنترل می کند
کد نشانه گذاری

-o, --outputfile=SLICETERM:فایل خروجی[@CHMODOPT]
این خروجی را به یک فایل هدایت می کند. معمولا کل فایل به ارسال می شود stdout
(همان "ALL:-"). می توانید از این گزینه بیش از یک بار برای خروجی به بیش از یک استفاده کنید
فایل در حین استفاده از SLICETERM به عنوان یک اصطلاح تئوری مجموعه ای از برش ها برای تعیین کدام
محتویات در هر فایل خروجی خاص گنجانده خواهد شد. اختیاری CHMODOPT is
در نظر گرفته شده برای مشخص کردن گزینه های در نهایت اعمال می شود chmod فرمان به عنوان مثال استفاده کنید
"u+x"" برای ایجاد فایلی با مجموعه بیت اجرا (ویژگی XBitHack آپاچی).
دیدن برش(1) برای جزئیات بیشتر.

-P, --prolog=PATH
یک فیلتر پرولوگ را روی فایل ورودی اجرا می کند. این برنامه داده ها را برای عمل دریافت می کند
به عنوان STDIN و باید داده های فیلتر شده را در STDOUT تولید کند.

-E, --epilog=PATH
یک برنامه اپیلوگ را روی فایل های خروجی نهایی اجرا می کند. در حال حاضر
برنامه های ویژه WML زیر شناخته شده اند: اطلاعات html, لینکلینت, مرتب و وبلینت. ولی
شما می توانید هر برنامه ای را که در "PATH" شما موجود است را مشخص کنید. این برنامه دریافت می کند
فایلی که به عنوان اولین آرگومان خط فرمان روی آن عمل می کند. توجه داشته باشید که خروجی نیست
به این فایل هدایت شد، بنابراین در صورت وجود باید از یک wrapper یا پرچم خاص برنامه استفاده کنید
می خواهید فایل های خروجی را تغییر دهید.

-t, --مدت زمان معینی
با این کار زمان اصلاح همه فایل های خروجی بر روی زمان اصلاح تنظیم می شود
فایل ورودی به اضافه 1 ثانیه این مفید است زیرا وب سرورها تولید خواهند کرد
هدرهای "آخرین اصلاح" و در آنجا زمان ویرایش مهمتر از هدر است
زمان نسل افست 1 ثانیه ای برای وابستگی های Makefiles است.

-M, -- بستگی دارد[=OPTIONS]
خروجی یک قانون مناسب برای 'make' توصیف وابستگی های هر فایل خروجی، به عنوان
"gcc" انجام می دهد. فقط زمانی حس می شود که -o گزینه استفاده می شود. هیچ پردازشی انجام نمی شود
به جز پاس اول

La D گزینه flag قانون را در یک فایل وابستگی می نویسد. نام این فایل است
با جایگزین کردن پسوند فایل خروجی با ".d" به دست می آید.

La M گزینه flag فایل های سیستم را از لیست وابستگی ها حذف می کند.

-p, --pass=STR
مشخص می کند که کدام یک از پاس های توضیح داده شده در بالا واقعاً در زمان اجرا اعمال می شوند. در
استدلال STR لیستی از اعداد پاس با کاما جدا شده با یک مورد خاص است: شما می توانید
برای همه پاس ها "X...Y" بنویسید. وقتی پاس 9 بخشی از STR نتیجه
خروجی نوشته شده است با توجه به. پیش‌فرض رشته «1-9» است.

-W, --passoption=NUM,STR
گزینه تنظیم کنید STR برای پاس NUM.

-s, --بی خطر
این امر برخی از هک های Perl را در داخل WML غیرفعال می کند که با کاهش سرعت پردازش را افزایش می دهد
انشعاب بالای سر هنگام اجرای پاس های مختلف.

بدون این گزینه WML پاس های 1,5,6,7,8،XNUMX،XNUMX،XNUMX،XNUMX را از قبل کامپایل می کند (که در Perl نوشته شده اند!)
در فضای نام دیگری از مفسر پرل در حال اجرا به جای
اجرای خارجی آنها از طریق "system()". اثر این است که این برنامه ها از اجرا می شوند
در همان مفسر پرل، بنابراین پنج "fork()" که با CPU و زمان فشرده هستند ذخیره می شود.
بهره واقعی بین 2 تا 4 ثانیه زمان پردازش است. هر چند تجربه
نشان داد که عالی کار می کند، مشکل نظری هنوز این است که این رویکرد وجود دارد
به دلیل تضادهای داخلی متغیر Perl تا حدودی خطرناک است.

از این گزینه برای غیرفعال کردن این افزایش‌ها با مجبور کردن WML به استفاده از "fork()" ایمن استفاده کنید.
رویکرد.

-v, -- پرحرف[=NUM]
این حالت پرحرف (از 1 تا 9) را تنظیم می کند که در آن برخی از اطلاعات پردازش داده می شود
روی کنسول برای رفع اشکال مفید است. این گزینه نیز به برخی از آنها منتقل می شود
برنامه های فیلتر کردن پیش‌فرض هیچ پرحرفی و عادلانه‌ای نیست -v به معنی -v1.

-q, --ساکت
این حالت بی صدا را تنظیم می کند که در آن پایه پردازش دیگر نمایش داده نمی شود. از این استفاده کن
گزینه هنگام اجرا wml به عنوان کار دسته ای این گزینه به طور خودکار در زمانی که
فایل ورودی گم شده است. سپس WML به طور خودکار از را می خواند stdin در حالت بی صدا

-V, - نسخه[=NUM]
رشته شناسایی نسخه و سلب مسئولیت (شماره NUM or NUM >= 1)، WML
اطلاعات ساخت (NUM >= 2) و اطلاعات ساخت پرل (NUM >= 3). از این استفاده کن
گزینه ای برای دریافت شرح مختصری از سیستم WML نصب شده خود، به خصوص زمانی که
گزارش اشکالات به نویسنده

-h, --کمک
صفحه خلاصه استفاده را چاپ می کند.

محیط زیست

تعریف شده است متغیرها
متغیرهای زیر همیشه با تعریف می شوند wml تحت زمان اجرا هستند و معمولا هستند
درون یابی از طریق <"get-var NAME"> در Pass 2 و از طریق $NAME در Pass 3.

WML_SRC_DIRNAME
دایرکتوری کاری فعلی از کجا wml آغاز شد. یک سیستم فایل یونیکس مطلق
مسیر.

WML_SRC_FILENAME
نام فایل ورودی از خط فرمان هنگام دویدن مفید است wml در بخش عمده ای از
فایل‌ها و includefiles باید تعیین کنند که در کدام موارد گنجانده شده‌اند.

WML_SRC_BASENAME
نام پایه فایل ورودی، یعنی "WML_SRC_FILENAME"، اما با پسوند
قبلا برهنه شده

WML_SRC_TIME
آخرین زمان اصلاح از فایل ورودی در قالب "time()". فوترهای داخلی مفید است
زمانی که قالب تاریخ سفارشی مورد نیاز است.

WML_SRC_CTIME
آخرین زمان اصلاح از فایل ورودی در قالب "ctime()". فوترهای داخلی مفید است
شامل فایل ها

WML_SRC_ISOTIME
آخرین زمان اصلاح از فایل ورودی در قالب ISO "yyyy-mm-dd hh:mm:ss". مفید
پاورقی های داخلی شامل فایل ها می شود.

WML_SRC_USERNAME
نام کاربری یونیکس کاربر مالک فایل ورودی.

WML_SRC_REALNAME
نام واقعی کاربری که مالک است فایل ورودی.

WML_GEN_TIME
زمان فعلی تولید در قالب "time()". زمانی که فوترهای داخلی مفید است
قالب تاریخ سفارشی مورد نیاز است.

WML_GEN_CTIME
زمان فعلی تولید در قالب "ctime()". فوترهای داخلی مفید عبارتند از
فایل های.

WML_GEN_ISOTIME
زمان فعلی تولید در قالب ISO "yyyy-mm-dd hh:mm:ss". در داخل مفید است
پاورقی ها شامل فایل ها می شوند.

WML_GEN_USERNAME
نام کاربری یونیکس کاربری که اجرا می کند wml روند.

WML_GEN_REALNAME
نام واقعی کاربری که اجرا می کند wml روند.

WML_GEN_HOSTNAME
نام میزبانی که روی آن wml فرمان اجرا می شود

WML_LOC_PREFIX
پیشوند مکانی که WML در زمان ساخته شده در آن نصب شده است.

WML_LOC_BINDIR
دایرکتوری که باینری های WML در زمان ساخته شده در آن نصب شده بودند.

WML_LOC_LIBDIR
دایرکتوری که فایل های کتابخانه WML در زمان ساخته شده در آن نصب شده بودند.

WML_LOC_DATADIR
دایرکتوری که فایل های داده WML در زمان ساخته شده در آن نصب شده بودند.

WML_LOC_MANDIR
دایرکتوری که صفحات دستی WML در زمان ساخته شده در آن نصب شده بودند.

WML_VERSION
رشته شناسایی نسخه WML. از این به عنوان مثال در نظرات HTML استفاده کنید
هدر داخل شامل شناسایی نسخه ابزار تولید می شود.

استفاده شده متغیرها
"WMLOPTS"
این متغیر می تواند شامل رشته ای از گزینه ها باشد. معمولاً این مورد توسط Bourne-Shell استفاده می شود
کاربران دوست دارند

$ WMLOPTS="-DNAME1=VALUE2 -DNAME2=VALUE2"
$ صادرات WMLOPTS

و توسط کاربران سی شل مانند

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

برای اطمینان از اینکه برخی از متغیرها برای همه اجراها تعریف شده اند wml.

"پیجر"
این متغیر حاوی پیجر WML است که باید استفاده شود. WML هنگامی که با آن فراخوانی می شود از یک پیجر استفاده می کند
--کلمه=NUM or -vNUM گزینه به ترتیب و NUM 3 یا بالاتر است و بنابراین
نمایش داده های پردازش شده پس از هر پاس. پیش فرض "بیشتر" است.

"TMPDIR"
این متغیر شامل دایرکتوری است که WML فایل های موقت خود را در آن ذخیره می کند. پیش فرض این است
'دایرکتوری / tmp'.

USER فایل ها

$HOME/.wmlrc و (../)*.wmlrc
این فایل ها همچنین می توانند شامل رشته های گزینه، یک گزینه در هر خط باشند. معمولا
مطالب یک یا چند است -D گزینه ها، به ویژه آنهایی که به صورت خودکار تنظیم می شوند:

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

STANDARD عبارتند از فایل ها

WML با مجموعه استانداردی از فایل های شامل ارسال می شود. می توانید مستقیماً آنها را از طریق وارد کنید

#استفاده از wml::category::name

و اسناد خود را از طریق

$ man wml::category::name

دیدن wml::تمام(3) برای شرح همه فایل های موجود شامل.

ویژه ویژگی‌ها

بخش کنترل WML به تنهایی چند ویژگی خاص را ارائه می دهد:

پشتیبانی خط شبانگ
WML الف را تشخیص می دهد شبانگ خط (``"#!wml" گزینه های'') در wml فایلها و
به طور خودکار اضافه می کند گزینه های به خط فرمان آن این خط توسط WMk نیز استفاده می شود. دو
ویژگی‌های ویژه برخلاف خطوط shebang برای لودر یونیکس در دسترس است: WML
خط shebang را می توان از طریق یک کاراکتر بک اسلش و ساخت %DIR و ادامه داد
% درون یابی می شوند (که در آن %DIR مسیر دایرکتوری منبع while است
ساکن است و %BASE نام فایل فایل منبع بدون هیچ پسوندی است).

مثال:

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

برچسب کانتینر حفاظت از داده
WML یک تگ کانتینر داخلی خود را با نام " ارائه می کند.
[pass=SPEC]>"... " که می تواند برای محافظت از هر نوع داده ای در برابر وجود استفاده شود
توسط هر پاس WML پردازش می شود. هنگامی که هیچ ویژگی "pass" داده نمی شود SPEC پیش‌فرض "1-9" است.
وقتی از "pass" استفاده می کنید، سپس SPEC می تواند "#-"، "-#"، "#-#" یا با کاما از هم جدا شود
لیست پاس ها، در حالی که "#" می تواند بین 1 و 9 باشد.

مثال:



...
خروجی = " " + help_string + " "
...



هشدار:

از WML 2.0.3، پاس 1 شامل موارد اضافی برای کمک به حفظ اطلاعات در مورد خط است
اعداد مرتبط (a la cpp). بنابراین هنگام نوشتن


#شامل "فو"


این دستورات اضافی در طول پاس 2 تفسیر نمی شوند و در خروجی باقی می مانند.
برای سرکوب آنها، یا با پرچم "-W1،-N" کامپایل کنید یا بنویسید


#include 'foo' IPP_NOSYNCLINES

AUTHORS

رالف اس. انگلسال
[ایمیل محافظت شده]
www.engelschall.com

دنیس باربیر
[ایمیل محافظت شده]

با استفاده از خدمات onworks.net از wml آنلاین استفاده کنید