| ITSTOOL(1) | General Commands Manual | ITSTOOL(1) |
نام (NAME)
itstool - تبدیل میان XML و PO با استفاده از ITS
خلاصه دستور (SYNOPSIS)
itstool [OPTIONS] XMLFILES...
itstool -m <MOFILE> [OPTIONS] XMLFILES...
itstool -j <XMLFILE> [OPTIONS] MOFILES...
توضیحات (DESCRIPTION)
itstool پیام‌ها را از فایل‌های XML استخراج کرده و فایل‌های الگوی PO را تولید می‌کند، سپس ترجمه‌ها را از فایل‌های MO ادغام می‌کند تا فایل‌های ترجمه‌شدهٔ XML ایجاد شوند. این ابزار با استفاده از مجموعه برچسب‌های بین‌المللی‌سازی W3C (ITS)، تعیین می‌کند چه مواردی ترجمه شوند و چگونه به پیام‌ها تقسیم گردند.
برای استخراج پیام‌ها از فایل‌های XML مبدأ (XMLFILES) و نوشتن آن‌ها در OUT.pot:
itstool -o OUT.pot XMLFILES
پس از ادغام با ترجمه‌های موجود یا ترجمهٔ رشته‌ها، یک فایل MO با استفاده از msgfmt(1) تولید کرده و سپس فایل‌های ترجمه‌شده را در دایرکتوری DIR خروجی دهید:
itstool -m OUT.mo -o DIR XMLFILES
همچنین می‌توانید با استفاده از یک فایل ورودی XML و مجموعه‌ای از فایل‌های MO، یک فایل خروجی XML چندزبانهٔ منفرد ایجاد کنید:
itstool -j FILE.xml -o OUT.xml MOFILES
تعاریف ITS از قواعد توکار، قواعد تعبیه‌شده در فایل‌های XML مبدأ، فایل‌های ارائه‌شده با گزینهٔ -i، و مشخصه‌های ITS در فایل‌های XML مبدأ بارگذاری می‌شوند. تعاریف بعدی اولویت بالاتری دارند. می‌توانید قواعد توکار را با ارسال گزینهٔ -n غیرفعال کنید.
گزینه‌ها (OPTIONS)
استخراج (Extracting)
- -o OUT.pot
- --out OUT.pot
- خروجی دادن الگوی PO به فایل OUT.pot
ادغام (Merging)
- -m MOFILE XMLFILES
- --merge MOFILE XMLFILES
- ادغام از یک فایل MO به نام MOFILE و تولید فایل‌های XML ترجمه‌شده برای XMLFILES مبدأ
- -l LANG
- --lang LANG
- تنظیم صریح کد زبان خروجی به XML
- -o OUT
- --out OUT
- خروجی دادن فایل‌های XML در دایرکتوری OUT
پیوستن (Joining)
- -j MLIFILE MOFILES
- --join XMLFILE MOFILES
- پیوست ترجمه‌ها از MOFILES درون یک فایل چندزبانه بر اساس فایل مبدأ XMLFILE
- -o OUT.xml
- --out OUT.xml
- خروجی دادن به فایل XML با نام OUT.xml
عمومی (Common)
- -i ITS
- --its ITS
- بارگذاری قواعد ITS در فایل ITS (می‌تواند چندین بار مشخص شود)
- -n
- --no-builtins
- اعمال نکردن قواعد توکار ITS که همراه itstool عرضه می‌شوند
- -s
- --strict
- خروج با خطا در صورتی که فایل‌های PO حاوی XML خراب یا نامعتبر باشند
- -d
- --load-dtd
- بارگذاری DTDهای خارجی مورد استفاده توسط فایل‌های XML ورودی
- -k
- --keep-entities
- نگه‌داشتن مراجع نهادها به‌صورت گسترش‌نیافته در فایل‌های PO
- -p NAME VALUE
- --param NAME VALUE
- تعریف پارامتر ITS به نام NAME با مقدار VALUE (می‌تواند چندین بار مشخص شود)
نویسندگان (AUTHORS)
Shaun McCance <shaunm@gnome.org>
همچنین ببینید (SEE ALSO)
مستندات بیشتری برای itstool به‌صورت برخط نگهداری می‌شود. برای اطلاعات بیشتر، ببینید:
| December 2013 | itstool 2.0.7 |