wml - מקוון בענן

תָכְנִית:

שֵׁם

WML - שפת אתר META

גִרְסָה

2.0.12 (16 באפריל 2008)

תַקצִיר

wml [-I נתיב] [-i נתיב] [-D שֵׁם=STR] [-D שֵׁם~נתיב] [-n] [-r] [-O רָמָה] [-o
[SLICETERM":"]נתיב[@CHMODOPT]] [-P נתיב] [-E נתיב] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [קובץ קלט]

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

תיאור

זוהי תוכנית הבקרה של אתר META שפה (WML), דור HTML בחינם
ערכת כלים עבור יוניקס, המורכבת באופן פנימי מ-9 שפות עצמאיות.

הרעיון המרכזי של WML הוא ערכת סינון רציפה שבה כל שפה מספקת אחת מהן
9 מעברי עיבוד. לכן wml קורא קובץ קלט (או מ סטדין if קובץ קלט הוא מקף או
חסר לחלוטין), מחיל מעברים 1-9 (או רק מעברים שצוינו על ידי -p) ולבסוף
מייצר אחד או יותר קובץ פלטs.

לפרטים נוספים על ערכת עיבוד זו קרא את WML מבוא תחת wml_intro(7)
ו WML הדרכה תחת wml_tutorial(7).

אפשרויות

-I, --include=נתיב
מוסיף א בספרייה לרשימת הנתיבים לכלול משתמש. השתמש באפשרות זו כדי להגדיר את זמן הריצה
סביבה עבור לעבור 1. ראה wml_p1_ipp(3) לפרטים נוספים.

-i, --includefile=נתיב
טעינה מראש של מסויים כוללים פילה, כלומר למעשה מוסיף א

#include "PATH"

בקצה ה קובץ קלט. השתמש בזה כדי לכלול אוטומטית קבצי כלול משתמש כברירת מחדל.
אם אתה רוצה לכלול קובץ systems include, אתה צריך להקיף את נתיב עם זווית
בסוגריים, למשל השתמש ב-``"-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, --הגדיר=שֵׁם~נתיב
דומה לאמור לעיל אך מגדיר משתנה המחזיק שם נתיב אשר מותאם אוטומטית
(ראה למטה). ניתן לבצע אינטרפולציה באותן דרכים כמו הגרסה "NAME=STR" מ
מֵעַל.

-n, --נושבנג
זה מאלץ את WML להתעלם מקו shebang שאולי מכיל קובץ קלט. זה
בשימוש בדרך כלל על ידי WMk, מכיוון ש-WMk כבר ניתוח את השורה הזו וסיפק את האפשרויות ל
WML.

-r, --norcfile
זה מאלץ את WML להתעלם מהכל .wmlrc קבצים.

-c, --נוקד
כאשר WML מעבד קובץ קלט מספרייה אחרת, הוא קופץ לתוך הספרייה הזו
לפני הניתוח .wmlrc קבצים, וקפוץ חזרה לספרייה הנוכחית לאחר מכן. אם אפשרות זו
מוגדר, לא נעשה שינוי ספרייה ו .wmlrc קבצים נקראים באופן יחסי לזרם
ספריית עבודה.

-O, --אופטימיזציה=NUM
זוהי אפשרות האופטימיזציה שמועברת ישירות למעבר 8 (htmlfix). זה
שולט בכמות האופטימיזציה/הפשטה המוחלת על ה-HTML שנוצר
קוד סימון.

-o, --outputfile=SLICETERM:קובץ פלט[@CHMODOPT]
זה מפנה את הפלט לקובץ. בדרך כלל כל הקובץ יישלח אל stdout
(זהה כמו "ALL:-"). אתה יכול להשתמש באפשרות זו יותר מפעם אחת כדי להוציא ליותר מאחד
קובץ תוך כדי שימוש ב- SLICETERM כמונח תורת קבוצה של פרוסות כדי לקבוע אילו
התוכן ייכלל בכל קובץ פלט מסוים. האופציונלי CHMODOPT is
מיועד לציון אפשרויות ליישום לבסוף chmod פקודה. למשל שימוש
``"u+x"'' כדי ליצור קובץ עם ערכת סיביות הביצוע (תכונת XBitHack של Apache).
לִרְאוֹת פרוסה(1) לפרטים נוספים.

-P, --prolog=נתיב
מפעיל מסנן פרולוג על קובץ הקלט. תוכנית זו מקבלת את הנתונים לפעול לפיהם
כ-STDIN וצריך לייצר את הנתונים המסוננים על STDOUT.

-E, --epilog=נתיב
מפעיל תוכנית אפילוג על קבצי הפלט שהתקבלו לבסוף. נכון לעכשיו ה
התוכניות הספציפיות הבאות ל-WML ידועות: htmlinfo, linklint, מסודר ו weblint. אבל
אתה יכול לציין כל תוכנית שזמינה ב-"PATH" שלך. תוכנית זו מקבלת
הקובץ לפעול כארגומנט שורת הפקודה הראשון שלו. שימו לב שהפלט לא
מנותב מחדש לקובץ זה, אז אתה צריך להשתמש במעטפת או לתכנת דגלים ספציפיים אם אתה
רוצה לשנות קבצי פלט.

-t, --זמן מוגדר
זה מגדיר את זמן השינוי של כל קבצי הפלט לזמן השינוי של
קובץ קלט בתוספת שנייה אחת. זה שימושי מכיוון ששרתי אינטרנט יפיקו
כותרות "השינוי האחרון" ושם זמן העריכה חשוב יותר מה
זמן דור. ההיסט של שנייה אחת נועד לתלות של Makefiles.

-M, --לִסְמוֹך[=אפשרויות]
פלט כלל מתאים ל'make' המתאר את התלות של כל קובץ פלט, כמו
'gcc' עושה זאת. יש לזה הגיון רק כאשר -o נעשה שימוש באופציה. לא נעשה עיבוד
חוץ מהמעבר הראשון.

אל האני D flag option כותבת את הכלל לקובץ תלות. השם של הקובץ הזה הוא
מתקבל על ידי החלפת הסיומת של קובץ הפלט ב-".d".

אל האני M אפשרות הדגל מוחקת את קבצי המערכת מרשימת התלות.

-p, --pass=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 (שכתובים בפרל!)
למרחב שמות אחר של מתורגמן Perl הפועל כעת במקום
הפעלתם חיצונית באמצעות "system()". ההשפעה היא שתוכניות אלה מופעלות מ
בתוך אותו מתורגמן Perl ובכך חוסכים חמישה "fork()" עתירי CPU וזמן.
הרווח בפועל הוא בין 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"> בתוך מעבר 2 ודרך $NAME במעבר 3.

WML_SRC_DIRNAME
ספריית העבודה הנוכחית מאיפה wml התחיל. מערכת קבצים יוניקס מוחלטת
נתיב.

WML_SRC_FILENAME
השם של קובץ קלט משורת הפקודה. שימושי בריצה wml על חלק הארי של
קבצים ו-inklusivefiles צריכים לקבוע באילו הם כלולים.

WML_SRC_BASENAME
שם הבסיס של ה קובץ קלט, כלומר ה-"WML_SRC_FILENAME", אבל עם הסיומת
כבר פשט.

WML_SRC_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
הכותרת הפנימית כוללת לזיהוי גרסת כלי הדור.

מְשׁוּמָשׁ וריאציות
"WMLOPTS"
משתנה זה יכול להכיל שורה של אפשרויות. בדרך כלל זה משמש את Bourne-Shell
משתמשים אוהבים

$ WMLOPTS="-DNAME1=VALUE2 -DNAME2=VALUE2"
$ ייצוא WMLOPTS

ועל ידי משתמשי C-Shell אוהבים

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

כדי לוודא שכמה משתנים מוגדרים עבור כל הריצות של wml.

"PAGER"
משתנה זה מכיל את הביפר שבו יש להשתמש ב-WML. WML משתמש בביפר כאשר נקרא עם ה-
--מלל=NUM or -vNUM אפשרות בהתאמה ו NUM הוא 3 ומעלה ולכן
הצגת הנתונים המעובדים לאחר כל מעבר. ברירת המחדל היא 'יותר'.

"TMPDIR"
משתנה זה מכיל את הספרייה שבה WML מאחסן את הקבצים הזמניים שלו. ברירת המחדל היא
'/ Tmp'.

משתמש קבצים

$HOME/.wmlrc ו (../)*.wmlrc
קבצים אלו יכולים להכיל גם מחרוזות אפשרויות, אפשרות אחת בכל שורה. בדרך כלל ה
התוכן הוא אחד או יותר -D אפשרויות, במיוחד אלה המותאמות אוטומטית:

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

תקן לִכלוֹל קבצים

WML נשלח עם סט סטנדרטי של קבצי כלול. אתה יכול לכלול אותם ישירות דרך

#use wml::category::name

ולקרוא את התיעוד שלהם באמצעות

$ man wml::category::name

לִרְאוֹת wml::את כל(3) לתיאור של כל קבצי הכלול הזמינים.

מיוחד מאפיינים

חזית בקרת WML מספקת כמה תכונות מיוחדות בפני עצמו:

תמיכה בקו שבנג
WML מזהה א שבנג שורה (``"#!wml" אפשרויות'') בתוך ה .wml קבצים ו
מוסיף אוטומטית אפשרויות לשורת הפקודה שלו. קו זה משמש גם את WMk. שתיים
תכונות מיוחדות בניגוד לקווי shebang עבור מטעין יוניקס זמינות: WML's
ניתן להמשיך את קו shebang באמצעות תו נטוי אחורי והקונסטרוקציות %DIR ו
% אינטרפולציה (כאשר %DIR הוא הנתיב לספרייה שהמקור תוך כדי
resides ו-%BASE הוא שם הקובץ של קובץ המקור ללא כל סיומת).

דוגמא:

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

תג מיכל להגנה על נתונים
WML מספק תג מיכל פנימי משלו בשם "
[pass=SPEC]>"..." " אשר ניתן להשתמש בו כדי להגן על כל סוג של נתונים מפני היות
מעובד על ידי כל כרטיס WML. כאשר לא ניתנת תכונה "מעבר". SPEC ברירת המחדל היא "1-9".
כשאתה משתמש ב"מעבר" אז SPEC יכול להיות "#-", "-#", "#-#" או מופרד בפסיק
רשימה של מעברים, בעוד ש-"#" יכול להיות בין 1 ל-9.

דוגמא:



...
פלט = " " + help_string + " "
...



אַזהָרָה:

מאז WML 2.0.3, מעבר 1 כולל דברים נוספים שיעזרו לשמור מידע על הקו
מספרים רלוונטיים (a la cpp). אז כשכותבים


#include 'foo'


הפקודות הנוספות הללו לא יתפרשו במהלך מעבר 2 ויישארו בפלט.
כדי לדכא אותם, או הידור עם דגל "-W1,-N", או כתוב


#include 'foo' IPP_NOSYNCLINES

מחברים

Ralf S. Angelschall
[מוגן בדוא"ל]
www.engelschall.com

דניס ברביר
[מוגן בדוא"ל]

השתמש ב-wml באינטרנט באמצעות שירותי onworks.net