db2x_xsltproc - מקוון בענן

תָכְנִית:

שֵׁם

db2x_xsltproc - מעטפת קורא למעבד XSLT

תַקצִיר

db2x_xsltproc [אפשרויות] מסמך xml

תיאור

db2x_xsltproc מפעיל את מעבד XSLT 1.0 עבור docbook2X.

פקודה זו מיישמת את גיליון הסגנונות XSLT (ניתן בדרך כלל על ידי ה --גיליון סגנונות אפשרות) ל-
מסמך XML בקובץ מסמך xml. התוצאה נכתבת לפלט סטנדרטי (אלא אם כן
השתנה עם --תְפוּקָה).

כדי לקרוא את מסמך ה-XML המקור מקלט רגיל, ציין - כמסמך הקלט.

אפשרויות

--גִרְסָה
הצג את גרסת docbook2X.

טרנספורמציה תפוקה אפשרויות
--תְפוּקָה פילה, -o פילה
כתוב פלט לקובץ הנתון (או URI), במקום פלט רגיל.

מקור מסמך אפשרויות
--xinclude, -I
תהליך Xכלול הנחיות במסמך המקור.

--sgml, -S
ציין שמסמך הקלט הוא SGML במקום XML. אתה צריך את הסט הזה
אפשרות אם מסמך xml הוא למעשה קובץ SGML.

ניתוח SGML מיושם על ידי המרה ל-XML באמצעות sgml2xml(1) מה-SP
חבילה (או osx(1) מחבילת OpenSP). כל שמות התגים בקובץ SGML יהיו
מנורמל לאותיות קטנות (כלומר ה - נמוך יותר אופציה של sgml2xml(1) משמש). תְעוּדַת זֶהוּת
תכונות זמינות עבור גיליון הסגנונות (כלומר אפשרות -xid). בנוסף, כל
ישויות ISO SDATA המשמשות במסמך SGML מומרות אוטומטית לשלהן
מקבילות של XML Unicode. (זה נעשה על ידי א צמא לְסַנֵן.)

יש לציין את הקידוד של מסמך SGML, אם הוא אינו us-ascii
משתני סביבת SP הסטנדרטיים: SP_CHARSET_FIXED=1 SP_ENCODING=הַצפָּנָה.
(שים לב שקובצי XML מציינים את הקידוד שלהם עם הצהרת ה-XML <?xml
גרסה = "1.0" קידוד = "הַצפָּנָה" ?> בראש הקובץ.)

לא ניתן לשנות את אפשרויות ההמרה לעיל. אם אתה רוצה המרה אחרת
אפשרויות, אתה צריך להפעיל sgml2xml(1) באופן ידני, ולאחר מכן להעביר את התוצאות של זה
המרה לתוכנית זו.

שְׁלִיפָה אפשרויות
--קטלוגים קבצי קטלוגים, -C קבצי קטלוגים
ציין קטלוגי XML נוספים לשימוש לפתרון מזהים ציבוריים פורמליים או
URIs. קטלוגי SGML אינם נתמכים.

הקטלוגים האלה הם לֹא משמש לניתוח מסמך SGML תחת --sgml אוֹפְּצִיָה.
השתמש במשתנה הסביבה SGML_CATALOG_FILES במקום לציין את הקטלוגים עבור
ניתוח מסמך SGML.

--רֶשֶׁת, -N
db2x_xsltproc בדרך כלל יסרב לטעון משאבים חיצוניים מהרשת, עבור
סיבות ביטחוניות. אם אתה כן רוצה לטעון מהרשת, הגדר את האפשרות הזו.

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

גיליון סגנונות אפשרויות
--גיליון סגנונות פילה, -s פילה
ציין את שם הקובץ (או URI) של גיליון הסגנונות לשימוש. הערכים המיוחדים איש ו
texi מתקבלים כקיצורים, כדי לציין זאת מסמך xml נמצא ב-DocBook ו
יש להמיר לדפי אדם או ל-Texinfo (בהתאמה).

--param שם=ביטוי, -p שם=ביטוי
הוסף או שנה פרמטר לגיליון הסגנונות. שם הוא שם פרמטר XSLT, ו
ביטוי הוא ביטוי XPath שמעריך את הערך הרצוי עבור הפרמטר.
(זה אומר שיש לצטט מחרוזות, in תוספת לציטוט הרגיל של פגז
טיעונים; להשתמש --string-param כדי להימנע מכך.)

--string-param שם=מחרוזת, -g שם=מחרוזת
הוסף או שנה פרמטר בעל ערך מחרוזת לגיליון הסגנונות.

המחרוזת חייבת להיות מקודד ב-UTF-8 (ללא קשר לקידוד התווים המקומי).

פיתרון ו פרופילינג
--לנפות, -d
הצג, לשגיאה סטנדרטית, יומנים של מה שקורה במהלך ה-XSL
טרנספורמציה.

--מגבלה של קינון n, -D n
שנה את המספר המרבי של שיחות מקוננות לתבניות XSL, המשמשות לזיהוי
לולאות אינסופיות פוטנציאליות. אם לא צוין, המגבלה היא 500 (ברירת המחדל של libxslt).

--פּרוֹפִיל, -P
הצג מידע על הפרופיל: המספר הכולל של שיחות לכל תבנית ב-
גיליון הסגנונות והזמן שלוקח לכל אחד מהם. מידע זה מופק לתקן
שגיאה.

--xslt-מעבד מעבד, -X מעבד
בחר את מעבד ה-XSLT הבסיסי שבו נעשה שימוש. הבחירות האפשריות עבור מעבד הם:
libxslt, saxon, xalan-j.

מעבד ברירת המחדל הוא מה שהוגדר כאשר docbook2X נבנה. libxslt הוא
מומלץ (בגלל שהוא רזה ומהיר), אבל SAXON הוא הרבה יותר חזק ויהיה
להיות מועיל יותר בעת איתור באגים בגיליונות סגנונות.

לכל המעבדים מופעלת תמיכה בקטלוגי XML. (docbook2X דורש זאת.)
אבל שימו לב שלא כל האפשרויות שלמעלה עובדות עם מעבדים מלבד libxslt
אחד.

הסביבה

XML_CATALOG_FILES
ציין קטלוגים של XML. אם לא צוין, הקטלוג הסטנדרטי (/etc/xml/catalog) הוא
טעון, אם זמין.

DB2X_XSLT_PROCESSOR
ציין את מעבד ה-XSLT לשימוש. ההשפעה זהה ל- --xslt-מעבד
אוֹפְּצִיָה. השימוש העיקרי במשתנה זה הוא לאפשר לך לבדוק במהירות שונות
מעבדי XSLT ללא צורך להוסיף --xslt-מעבד לכל קובץ סקריפט או make
במערכת בניית התיעוד שלך.

התאמה ל

שפת גיליון סגנונות XML - טרנספורמציות (XSLT), גרסה 1.0 ⟨http://www.w3.org/TR/xslt⟩
, המלצת W3C.

אורים

בגרסאות הקודמות שלו (<0.8.4), docbook2X דרש הרחבות XSLT כדי לפעול, ו
db2x_xsltproc היה מעבד מיוחד המבוסס על libxslt שההרחבות הללו הוקדרו.
כאשר הדרישה לתוספי XSLT בוטלה, db2x_xsltproc הפך לתסריט של פרל
אשר מתרגם את האפשרויות ל db2x_xsltproc כדי להתאים לפורמט המקובל על ידי
מניות xsltproc(1) שמגיע עם libxslt.

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

השתמש ב-db2x_xsltproc באופן מקוון באמצעות שירותי onworks.net