jw - מקוון בענן

תָכְנִית:

שֵׁם

jw, docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf,
docbook2tex, docbook2texi, docbook2txt - (ג'ייד Wrapper) ממיר קבצי SGML לקבצי SGML אחרים
פורמטים

תַקצִיר

jw [ -f ממשק | --חזיתי ממשק ]
[ -b Backend | - גב Backend ]
[ -c פילה | --חתול פילה ]
[ -n | --נוסטד ]
[ -d פילה|ברירת מחדל|ללא | --dsl פילה|ברירת מחדל|ללא ]
[ -l פילה | --dcl פילה ]
[ -s נתיב | --sgmlbase נתיב ]
[ -p התוכנית | -- מנתח התוכנית ]
[ -o בספרייה | --תְפוּקָה בספרייה ]
[ -V משתנה[=ערך] ]
[ -u | --נוצ'אנקס ] [ -i סעיף | --לִכלוֹל סעיף ]
[ -w סוג|רשימה | --אַזהָרָה סוג|רשימה ]
[ -e סוג|רשימה | --שְׁגִיאָה סוג|רשימה ]
[ -h | - עזרה ] [ -v | --גִרְסָה ]
קובץ SGML

docbook2dvi קובץ SGML

docbook2html קובץ SGML

docbook2man קובץ SGML

docbook2pdf קובץ SGML

docbook2ps קובץ SGML

docbook2rtf קובץ SGML

docbook2tex קובץ SGML

docbook2texi קובץ SGML

docbook2txt קובץ SGML

תיאור

אל האני jw סקריפט shell מאפשר להמיר קובץ DocBook (או פורמט אחר מבוסס SGML) ל
פורמטים אחרים (כולל HTML, RTF, PS ו-PDF) עם תחביר קל להבנה. זה
מסתיר את רוב המורכבות של Jade או OpenJade ומוסיף תכונות נוחות.

תסריטים אחרים כמו docbook2html, docbook2rtf or docbook2ps לספק דרכים שונות של
קוראים jw שאולי קל יותר לזכור.

נכון לעכשיו, jw לא מטפל ב-XML, אלא רק ב-SGML.

כלי שירות זה מניח שכמה רכיבים אחרים מותקנים. הרשימה כוללת:

· ישויות תו ה-ISO עבור SGML

· מנוע DSSSL של ג'יימס קלארק, ירקן, או מנתח שווה ערך כמו OpenJade

· DocBook DTD מקונסורציום OASIS

· גיליונות סגנונות מודולריים של DocBook של נורמן וולש (או סט אחר של גיליונות סגנונות DSSSL)

· ערכת ה-jadetex של סבסטיאן רהץ של פקודות מאקרו TeX עבור ירקן (עבור חלקים אחוריים שנועדו
"הדפסה" בפורמטים כמו PDF, RTF או PostScript)

· מתורגמן perl (עבור חלקים עורפיים המשתמשים ב-perl)

· SGMLSpm מ-CPAN (עבור קצה אחורי המשתמשים ב-sgmls)

· דפדפן HTML של Lynx (עבור ה txt אחורי)

סקריפט jw נקרא בעצם כך:

jw mydoc.sgml

איפה mydoc.sgml הוא קובץ SGML.

שורת הפקודה למעלה משתמשת באפשרויות ברירת המחדל: היא ממירה מ-DocBook (ברירת המחדל
frontend) ל-HTML (ברירת המחדל האחורי), אינו מכניס את התוצאה בספריית משנה (אלא אם כן
צוין אחרת בגיליונות הסגנונות) וכו'.

בדוגמה זו, ניתן להחליף את שם הקובץ "mydoc" כמו גם את סיומת ".sgml".
עוד משהו. הרחבות נוכחיות עבור קבצי SGML DocBook כוללות ".sgml", ".sgm",
".docbook", ו-".db". הקובץ המעובד mydoc.sgml יכול להיות בכל ספרייה אחרת מאשר
הנוכחי.

כאן בחרנו ליצור פלט HTML. למעשה אנו יכולים להשתמש בכל אחד מהקצה האחורי המאוחסן
ב קצה אחורי/ ספריית משנה של ספריית ההפצה DocBook-utils (בדרך כלל
/usr/share/docbook-utils). באופן דומה, אתה יכול להשתמש בכל חזית המוגדרת ב- חזיתות/
ספריית משנה להמרה מפורמט קלט אחר.

פקודה זו לדוגמה יוצרת קובץ HTML אחד או רבים עם שמות קבצים שרירותיים ב-
ספרייה נוכחית. ניתן לשנות התנהגות ברירת מחדל זו באמצעות אפשרויות שורת הפקודה
ו/או גיליונות סגנונות בהתאמה אישית.

אפשרויות

האפשרויות הבאות חלות על סקריפט ההמרה:

-f ממשק | --חזיתי ממשק
מאפשר לציין ממשק קצה אחר מאשר ברירת המחדל ספר דוקטור. הרשימה של כרגע
החזיתות הזמינות הן:

ספר דוקטור
ממיר ספר מסמכים עם גיליונות הסגנונות של נורמן וולש. ממשק קצה זה מחפש פנימה
ספריות המשנה של ספריית הבסיס SGML עבור קובץ בשם
html/docbook.dsl or print/docbook.dsl (בהתאם לסוג הקצה האחורי: html
או להדפיס).

-b Backend | - גב Backend
מאפשר לציין קצה אחורי אחר מאשר ברירת המחדל HTML. הרשימה של כרגע
קצה אחורי זמין הוא:

דוי ממיר ל-DVI (קבצים עצמאיים של DeVice) על ידי קריאה יַרקָן or OpenJade.

html ממיר ל-HTML (HyperText Markup Language) על ידי קריאה יַרקָן or OpenJade.

איש ממיר נקודת מוצא לדף ידני של יוניקס על ידי קריאה ל-docbook2man. לא
לעבוד עם סוגי מסמכי SGML אחרים מאשר DocBook.

PDF ממיר ל-PDF (פורמט מסמך נייד) על ידי קריאה יַרקָן or OpenJade.

ps ממיר ל-PostScript על ידי קריאה יַרקָן or OpenJade.

RTF ממיר ל-RTF (פורמט טקסט עשיר) על ידי קריאה יַרקָן or OpenJade. ה
לאחר מכן ניתן לייבא את הקובץ המתקבל MS Word או אחד מה-Linux שלה
תוכניות החלפה.

טקס ממיר ל-TeX על ידי קריאה יַרקָן or OpenJade.

טקסי ממיר לדפי GNU TeXinfo על ידי קריאה ל-docbook2texi. לא עובד עם
סוגי מסמכי SGML אחרים מאשר DocBook.

txt ממיר לקובץ טקסט חשוף על ידי קריאה יַרקָן or OpenJade, לאחר מכן לינקס.

-c פילה | --חתול פילה
מאפשר להשתמש בקטלוג פתיחה SGML נוסף שיפרט קבצים אחרים כמו
גיליונות סגנונות התאמה אישית, התאמות להגדרת סוג המסמך של DocBook,
ישויות אופי מיוחד וכו'. קטלוג זה נוסף לרשימת הקטלוגים
נקבע על ידי התסריט (ראה אפשרות --נוסטד להלן)

-n | --נוסטד
אל תשתמש בקטלוגים הפתוחים של SGML הסטנדרטיים. בדרך כלל, רשימת הקטלוגים הסטנדרטית היא
נקבע כך:

· אם הקטלוג הריכוזי קיים, השתמש בו. הקטלוג המרוכז הוא רשימה
מכל הקטלוגים שעשויים להיות נחוצים שנמצאים בדרך כלל בהם /etc/sgml. שלה
השם מסופק על ידי ה-frontend, למשל ספר דוקטור חזית חוזרת
/etc/sgml/sgml-docbook.cat.

· אחרת, קח את כל הקבצים עם השם קטלוג מתוך ספריות המשנה של ה-SGML
ספריית בסיס (בדרך כלל /usr/share/sgml).
אפשרות זו שימושית בשילוב עם --חתול אפשרות להשתמש רק בקטלוגים ש
מצוינים בשורת הפקודה.

-d פילה|ברירת מחדל|ללא | --dsl פילה|ברירת מחדל|ללא
מאפשר להשתמש בגיליון סגנונות מותאם אישית במקום ברירת המחדל.

ניתן להוסיף לשם הקובץ "יעד" שמתחיל בסימן hash "#". כ
תוצאה, רק החלק המתאים של גיליון הסגנונות מבוצע ("סגנון
מפרט" שה"מזהה" שלו שווה לשם היעד). שימוש נפוץ
של מנגנון זה הוא להגדיר יעדים "#html" ו-"#print" כדי להפעיל את
חלק מקביל בגיליון סגנונות חלופי המשותף הן ל-HTML והן
המרת תדפיס.

על ידי החלפת שם הקובץ ב"ברירת מחדל", גיליון הסגנונות המוגדר כברירת מחדל שסופק עם
נעשה שימוש בחזית הקצה. לדוגמה, ה ספר דוקטור חזית חוזרת ./docbook.dsl#html
(אוֹ ./docbook.dsl#print) בספריית הבסיס של SGML.

על ידי החלפת שם הקובץ ב-"none", לא נעשה שימוש בגיליון סגנונות חלופי, לא
אפילו גיליון הסגנונות המוגדר כברירת מחדל. גיליון הסגנונות שבו נעשה שימוש נקבע גם על ידי
החזית. לדוגמה, ה ספר דוקטור החזית מחזירה את זה של נורמן וולש
html/docbook.dsl (אוֹ print/docbook.dsl) נמצא איפשהו מתחת לבסיס SGML
במדריך.

אם לא צוינה אפשרות --dsl, אזי נעשה שימוש ב-"--dsl default".

-l פילה | --dcl פילה
מאפשר להשתמש בהצהרת SGML מותאמת אישית במקום ברירת המחדל. הקובץ
השם של הצהרת ברירת המחדל של SGML אינו מוגדר עבור קבצי SGML, והוא מוגדר ל
xml.dcl בספריית הבסיס של SGML עבור קובצי XML.

-s נתיב | --sgmlbase נתיב
מאפשר להשתמש במיקום אחר עבור ספריית הבסיס של SGML. זו המדריך
שמתחתיו מותקנים כל ה-SGML DTDs, גיליונות הסגנונות, הישויות וכו'. ברירת המחדל
הערך הוא /usr/share/sgml.

-p התוכנית | -- מנתח התוכנית
ציין את המנתח לשימוש (יַרקָן or OpenJade) אם מותקנים כמה. אם זה
האפשרות לא צוינה, הסקריפט מנסה תחילה להשתמש ב-Jade, ואז הוא מנסה
OpenJade.

-o בספרייה | --תְפוּקָה בספרייה
הגדר את ספריית הפלט שבה כל הקבצים שיתקבלו יאוחסנו. אם הסגנון
גיליונות מגדירים ספריית משנה שבה לאחסן גם את הקבצים המתקבלים, את
ספריית משנה המוגדרת על ידי גיליונות הסגנונות תמוקם מתחת לספריית המשנה
מוגדר על ידי אפשרות זו.

-V משתנה=[ערך]
הגדר משתנה (לערך, אם צוין).

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

-i סעיף | --לִכלוֹל סעיף
הכריז על קטע מסומן ב-SGML כ"כלול". קטע מסומן SGML הוא סוג של
חלק מותנה במסמך. אם הוא יוכרז "התעלם", הוא יישאר
התעלמו, אחרת הוא יעובד. דוגמה לקטע מסומן כזה
post

<DOCTYPE mydoc [

]>

...

...


-w סוג|רשימה | --אַזהָרָה סוג|רשימה
מפעיל או משבית את התצוגה של סוגי אזהרות נתונים. מספר אפשרויות -w
עשוי להיות מוזן בשורת הפקודה. סוגי אזהרה שמתחילים ב-"לא-" השבת
האזהרות המתאימות, הסוגים האחרים מאפשרים אותן.

אם סוג האזהרה מוחלף ב"רשימה", אז רשימה של סוגי אזהרה מותרים
מוצג.

-e סוג|רשימה | --שְׁגִיאָה סוג|רשימה
משבית סוגי שגיאות נתונים. ניתן להזין מספר אפשרויות -e בפקודה
קַו. כל סוגי השגיאות מתחילים ב-"לא-".

אם סוג השגיאה מוחלף ב"רשימה", אז רשימה של סוגי שגיאה מותרים היא
מוצג.

-h | - עזרה
הדפס הודעת עזרה קצרה וצא

-v | --גִרְסָה
הדפס את מזהה הגרסה וצא

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