זוהי הפקודה xnav שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
xnav - בניית סרגלי ניווט עליונים וצדדיים עבור אוסף של דפי אינטרנט
תַקצִיר
xnav [ -V ] [ -h ] [ -v ] [ -c (הכל | (כותרת | בסיס | סקריפט | סגנון | מטא | קישור |
אובייקט)[,(כותרת | בסיס | סקריפט | סגנון | מטא | קישור | אובייקט)][,...])] [ -b (rmv | div)
] [ -i ] [ init | לעשות | תקף | לְנַקוֹת ] נתיב
תיאור
XNav מוסיף עטיפה עם סגנון CSS וסרגלי ניווט עליונים וצדיים לעץ ספריות של
מסמכי XHTML. זה גם מספק מנגנון לבנייה אוטומטית של XHTML
מסמכים מסוגי מסמכי XML המוגדרים על ידי המשתמש, תוך שימוש ב-XSL שסופק על ידי המשתמש.
אפשרויות
init נתיב
אתחול הספרייה נתיב כאתר XNav.
לעשות נתיב
בנה את אתר XNav בספרייה נתיב.
תקף נתיב
אימות XML ו-XHTML בספרייה נתיב.
לְנַקוֹת נתיב
נקה קבצים שנוצרו אוטומטית בספרייה נתיב.
-V גרסת תצוגה.
-h הצגת מידע שימוש.
-v פעולה מפורטת.
-c ציין את ילדי ה-html/head לכלול במסמכי הפלט. הערכים המותרים הם
'הכל' (ברירת המחדל), 'ללא', או רשימה מופרדת בפסיק של שמות רכיבים 'כותרת',
'base', 'script', 'style', 'meta', 'link' ו-'object'.
-b בחר טיפול במפרט הגוף ב-CSS בתוך רכיב html/head/style.
ערכים חוקיים הם 'rmv', המבקש הסרה של הגדרות גוף כלשהן, ו-'div',
מבקש החלפה באלמנט div ברמה העליונה עם אותו סגנון.
-i הוסף את 'index.html' לנתיבי ספריית הניווט העליונה והצדדית. שימושי בעיקר עבור
בניית קבוצה של דפים שניתן לנווט בהם כקבצים אליהם גישה ישירה דרך האינטרנט
דפדפן, ולא דרך שרת אינטרנט.
נוהג
התחל בהגדרת מבנה הספריות הרצוי של אוסף דפי האינטרנט. את כל
מסמכי HTML צריכים להיות חוקיים XHTML 1.0 Strict, וצריכים להיות להם סיומת .xml
מאשר ה-.html הרגיל. לכל ספרייה צריך להיות, לפחות, מסמך אינדקס בשם
index.xml, וקובץ תצורה שנקרא xnav.xml.
פורמט קובץ התצורה מוגדר בקובץ xnav.dtd. האלמנט ברמה העליונה הוא
xnav, עם רכיבי צאצא אופציונליים בספרייה ו פילה. התווית עבור ספרייה ספציפית
מסופק בדרך כלל על ידי התווית ברכיב הספרייה המפנה באב
ספרייה, אך ניתן לציין באמצעות ה- תווית תכונה בספרייה ברמה העליונה.
אם index.xml הקובץ אינו HTML, ה סוג יש להגדיר את התכונה לשם של
פורמט מסמך, ויש לספק תבנית XSL לטיפול בסוג זה.
A בספרייה אלמנט מייצג קישור ניווט לספריית משנה, הספרייה בפועל
השם שצוין על ידי href תכונה, ותווית הספרייה המשמשת בניווט
פסים שצוינו כתוכן האלמנט. אם רכיב ספרייה מצביע על ספרייה
לא מנוהל על ידי XNav (כלומר שבו סקריפט ה-build לא אמור לחזור על עצמו), ה להיכנס
ערך התכונה צריך להיות 'לא'. אם הספרייה מנוהלת על ידי XNav, אבל היא עבור חלק
סיבה הרצויה להחריג מסרגל הניווט הצדדי, ה sidenav ערך התכונה
צריך להיות 'לא'.
A פילה אלמנט מייצג קישור לקובץ בתוך אותה ספרייה כמו הקובץ xnav.xml,
ויש לו שימוש דומה לרכיב directory. אם הקובץ אינו HTML, ה- סוג
יש להגדיר את התכונה לשם של פורמט המסמך, ותבנית XSL צריכה להיות מוגדרת
מסופק לטיפול בסוג זה. אם הקובץ מעוניין להחריג מהצד
סרגל הניווט, ה sidenav ערך התכונה צריך להיות 'לא'.
אתחל את מבנה הספריות ב- נתיב באמצעות הפקודה
xnav init נתיב
יצירת ספרייה XNAV in נתיב, המכילים קובצי תצורה שניתן לערוך על ידי
המשתמש. הקבצים head.xml ו foot.xml להגדיר כותרת עליונה וכותרת תחתונה HTML נוסף לכל
דף שנוצר על ידי XNav. ה catalog.xml הקובץ מאפשר את כלי העזר לעיבוד XML המשמשים את
XNav כדי לאתר את ה-DTD עבור xnav.xml קבצי תצורה. אם המשתמש מוסיף עוד
סוגי מסמכים לעיבוד על ידי XNav, יש להוסיף הפניות ל-DTDs הרלוונטיים
קובץ הקטלוג. סוף - סוף, ה xnavinc.xsl הקובץ כולל את גיליון הסגנונות הראשי של XSL xnav.xsl
אחראי על רוב עיבוד XNav.
ניתן להרחיב את XNav לעיבוד סוגי מסמכי XML שרירותיים על ידי הכללת XSL נוסף
גיליונות סגנונות בתוך xnavinc.xsl קוֹבֶץ. אם סוג מסמך שאינו HTML נקרא
סוג חדש ב סוג תכונה, המשתמש צריך להגדיר תבנית XSL עם שם סוג חדש
ומצב דינמי-תבנית-בחירה. בתוך תבנית זו, התוכן של המסמך להיות
processed זמין ב-XPath src /סוג חדש.
לאחר השלמת האתחול, ובכל פעם שמסמכי XML מקור נערכים, הפלט
ניתן ליצור קובצי HTML באמצעות הפקודה
xnav לעשות נתיב
הפקודה
xnav תקף נתיב
מאמת קובצי XML מקור המכילים א דוקטיפה מִפרָט. קבצים שלא
מכילים מפרט כזה נבדקים כדי לקבוע אם הם נוצרים היטב.
השתמש ב-xnav באינטרנט באמצעות שירותי onworks.net