WML - عبر الإنترنت في السحابة

برنامج:

اسم

WML - لغة META لموقع الويب

VERSION

2.0.12 (16 أبريل 2008)

موجز

WML [-I PATH] [-i PATH] [-D اسم=STR] [-D اسم~PATH] [-n] [-r] [-O مستوى] [-o
[شريحة":"]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 يقرأ ملف الإدخال (او من ستدين if ملف الإدخال هو اندفاعة أو
مفقود تمامًا) ، يطبق التمريرات من 1 إلى 9 (أو فقط الممرات المحددة بواسطة -p) وأخيرًا
تنتج واحدة أو أكثر ملف إلاخراجs.

لمزيد من التفاصيل حول مخطط المعالجة هذا ، اقرأ WML المُقدّمة مع wml_intro(7)
و WML البرنامج التعليمي مع wml_tutorial(7).

OPTIONS

-I, - تشمل =PATH
يضيف دليل إلى قائمة المستخدمين تشمل المسارات. استخدم هذا الخيار لضبط وقت التشغيل
بيئة لتمرير 1. انظر wml_p1_ipp(3) لمزيد من التفاصيل.

-i, - تضمين ملف =PATH
ما قبل التحميل تشمل معينة ملف، أي يضيف عمليا أ

# تضمين "PATH"

على قمة ملف الإدخال. استخدم هذا لتضمين ملفات المستخدم الافتراضية تلقائيًا.
إذا كنت تريد تضمين أنظمة تتضمن ملفًا ، فيجب عليك إحاطة ملف PATH بزاوية
الأقواس ، على سبيل المثال استخدم "" -i "" "" "لتضمين الملف foo / bar.wml
من النظام تشمل المنطقة. بدلا من ذلك يمكنك استخدام بناء الجملة الخاص
"" wml :: foo :: bar "" كما في الأمر "#use".

-D, - تعريف =اسم=STR
يحدد متغيرًا يمكن إقحامه في التمرير 1 (IPP) عبر "$ (NAME)" ، في التمرير 2
(mp4h) عبر <"get-var NAME"> ، في الممر 3 (ePerl) عبر "<: = $ NAME:>" وفي الممر 4 (GNU m4)
عبر "m4_NAME". نوع خاص - تعريف =اسم= UNDEF يفعل العكس ، فإنه يحذف
التعاريف السابقة (التي قد تكون مختلفة عن عدم تحديد هذه المتغيرات ، على سبيل المثال
مع المتغيرات المحددة من قبل النظام).

-D, - تعريف =اسم~PATH
مشابه لما سبق ولكنه يحدد متغيرًا يحمل اسم مسار يتم ضبطه تلقائيًا
(انظر أدناه). يمكن استيفاءها بنفس الطرق مثل المتغير "NAME = STR" من
في الاعلى.

-n, --نوشيبانج
هذا يجبر WML على تجاهل احتمال احتواء خط shebang في ملف الإدخال. وهذا هو
عادةً ما تستخدمه WMk ، لأن WMk قامت بالفعل بتحليل هذا السطر ووفرت الخيارات لـ
WML.

-r, --norcfile
هذا يجبر WML على تجاهل كل شيء .wmlrc الملفات.

-c, --nocd
عندما يعالج WML ملف إدخال من دليل آخر ، فإنه ينتقل إلى هذا الدليل
قبل الاعراب .wmlrc الملفات ، والعودة إلى الدليل الحالي بعد. إذا كان هذا الخيار
تم تعيينه ، ولم يتم إجراء أي تغيير في الدليل و .wmlrc تتم قراءة الملفات reative to current
عمل اخراجي.

-O, - تحسين =NUM
هذا هو خيار التحسين الذي يتم تمريره مباشرة لتمرير 8 (htmlfix). هو - هي
يتحكم في مقدار التحسين / التجريد الذي يتم تطبيقه على HTML الذي تم إنشاؤه
كود الترميز.

-o, - Outputfile =شريحة:ملف إلاخراج[@CHMODOPT]
هذا يعيد توجيه الإخراج إلى ملف. عادةً ما يتم إرسال الملف بالكامل إلى المعياري
(مثل "الكل: -"). يمكنك استخدام هذا الخيار أكثر من مرة للإخراج لأكثر من خيار
أثناء استخدام ملف شريحة كمصطلح نظرية مجموعة الشرائح لتحديد أي منها
سيتم تضمين المحتويات في كل ملف إخراج معين. اختياري CHMODOPT is
الغرض منه تحديد خيارات لتطبيق نهائي شمود يأمر. على سبيل المثال استخدام
"" u + x "" لإنشاء ملف مع مجموعة بت التنفيذ (ميزة XBitHack في Apache).
يرى شريحة(1) لمزيد من التفاصيل.

-P, - برولوج =PATH
يقوم بتشغيل مرشح برولوج فوق ملف الإدخال. يتلقى هذا البرنامج البيانات للعمل عليها
مثل STDIN ويجب أن تنتج البيانات التي تمت تصفيتها على STDOUT.

-E, - خصر =PATH
يقوم بتشغيل برنامج خاتمة فوق ملفات الإخراج الناتجة أخيرًا. حاليا
البرامج التالية الخاصة بـ WML معروفة: htmlinfo, linklint, أنيق و weblint. لكن
يمكنك تحديد أي برنامج متاح في "PATH" الخاص بك. يتلقى هذا البرنامج
الملف المراد العمل عليه كأول وسيطة لسطر الأوامر. لاحظ أن الإخراج ليس كذلك
تمت إعادة توجيهك إلى هذا الملف ، لذلك يجب عليك استخدام علامات مجمعة أو برنامج محدد إذا كنت تريد
تريد تعديل ملفات الإخراج.

-t, --ضبط الوقت
هذا يضبط وقت التعديل لجميع ملفات الإخراج على وقت التعديل
intputfile زائد 1 ثانية. هذا مفيد لأن خوادم الويب سوف تولد ملفات
رؤوس "Last-Modified" وهناك وقت التحرير أكثر أهمية من
وقت الجيل. الإزاحة الثانية هي لتتبعيات Makefiles.

-M, - تعتمد[=OPTIONS]
أخرج قاعدة مناسبة لـ "make" تصف تبعيات كل ملف ناتج ، مثل
"دول مجلس التعاون الخليجي". يكون له معنى فقط عندما يكون ملف -o يستخدم الخيار. لم تتم أي معالجة
باستثناء المرور الأول.

• D خيار العلم يكتب القاعدة إلى ملف تبعية. اسم هذا الملف هو
تم الحصول عليها عن طريق استبدال لاحقة ملف الإخراج بـ ".d".

• M يحذف خيار العلم ملفات النظام من قائمة التبعيات.

-p, - ممر =STR
يحدد أي من الممرات الموضحة أعلاه يتم تطبيقها فعليًا ضمن وقت التشغيل. ال
حجة STR عبارة عن قائمة بأرقام المرور مفصولة بفواصل مع حالة خاصة واحدة: يمكنك ذلك
اكتب "XY" لجميع التمريرات "X ... Y". عندما تمريرة 9 ليست جزءًا من STR النتيجة
الإخراج مكتوب إلى STDOUT. الافتراضي هو السلسلة "" 1-9 "".

-W, - Passoption =NUM,STR
ضبط الخيار STR لتمرير NUM.

-s, --آمنة
يؤدي هذا إلى تعطيل بعض اختراق Perl داخل WML مما يؤدي إلى تسريع المعالجة عن طريق تقليل امتداد
تفرغ فوق عند تشغيل مختلف التمريرات.

بدون هذا الخيار ، يقوم WML بتجميع التصاريح مسبقًا 1,5,6,7,8،XNUMX،XNUMX،XNUMX،XNUMX (والتي تتم كتابتها بلغة Perl!)
إلى مساحة اسم مختلفة لمترجم Perl قيد التشغيل حاليًا بدلاً من
تشغيلها خارجيًا عبر "system ()". التأثير هو أن هذه البرامج يتم تشغيلها من
ضمن نفس مترجم Perl مما يوفر خمس وحدات معالجة مركزية (CPU) و "fork ()" تستغرق وقتًا طويلاً.
الكسب الفعلي ما بين 2 و 4 ثوان من وقت المعالجة. على الرغم من الخبرة
أظهر أنه يعمل بشكل جيد ، والمشكلة النظرية لا تزال ، أن هذا النهج هو
محفوفة بالمخاطر إلى حد ما بسبب تعارضات متغيرات Perl الداخلية.

استخدم هذا الخيار لتعطيل عمليات التسريع هذه عن طريق إجبار WML على استخدام "fork ()" الآمن
النهج.

-v, - الإسراف[=NUM]
هذا يضبط الوضع المطول (من 1 إلى 9) حيث سيتم إعطاء بعض معلومات المعالجة
على وحدة التحكم. مفيد في التصحيح. يتم تمرير هذا الخيار أيضًا إلى بعض من
برامج التصفية. الافتراضي ليس الإسهاب وعادل -v يعني -v1.

-q, --هادئ
هذا يضبط الوضع الصامت حيث لا يتم عرض خاصية المعالجة. استخدم هذا
الخيار عند الجري WML كوظيفة دفعية. يتم فرض هذا الخيار تلقائيًا عندما
ملف الإدخال مفقود. ثم يقرأ WML تلقائيًا من ستدين في الوضع الصامت.

-V, --الإصدار[=NUM]
يعطي سلسلة تعريف الإصدار وإخلاء المسؤولية (لا NUM or NUM > = 1) ، WML
بناء المعلومات (NUM > = 2) ومعلومات بناء Perl (NUM > = 3). استخدم هذا
للحصول على وصف موجز لنظام WML المثبت لديك ، خاصةً عندما
إبلاغ المؤلف بالأخطاء.

-h, --مساعدة
يطبع صفحة ملخص الاستخدام.

البيئة

مُعرف المتغيرات
يتم تعريف المتغيرات التالية دائمًا بواسطة WML تحت وقت التشغيل وعادة ما تكون
محرف عبر <"get-var NAME"> داخل Pass 2 وعبر $ NAME في Pass 3.

WML_SRC_DIRNAME
دليل العمل الحالي من حيث WML بدأ. نظام ملفات يونكس مطلق
مسار.

WML_SRC_FILENAME
اسم ال ملف الإدخال من سطر الأوامر. مفيد عند الجري WML على جزء كبير من
يجب أن تحدد الملفات والملفات التي يتم تضمينها فيها.

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
اسم مستخدم Unix للمستخدم الذي يملك ملف الإدخال.

WML_SRC_REALNAME
الاسم الحقيقي للمستخدم الذي يملك ملف الإدخال.

WML_GEN_TIME
الوقت الحالي للإنشاء بتنسيق "time ()". مفيد داخل التذييلات عندما
مطلوب تنسيق التاريخ المخصص.

WML_GEN_CTIME
الوقت الحالي للإنشاء بتنسيق "ctime ()". مفيدة داخل تذييلات تشمل
الملفات.

WML_GEN_ISOTIME
الوقت الحالي للإنشاء بتنسيق ISO "yyyy-mm-dd hh: mm: ss". مفيد من الداخل
التذييلات تتضمن الملفات.

WML_GEN_USERNAME
اسم مستخدم Unix للمستخدم الذي يقوم بتشغيل ملف 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
يتضمن رأس الصفحة تحديد إصدار أدوات التوليد.

USED المتغيرات
"WMLOPTS"
يمكن أن يحتوي هذا المتغير على سلسلة من الخيارات. عادة ما يتم استخدام هذا بواسطة Bourne-Shell
يحب المستخدمون

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

ومن قبل مستخدمي C-Shell مثل

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

للتأكد من تحديد بعض المتغيرات لجميع عمليات التشغيل WML.

"بيجر"
يحتوي هذا المتغير على بيجر WML الذي سيتم استخدامه. يستخدم WML بيجر عند استدعائه بامتداد
- الإسراف =NUM or -vNUM الخيار على التوالي و NUM هي 3 أو أعلى وبالتالي
إظهار البيانات المعالجة بعد كل تمريرة. الافتراضي هو "المزيد".

"تمبدير"
يحتوي هذا المتغير على الدليل الذي يقوم WML بتخزين ملفاته المؤقتة فيه. الافتراضي هو
'/ تمة'.

USER FILES

$ الصفحة الرئيسية / wmlrc و (../)*.wmlrc
يمكن أن تحتوي هذه الملفات أيضًا على سلاسل خيارات ، خيار واحد لكل سطر. عادة
محتويات واحد أو أكثر -D الخيارات ، خاصة تلك المعدلة تلقائيًا:

-دروتريل ~.
-دروتابس =http://thishost/thisarea/
:
-DNAME1 = VALUE1
-DNAME2 = VALUE2
:

معياري تتضمن FILES

يتم شحن WML مع مجموعة قياسية من ملفات التضمين. يمكنك تضمينهم مباشرة عبر

#use wml :: category :: name

وقراءة الوثائق الخاصة بهم عبر

$ man wml :: category :: name

يرى wml ::من جميع(3) للحصول على وصف لجميع الملفات المتاحة.

خاص المزايا

توفر الواجهة الأمامية للتحكم في WML بعض الميزات الخاصة من تلقاء نفسها:

دعم خط Shebang
يتعرف WML على ملف كوخ سطر ("" #! wml " الخيارات'') في ال .wml الملفات و
يضيف تلقائيا الخيارات إلى سطر الأوامر الخاص به. يستخدم هذا الخط أيضًا بواسطة WMk. اثنين
تتوفر ميزات خاصة على عكس خطوط shebang لمحمل Unix: WML
يمكن متابعة خط shebang عبر حرف الخط المائل العكسي والتركيبات٪ DIR و
٪ يتم إقحامها (حيث يكون٪ DIR هو المسار إلى الدليل المصدر أثناء
موجود و٪ BASE هو اسم الملف المصدر بدون أي امتداد).

على سبيل المثال:

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

بطاقة حاوية حماية البيانات
يوفر WML علامة حاوية داخلية خاصة تسمى "
[تمرير = المواصفات]> "..." "والتي يمكن استخدامها لحماية أي نوع من البيانات من الوجود
معالجتها بأي تمرير WML. عندما لا يتم إعطاء سمة "تمرير" SPEC افتراضات إلى "1-9".
عند استخدام "تمرير" ثم SPEC يمكن أن تكون إما "# -" أو "- #" أو "# - #" أو مفصولة بفاصلة
قائمة التمريرات ، بينما يمكن أن تتراوح "#" بين 1 و 9.

على سبيل المثال:




الإخراج = " "+ help_string +" "


</script>

: تحذير

منذ WML 2.0.3 ، يتضمن التمرير 1 أشياء إضافية للمساعدة في حفظ المعلومات حول الخط
الأرقام ذات الصلة (a la cpp). لذلك عند الكتابة


# تضمين "فو"


لن يتم تفسير هذه الأوامر الإضافية أثناء التمرير 2 وستظل في الإخراج.
لمنعها ، قم بالتجميع باستخدام علامة "-W1 ، -N" ، أو الكتابة


# تضمين "foo" IPP_NOSYNCLINES

مؤلفون

رالف س
rse@engelschall.com
www.engelschall.com

دينيس باربييه
barbier@engelschall.com

استخدم wml عبر الإنترنت باستخدام خدمات onworks.net