.TH "ITSTOOL" "1" "December 2013" "itstool 2.0.7"

.SH "نام (NAME)"
itstool \- تبدیل میان XML و PO با استفاده از ITS


.SH "خلاصه دستور (SYNOPSIS)"
itstool [OPTIONS] XMLFILES...
.br
itstool \fB\-m\fR <MOFILE> [OPTIONS] XMLFILES...
.br
itstool \fB\-j\fR <XMLFILE> [OPTIONS] MOFILES...


.SH "توضیحات (DESCRIPTION)"
\fBitstool \fR پیام‌ها را از فایل‌های XML استخراج کرده و فایل‌های الگوی PO را تولید می‌کند، سپس ترجمه‌ها را از فایل‌های MO ادغام می‌کند تا فایل‌های ترجمه‌شدهٔ XML ایجاد شوند. این ابزار با استفاده از مجموعه برچسب‌های بین‌المللی‌سازی W3C‏ (ITS)، تعیین می‌کند چه مواردی ترجمه شوند و چگونه به پیام‌ها تقسیم گردند.

برای استخراج پیام‌ها از فایل‌های XML مبدأ (\fBXMLFILES\fR) و نوشتن آن‌ها در \fBOUT.pot\fR:

.BR "itstool \-o OUT.pot XMLFILES"

پس از ادغام با ترجمه‌های موجود یا ترجمهٔ رشته‌ها، یک فایل MO با استفاده از \fBmsgfmt(1)\fR تولید کرده و سپس فایل‌های ترجمه‌شده را در دایرکتوری \fBDIR\fR خروجی دهید:

.BR "itstool \-m OUT.mo \-o DIR XMLFILES"

همچنین می‌توانید با استفاده از یک فایل ورودی XML و مجموعه‌ای از فایل‌های MO، یک فایل خروجی XML چندزبانهٔ منفرد ایجاد کنید:

.BR "itstool \-j FILE.xml \-o OUT.xml MOFILES"

تعاریف ITS از قواعد توکار، قواعد تعبیه‌شده در فایل‌های XML مبدأ، فایل‌های ارائه‌شده با گزینهٔ \fB-i\fR، و مشخصه‌های ITS در فایل‌های XML مبدأ بارگذاری می‌شوند. تعاریف بعدی اولویت بالاتری دارند. می‌توانید قواعد توکار را با ارسال گزینهٔ \fB-n\fR غیرفعال کنید.


.SH "گزینه‌ها (OPTIONS)"

.SS "استخراج (Extracting)"

.IP "\fB\-o \fIOUT.pot\fR" 4
.PD 0
.IP "\fB\-\-out \fIOUT.pot\fR" 4
خروجی دادن الگوی PO به فایل \fBOUT.pot\fR

.SS "ادغام (Merging)"

.IP "\fB\-m \fIMOFILE\fR \fIXMLFILES\fR" 4
.PD 0
.IP "\fB\-\-merge \fIMOFILE\fR \fIXMLFILES\fR" 4
ادغام از یک فایل MO به نام \fBMOFILE\fR و تولید فایل‌های XML ترجمه‌شده برای \fBXMLFILES\fR مبدأ

.IP "\fB\-l \fILANG\fR" 4
.PD 0
.IP "\fB\-\-lang \fILANG \fR" 4
تنظیم صریح کد زبان خروجی به XML

.IP "\fB\-o \fIOUT\fR" 4
.PD 0
.IP "\fB\-\-out \fIOUT \fR" 4
خروجی دادن فایل‌های XML در دایرکتوری \fBOUT\fR

.SS "پیوستن (Joining)"

.IP "\fB\-j \fXMLIFILE\fR \fIMOFILES\fR" 4
.PD 0
.IP "\fB\-\-join \fIXMLFILE\fR \fIMOFILES\fR" 4
پیوست ترجمه‌ها از \fBMOFILES\fR درون یک فایل چندزبانه بر اساس فایل مبدأ \fBXMLFILE\fR

.IP "\fB\-o \fIOUT.xml\fR" 4
.PD 0
.IP "\fB\-\-out \fIOUT.xml\fR" 4
خروجی دادن به فایل XML با نام \fBOUT.xml\fR

.SS "عمومی (Common)"

.IP "\fB\-i \fIITS\fR" 4
.PD 0
.IP "\fB\-\-its \fIITS\fR" 4
بارگذاری قواعد ITS در فایل \fBITS\fR (می‌تواند چندین بار مشخص شود)

.IP "\fB\-n\fR" 4
.PD 0
.IP "\fB\-\-no\-builtins\fR" 4
اعمال نکردن قواعد توکار ITS که همراه itstool عرضه می‌شوند

.IP "\fB\-s\fR" 4
.PD 0
.IP "\fB\-\-strict\fR" 4
خروج با خطا در صورتی که فایل‌های PO حاوی XML خراب یا نامعتبر باشند

.IP "\fB\-d\fR" 4
.PD 0
.IP "\fB\-\-load\-dtd\fR" 4
بارگذاری DTDهای خارجی مورد استفاده توسط فایل‌های XML ورودی

.IP "\fB\-k\fR" 4
.PD 0
.IP "\fB\-\-keep\-entities\fR" 4
نگه‌داشتن مراجع نهادها به‌صورت گسترش‌نیافته در فایل‌های PO

.IP "\fB\-p \fINAME VALUE\fR" 4
.PD 0
.IP "\fB\-\-param \fINAME VALUE\fR" 4
تعریف پارامتر ITS به نام \fBNAME\fR با مقدار \fBVALUE\fR (می‌تواند چندین بار مشخص شود)


.SH "نویسندگان (AUTHORS)"
Shaun McCance <shaunm@gnome.org>


.SH "همچنین ببینید (SEE ALSO)"
مستندات بیشتری برای \fBitstool\fR به‌صورت برخط نگهداری می‌شود. برای اطلاعات بیشتر، ببینید:

.BR "http://itstool.org/documentation"