db2x_texixml - מקוון בענן

תָכְנִית:

שֵׁם

db2x_texixml - צור קבצי Texinfo מ-Texi-XML

תַקצִיר

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

תיאור

db2x_texixml ממירה מסמך Texi-XML למסמך Texinfo אחד או יותר.

If מסמך xml לא ניתן, אז המסמך להמרה מגיע מקלט רגיל.

שמות הקבצים של מסמכי Texinfo נקבעים על ידי סימון במקור Texi-XML.
(אם שמות הקבצים אינם מצוינים בסימון, אז db2x_texixml ניסיונות להסיק
אותם מהשם של קובץ הקלט. עם זאת, מקור ה-Texi-XML צריך לציין את
שם הקובץ, מכיוון שהוא לא עובד כאשר יש מספר קובצי פלט או כאשר ה-Texi-
מקור XML מגיע מקלט רגיל.)

אפשרויות

--קידוד=הַצפָּנָה
בחר את קידוד התווים המשמש עבור קבצי הפלט. הקידודים הזמינים
הם אלה של סמל(1). קידוד ברירת המחדל הוא us-ascii.

מקור ה-XML עשוי להכיל תווים שאינם ניתנים לייצוג בקידוד
שאתה בוחר; במקרה זה התוכנית תפוצץ במהלך העיבוד, ואתה
צריך לבחור קידוד אחר. (מובטח שזה לא יקרה עם שום Unicode
קידוד כגון UTF-8, אך למרבה הצער לא כולם מסוגלים לעבד את Unicode
טקסטים.)

אם אתה משתמש בגרסה של GNU של סמל(1), אתה יכול להדביק את //TRANSLIT לסוף
שם הקידוד לניסיון תעתיק של תווים שאינם ניתנים להמרה
הפלט. היזהר, עם זאת, כי הדמויות באמת בלתי ניתן להמרה יהיו
הפך לעוד אחד מאותם סימני שאלה ארורים. (לא נמאס לך מזה?)

הסיומת //TRANSLIT חלה על קידוד Unicode - בפרט,
utf-8//TRANSLIT - פירושו שקובצי הפלט יישארו ב-Unicode, אך סימון-
תרגומי תווים ברמה באמצעות utf8trans עדיין צריך לעשות. אז ברובם
מקרים, מסמך באנגלית, המרה באמצעות --encoding=utf-8//TRANSLIT
למעשה יסתיים כמסמך US-ASCII, אבל כל התווים הבלתי ניתנים לתרגום יגיעו
להישאר כ-UTF-8 ללא כל אזהרה כלשהי. (הערה: למהדרין זהו
לא "תעתיק". שיטת המרה זו היא פשרה על קפדנית
--encoding=us-ascii עיבוד, אשר מבטל אם יש תווים בלתי ניתנים לתרגום
נתקל ב.

שים לב שדפי אדם ומסמכי Texinfo בקידוד שאינם ASCII (כולל UTF-8)
לא יכול להיות נייד למערכות ישנות יותר (לא בינלאומיות), וזו הסיבה שה
ערך ברירת המחדל עבור אפשרות זו הוא us-ascii.

כדי לדכא כל מיפוי תווים או המרת קידוד אוטומטית כלשהי, עברו
האפשרות --encoding=utf-8.

--רשימת קבצים
כתוב רשימה של כל קבצי הפלט לפלט רגיל, בנוסף לרגיל
מעבד.

--output-dir=dir
ציין את הספרייה שבה ממוקמים קבצי הפלט. ברירת המחדל היא ה
ספריית העבודה הנוכחית.

אפשרות זו מתעלמת אם הפלט ייכתב לפלט סטנדרטי (מופעל
לפי האופציה --to-stdout).

--to-stdout
כתוב את הפלט לפלט רגיל במקום לקבצים בודדים.

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

אפשרות זו אינה תואמת --רשימת קבצים, מובן מאליו.

- מידע העבר את הפלט של Texinfo אל makeinfo(1), יצירת קבצי מידע ישירות במקום
קבצי Texinfo.

--טקסט פשוט
העבר את הפלט של Texinfo אל makeinfo --ללא כותרות, ובכך ליצור טקסט רגיל
קבצים.

- עזרה הצג מידע קצר על שימוש וצא.

--גִרְסָה
הצג גרסה וצא.

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

--utf8trans-program=נתיב, --utf8trans-map=charmap
השתמש במפת התווים charmap עם utf8trans(1) תוכנית, כלולה עם
docbook2X, נמצא תחת נתיב.

--iconv-program=נתיב
המיקום של סמל(1) תוכנית, המשמשת לקידוד המרות.

אורים

Texinfo שפה תאימות. קבצי ה-Texinfo שנוצרו על ידי db2x_texixml לפעמים
דורשים של Texinfo גרסה 4.7 (הגרסה העדכנית ביותר) כדי לעבוד כראוי. באופן מיוחד:

· db2x_texixml מסתמך על makeinfo כדי להוסיף אוטומטית סימני פיסוק אחרי @ref אם זה
לא כבר שם. אחרת ההיפר-קישור לא יעבוד בקורא המידע (אם כי
makeinfo לא יפלוט שום שגיאה).

· הפקודה החדשה @comma{} משמשת לפסיקים (,) המופיעים בתוך רשימות ארגומנטים ל
פקודות Texinfo, כדי לבלבל אותה מהפסיק המשמש להפרדה בין שונים
טיעונים. האלטרנטיבה היחידה אחרת תהיה לתרגם, ל. שהוא
ברור שזה לא רצוי (אבל גרסאות קודמות של docbook2X עשו זאת).

אם אינך יכול להשתמש בגרסה 4.7 של makeinfo, אתה עדיין יכול להשתמש ב-a צמא תסריט לביצוע
באופן ידני את ההליך שתואר זה עתה.

קשר of Texi-XML עם מה היא XML תפוקה פוּרמָט of makeinfo. פורמט Texi-XML בשימוש על ידי
docbook2X הוא אחר ואינו תואם לפורמט ה-XML שנוצר על ידי makeinfo(1) עם
שלה --xml אוֹפְּצִיָה. מצב זה נוצר בין השאר בגלל פורמט ה-Texi-XML של docbook2X
תוכנן ויושם באופן עצמאי לפני הופעתו של makeinfoפורמט ה-XML של.
כמו כן Texi-XML מכוון מאוד להוויה שנוצר על ידי מכונה החל מ- אַחֵר XML פורמטים,
בעוד שנראה שאין יישומים לא טריוויאליים של makeinfoפורמט ה-XML של. אז יש
אין סיבה בשלב זה ל-docbook2X לאמץ makeinfoפורמט ה-XML של Texi-XML.

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