xml2po - מקוון בענן

תָכְנִית:

שֵׁם

xml2po - תוכנה ליצירת קובץ PO-template מקובץ XML של DocBook ולמזג אותו בחזרה
לקובץ XML (מתורגם).

תַקצִיר

xml2po [אפשרויות] [XMLFILE]

תיאור

דף מדריך זה מתעד בקצרה את xml2po פקודה.

xml2po היא תוכנת Python פשוטה אשר מחלצת תוכן שניתן לתרגם מ-XML בצורה חופשית
מסמכים ופלטים קבצי POT תואמי gettext. ניתן להפוך לקבצי PO מתורגמים
שוב פלט XML.

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

אפשרויות

התוכנית עוקבת אחר תחביר שורת הפקודה הרגיל של GNU, עם אפשרויות ארוכות שמתחילות בשניים
מקפים (`-´). סיכום האפשרויות כלול להלן.

-a, --תגים אוטומטיים
החלטה אוטומטית אם תגים ייחשבו "סופיים" או לא.

-k, --לשמור-ישויות
אל תרחיב ישויות (ברירת מחדל). ראה גם את -e אוֹפְּצִיָה.

-e, --הרחבת-כל-ישויות
הרחב את כל הישויות (כולל SYSTEM).

-m, --mode=סוג
התייחס לתגים כאל סוג סוג (ברירת מחדל: docbook).

-o, --פלט=קובץ
הדפס טקסט שהתקבל (XML תוך מיזוג תרגומים עם אפשרויות "-p" או "-t", POT
קובץ תבנית תוך חילוץ מחרוזות, וקובץ PO מתורגם עם אפשרות "-r") ל
הקובץ הנתון.

-p, --po-file=קובץ
ציין קובץ PO המכיל תרגום ופלט מסמך XML עם תרגומים
התמזגו פנימה.

-r, --שימוש חוזר=קובץ
ציין מסמך XML מתורגם ב-FILE עם אותו מבנה להפקה
קובץ PO מתורגם למסמך XML שניתן בשורת הפקודה.

-t, --תרגום=קובץ
ציין קובץ MO המכיל תרגום ופלט מסמך XML עם תרגומים
התמזגו פנימה.

-u, --עדכון-תרגום=LANG.po
עדכן קובץ PO באמצעות msgmerge.

-l, --שפה=שפה
הגדר במפורש את השפה של התרגום.

-h, - עזרה
הצג סיכום של אפשרויות.

-v, --גִרְסָה
הצג את הגרסה של התוכנית.

דוגמאות

יוצרים סיר תבנית קבצים
כדי ליצור תבנית POT book.pot מקובץ קלט book.xml, המורכב מ
Chapter1.xml ו- Chapter2.xml (ישויות חיצוניות), הרץ:

/usr/bin/xml2po -o book.pot book.xml chapter1.xml chapter2.xml

כדי להרחיב ישויות השתמש ב- -e אפשרות:

/usr/bin/xml2po -e -o book.pot book.xml

יוצרים מתורגם XML קבצים (מיזוג בחזרה PO קבצים)
לאחר תרגום book.pot ל-LANG.po, מיזוג את התרגומים בחזרה על ידי שימוש -p אוֹפְּצִיָה
עבור כל קובץ XML:

/usr/bin/xml2po -p LANG.po -o book.LANG.xml book.xml
/usr/bin/xml2po -p LANG.po -o Chapter1.LANG.xml Chapter1.xml
/usr/bin/xml2po -p LANG.po -o Chapter2.LANG.xml Chapter2.xml

אם השתמשת ב- -e אפשרות להרחיב ישויות, עליך להשתמש בה שוב כדי למזג בחזרה את
תרגום לקובץ XML:

/usr/bin/xml2po -e -p LANG.po -o book.LANG.xml book.xml

עדכון PO קבצים
כאשר קובץ ה-XML הבסיסי משתנה, היתרונות האמיתיים של קובצי PO עולים על פני השטח. יש 2
דרכים למיזוג התרגום. הראשון הוא לייצר קובץ תבנית POT חדש
(בנוסף השתמש ב- -e אם החלטת קודם להרחיב ישויות). אחר כך רוץ
msgmerge כדי למזג את התרגום עם קובץ POT החדש:

/usr/bin/msgmerge -o tmp.po LANG.po book.pot

כעת שנה את שם tmp.po ל-LANG.po ועדכן את התרגום שלך. לחלופין, xml2po מספק
מה היא -u אפשרות, שעושה בדיוק את שני השלבים האלה בשבילך. היתרון הוא שזה גם
פועל msgfmt לתת לך פלט סטטיסטי של סטטוס התרגום (ספירת מתורגמים,
הודעות לא מתורגמות ומטושטשות). השתמש בנוסף ב- -e אם החלטת קודם להרחיב
ישויות:

/usr/bin/xml2po -u LANG.po book.xml

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