docbook-2-rtf - מקוון בענן

תָכְנִית:

שֵׁם

sgml2x - פורמט בקלות מסמכי SGML/XML באמצעות גיליונות סגנונות DSSSL

תַקצִיר

sgml2x [אפשרויות] [sgmlfile | קובץ xml ]

docclass-2-פורמט יעד [אפשרויות] [sgmlfile | קובץ xml ]

תיאור

sgml2x מאפשר לעצב בקלות מסמך SGML או XML באמצעות גיליונות סגנונות DSSSL, ו
מספק את התכונות הבאות:

· מספר גיליונות סגנונות אפשריים לכל כיתת מסמכים

· מפרט קל של גיליונות סגנונות באמצעות כינויים, עם תמיכה בפרמטר
ירושה

· שילוב קל של גיליונות סגנונות חדשים על ידי הוספת קובץ הגדרה חדש פשוט ב-a
ספריית הגדרות

· המתקשר יכול לציין רשימה דמוית PATH של ספריות תצורה, ברירת המחדל היא
ספריות תצורה כלל-מערכתיות, לכל משתמש ולפרוייקט

· בחירה אוטומטית של גיליון סגנונות ברירת מחדל לשימוש, בהתבסס על שהוקצה
סדרי עדיפויות

· להעביר אפשרויות שרירותיות ל ירקן(1)

מחלקת המסמכים המשמשת כדי לחפש את גיליונות הסגנונות, ואת פורמט הפלט, היא לעת עתה
נגזר רק מהשם שבו נקראת התוכנית, אז תרצה לקרוא לזה
לתכנת באמצעות קישורים סמליים כמו docbook-2-pdf.

sgml2x הוא מיושם כמו מעטפת מעטפת מסביב ירקן(1) (או, רצוי, openjade(1),
למרות שאנו משתמשים בשם הגנרי ירקן לאורך התיעוד הזה), jadetex(1) ואחר
כלים.

אם אין jadetex.cfg קובץ ליד המסמך, מועתק ברירת מחדל, המאפשר
הפקת סימניות PDF.

אפשרויות

-c|--קָטָלוֹג קטלוג
השתמש בקטלוג ה-SGML שצוין במקום ברירת המחדל של המערכת.

-C|--confdirs רשימת dir
השתמש ברשימה (מופרדת ברווחים לבנים) של ספריות תצורה. אפשרות זו היא
מצטבר, כלומר אתה יכול להשתמש בכמה -C אפשרויות והרשימות יהיו
משורשרים.

יש להזמין את רכיבי הרשימה מהתצורה הגנרית ביותר (לדוגמה לכל המערכת)
לספציפי ביותר (למשל לכל הפרויקט).

אם כל ספרייה מסופקת דרך אפשרות זו, רשימת ספריות ברירת המחדל תהיה
התעלם.

-D|--dssslproc מעבד dsssl
השתמש מעבד dsssl כדי להחיל את גיליון הסגנונות, במקום ברירת המחדל. זֶה
המעבד צריך לתמוך ירקןאפשרויות כמו, כגון -V.

כאשר אפשרות זו אינה קיימת, הראשון שנמצא ב- dssslproc קבצים מ-confdirs הוא
נלקח. לִרְאוֹת "קבצים" לקבלת פרטים נוספים.

-h|- עזרה הצג הודעת עזרה וצא.

-j|--יַרקָן מעבד dsssl
מילה נרדפת מיושנת ל --dssslproc.

--jadetexfilter perl-פילטר
לאחר עיבוד פלט Jadetex באמצעות מסנן perl.

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

ראה דוגמאות/שורות פקודה קובץ לשימושים אפשריים.

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

-o|--openjade
זֶה אוֹפְּצִיָה is מְיוּשָׁן. openjade הוא כעת ברירת המחדל כאשר זמין. להשתמש
--dssslproc או dssslproc קובץ תצורה כדי לאלץ מעבד ספציפי.

אפשרות זו נהגה להשתמש openjade(1) כמעבד DSSSL במקום ירקן(1).

-O|--ג'דיאופטים אפשרויות ירקן
אפשרויות נוספות לעבור אליהן ירקן(1). אפשרות זו היא מצטברת, אתה יכול
ציין כמה מהן, האפשרויות שסופקו ישולבו.

-q|--שֶׁקֶט
הגדר מילולית ל שֶׁקֶט

-r|--הערות
עיבוד תוכן הערות המסמך במסמך (הֶעָרָה אלמנטים ב
DocBook 4, הערה אלמנטים ב-DocBook 3), מה שהופך את הפלט המופק ל-an
לשימוש פנימי בלבד מסמך, הדפסת אזהרה מודגשת על הכריכה.

זוהי תכונה ספציפית ל-docclass ולגיליון סגנונות, ולא כל גיליונות הסגנונות ישתמשו
זֶה.

-s|--סִגְנוֹן סגנון
בחר סגנון פלט כדי לעקוף את ברירת המחדל (בסופו של דבר שמקורה במסמך).

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

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

-v|--מִלוּלִי
הגבר את מידת המלל. ניתן לציין אפשרות זו מספר פעמים.

--מֶלֶל N
הגדר מילולית ל N. רמות הדיבור מוגדרות כדלקמן:

שֶׁקֶט רק שגיאות הדפסה

ברירת מחדל רק שגיאות ואזהרות הדפסה

מִלוּלִי גם להדפיס הודעות

להתחקות הדפס גם פקודות משמעותיות תוך כדי הפעלתן (כמו --אין מעשה עושה).

באגים הדפס גם הודעות איתור באגים

-V|--גִרְסָה
הדפס את גרסת התוכנית וצא.

תְצוּרָה

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

היררכיות סגנונות ממוקמות בספריות בשם סגנונות בכל תצורה
מַדרִיך. גרסאות ישנות של תוכנית זו נהגו לשים את ההיררכיות הללו ישירות ב-
ספריות תצורה.

ספריית תצורה מכילה ספריה אחת עבור כל מחלקה ידועה של מסמכים, בשם עם
כינוי למחלקת מסמך (למשל ספר דוקטור). ספריות docclass אלה מכילות תת-
ספרייה עבור כל מחלקה של פורמט פלט (כרגע, בלבד html ו הדפסה נתמכים).

נכון לעכשיו, בעיות יישום אוכפות הגבלה על כינויים עבור מחלקות מסמכים
וגיליונות סגנונות: הם יכולים להכיל רק תווים אלפאנומריים ותווים קו תחתון. זֶה
ייתכן שהגבלה תבוטל במהדורה עתידית, אבל זה לא יקרה לפני זה
התסריט נכתב מחדש בשפה אחרת.

כל אחת מהספריות האלה מכילה קובץ אחד לכל סגנון זמין. שמות הקבצים הללו
עשוי להכיל תווים אלפאנומריים בלבד, והם משמשים כינויים לסגנונות. זֶה
הקובץ מכיל שורות עם a מפתח: ערך דפוס, כאשר המקשים הבאים נמצאים כעת
נתמך:

Id המזהה הציבורי של גיליון הסגנונות

יורד תיאור קצר של הסגנונות, שיוצג בהודעת העזרה

pdf Override, ps Override,
rtfOverride, mifOverride" 10 סמל dsssl מגיליון הסגנונות להדפסה שיש להגדיר
ל #t (או א סמל=ערך זוג, מתאים כטיעון ל ירקן's -V אוֹפְּצִיָה),
לשימוש עבור פורמט ההדפסה הנתון.

מותר רק סמל אחד לכל שורת עקיפה. כדי להגדיר ערכים עבור מספר סמלים, השתמש
כמה שורות.

ירושות הכינוי של גיליון סגנונות זה יורש ממנו, כדי למנוע מיותר
שכפול של הגדרות סגנון.

נכון לעכשיו, זה רק גורם להורשה של *עקוף פרמטרים.

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

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

10 גיליונות הסגנונות הבסיסיים, שבדרך כלל חייבים להתאים אישית.

0 כל גיליון סגנונות שנכתב למטרה מיוחדת (למשל
גיליון מוצר שיווקי).

1000 סגנון ברירת מחדל עבור כל המסמכים המיוצרים על ידי ארגון. בדרך כלל א
התאמה אישית קלה, הכוללת העדפות פריסה, של הארגון
לוגו, או דברים כאלה.

10-100 התאמות אישיות כלליות שונות של גיליונות הסגנונות הבסיסיים.

כשאתה כותב גרסה משופרת של גיליון סגנונות עם עדיפות n, אתה
בדרך כלל רוצה לבחור בעדיפות גבוהה יותר.

קבצים

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ ספריות התצורה המוגדרות כברירת מחדל, שבהן נמצאים קבצי התצורה
חיפש את. ראה תיעוד עבור --confdirs לקבלת פרטים נוספים.

confdir/סִגְנוֹן/
ההיררכיה המגדירה סגנונות שמיש. לִרְאוֹת "תְצוּרָה" במשך יותר
פרטים.

confdir/dssslproc
קובץ המכיל רשימה מסודרת של מעבדי dsssl שיש לחפש, מופרדים על ידי
שורות חדשות ו/או רווח לבן. קווים המתחילים בא # מתייחסים לדמות כאל
הערות. ערכים נפוצים כוללים openjade ו ירקן.

מעבדי DSSSL המצוינים כאן צריכים לקבל את -V ו -D תואם ירקן
אפשרויות שורת הפקודה.

מחפשים את ספריות התצורה החל מהספציפי ביותר
האחת, כך שעם ברירת המחדל של confdirs, הגדרות הפרויקט עשויות לעקוף את המשתמש
הגדרות, אשר בתורן עשויות לעקוף את הגדרות המערכת.

הערך המיוחד שקר יכול לשמש כדי לעצור את החיפוש ולמנוע בדיקה
ספריות כלליות יותר. אם למשל פרויקט חייב להשתמש ב
openjade-1.4devel פקודה ולא אחרת, היא יכולה לציין openjade-1.4devel שקר
ב dssslproc קובץ.

אזהרות

כשמשתמש openjade-1.4devel בתור מעבד DSSSL, תראה תלונה על
רמת זרימה-אובייקט שנוצר על ידי doctype.dsl, וקביעה אוטומטית של המסמך-
סוג ייכשל. שגיאה זו אינה מזיקה אחרת. רעיונות איך להתמודד עם זה, או
אישור לכך openjade-1.4devel קפדנית מדי, יתקבל בברכה :)

אל האני עתיד

תכונות מתוכננות עבור מהדורות עתידיות כוללות:

· אינטגרציה של מחולל אינדקס

· שילוב של מנוע הדפסה יפה לדוגמאות קוד

· מפרט טרנספורמציות לשרשור

· הצהרת תת-ערכת docclasses כדי לאפשר שימוש עם כל docclass של הסגנון-
גיליונות החלים על מחלקות ה-Superset שלה.

· עבודה במקום זמני כדי לא לזהם את ספריית העבודה עם
קבצים זמניים. זה לא קל כמו שזה נשמע, כי זה שובר מסמך
מתייחס לקבצי תמונה המשתמשים בנתיבים יחסיים. אפשר לראות בזה באג ירקן,
למרות זאת.

עיין ברשימת ה-TODO המלאה ושלח לנו רעיונות נוספים!

זכויות יוצרים

זכויות יוצרים © 2001-2003 Alcove & Yann Dirson.

sgml2x מורשה תחת הרישיון הציבורי הכללי של GNU, גרסה 2.

תיעוד זה מורשה תחת רישיון התיעוד החופשי של GNU, גרסה 1.

צרו קשר us

sgml2x הוא חלק AlcoveBook פּרוֹיֶקט (קישור ל כתובת האתר http://www.alcove-
labs.org/en/software/alcovebook/) . אנא השתמש ב- AlcoveBook דיוור רשימות (קישור ל כתובת האתר
https://savannah.gnu.org/mail/?group_id=533) ליצור קשר עם מפתחים ומשתמשים.

רשימת הבאגים ובקשות התכונות זמינה דרך a אינטרנט ממשק (קישור ל כתובת האתר
https://savannah.gnu.org/support/?group_id=533) . אנא השתמש בו כדי לשלוח בעיות ו
רעיונות.

לִרְאוֹת גם

openjade(1), ירקן(1), jadetex(1), collateindex.pl(1).

sgml2x(1)

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