.TH MSGFMT 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر"
.SH "نام (NAME)"
msgfmt \- کامپایل و تولید کاتالوگ پیام باینری از فایل PO
.SH "خلاصه دستور (SYNOPSIS)"
.B msgfmt
[\fI\,گزینه\/\fR]... \fI\,filename.po\/\fR...
.SH "توضیحات (DESCRIPTION)"
.PP
تولید کاتالوگ پیام باینری از توصیف متنی ترجمه.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
همین امر برای آرگومان‌های اختیاری نیز صدق می‌کند.
.SS "محل فایل ورودی:"
.TP
\fIfilename.po\fR ...
فایل‌های ورودی
.TP
\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
افزودن \fIDIRECTORY\fR به فهرست جستجوی فایل‌های ورودی
.PP
اگر فایل ورودی \- باشد، ورودی استاندارد خوانده می‌شود.
.SS "حالت عملیات:"
.TP
\fB\-j\fR, \fB\-\-java\fR
حالت جاوا: تولید یک کلاس ResourceBundle جاوا
.TP
\fB\-\-java2\fR
مشابه \fB\-\-java\fR، با فرض Java2 (JDK 1.2 یا بالاتر)
.TP
\fB\-\-csharp\fR
حالت C#: تولید یک فایل .dll دات‌نت (.NET)
.TP
\fB\-\-csharp\-resources\fR
حالت منابع C#: تولید یک فایل .resources دات‌نت (.NET)
.TP
\fB\-\-tcl\fR
حالت Tcl: تولید یک فایل .msg مربوط به tcl/msgcat
.TP
\fB\-\-qt\fR
حالت Qt: تولید یک فایل .qm مربوط به کیوت (Qt)
.TP
\fB\-\-desktop\fR
حالت Desktop Entry: تولید یک فایل .desktop
.TP
\fB\-\-xml\fR
حالت XML: تولید فایل XML
.SS "محل فایل خروجی:"
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
نوشتن خروجی در فایل مشخص‌شده
.TP
\fB\-\-strict\fR
فعال‌سازی حالت دقیق سازگار با Uniforum
.PP
اگر فایل خروجی \- باشد، خروجی در خروجی استاندارد نوشته می‌شود.
.SS "محل فایل خروجی در حالت جاوا:"
.TP
\fB\-r\fR, \fB\-\-resource\fR=\fI\,RESOURCE\/\fR
نام منبع (resource)
.TP
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR
نام محلی (locale)، به‌صورت زبان یا زبان_کشور
.TP
\fB\-\-source\fR
تولید یک فایل .java، به‌جای فایل .class
.TP
\fB\-d\fR DIRECTORY
دایرکتوری پایه در سلسله‌مراتب دایرکتوری‌های کلاس‌ها
.PP
نام کلاس با افزودن نام محلی به نام منبع، با جداکننده خط زیر (underscore) تعیین می‌شود. گزینهٔ \fB\-d\fR اجباری است. کلاس درون دایرکتوری مشخص‌شده نوشته می‌شود.
.SS "محل فایل خروجی در حالت C#:"
.TP
\fB\-r\fR, \fB\-\-resource\fR=\fI\,RESOURCE\/\fR
نام منبع (resource)
.TP
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR
نام محلی (locale)، به‌صورت زبان یا زبان_کشور
.TP
\fB\-d\fR DIRECTORY
دایرکتوری پایه برای فایل‌های .dll وابسته به محلی
.PP
گزینه‌های \fB\-l\fR و \fB\-d\fR اجباری هستند. فایل .dll درون یک زیردایرکتوری از دایرکتوری مشخص‌شده نوشته می‌شود که نام آن بستگی به محلی دارد.
.SS "محل فایل خروجی در حالت Tcl:"
.TP
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR
نام محلی (locale)، به‌صورت زبان یا زبان_کشور
.TP
\fB\-d\fR DIRECTORY
دایرکتوری پایه برای کاتالوگ‌های پیام .msg
.PP
گزینه‌های \fB\-l\fR و \fB\-d\fR اجباری هستند. فایل .msg درون دایرکتوری مشخص‌شده نوشته می‌شود.
.SS "گزینه‌های حالت Desktop Entry:"
.TP
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR
نام محلی (locale)، به‌صورت زبان یا زبان_کشور
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
نوشتن خروجی در فایل مشخص‌شده
.TP
\fB\-\-template\fR=\fI\,TEMPLATE\/\fR
یک فایل .desktop که به‌عنوان الگو استفاده می‌شود
.TP
\fB\-d\fR DIRECTORY
دایرکتوری پایه برای فایل‌های .po
.TP
\fB\-kWORD\fR, \fB\-\-keyword\fR=\fI\,WORD\/\fR
جستجوی \fIWORD\fR به‌عنوان یک کلیدواژه اضافی
.TP
\fB\-k\fR, \fB\-\-keyword\fR
عدم استفاده از کلیدواژه‌های پیش‌فرض
.PP
گزینه‌های \fB\-l\fR، \fB\-o\fR و \fB\-\-template\fR اجباری هستند. اگر \fB\-D\fR مشخص شود، فایل‌های ورودی به‌جای آرگومان‌های خط فرمان از دایرکتوری خوانده می‌شوند.
.SS "گزینه‌های حالت XML:"
.TP
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR
نام محلی (locale)، به‌صورت زبان یا زبان_کشور
.TP
\fB\-L\fR, \fB\-\-language\fR=\fI\,NAME\/\fR
شناسایی زبان XML مشخص‌شده
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
نوشتن خروجی در فایل مشخص‌شده
.TP
\fB\-\-template\fR=\fI\,TEMPLATE\/\fR
یک فایل XML که به‌عنوان الگو استفاده می‌شود
.TP
\fB\-d\fR DIRECTORY
دایرکتوری پایه برای فایل‌های .po
.TP
\fB\-\-replace\-text\fR
تولید خروجی XML با متن ترجمه‌شده به‌جای متن اصلی، نه الحاق به متن اصلی
.PP
گزینه‌های \fB\-l\fR، \fB\-o\fR و \fB\-\-template\fR اجباری هستند. اگر \fB\-D\fR مشخص شود، فایل‌های ورودی به‌جای آرگومان‌های خط فرمان از دایرکتوری خوانده می‌شوند.
.SS "نحو فایل ورودی:"
.TP
\fB\-P\fR, \fB\-\-properties\-input\fR
فایل‌های ورودی در نحو .properties جاوا هستند
.TP
\fB\-\-stringtable\-input\fR
فایل‌های ورودی در نحو .strings مربوط به NeXTstep/GNUstep هستند
.SS "تفسیر فایل ورودی:"
.TP
\fB\-c\fR, \fB\-\-check\fR
انجام تمام بررسی‌های تعیین‌شده توسط
\fB\-\-check\-format\fR، \fB\-\-check\-header\fR و \fB\-\-check\-domain\fR
.TP
\fB\-\-check\-format\fR
بررسی رشته‌های قالب وابسته به زبان
.TP
\fB\-\-check\-header\fR
بررسی وجود و محتویات مدخل سرایند
.TP
\fB\-\-check\-domain\fR
بررسی تداخل میان دستورالعمل‌های domain و گزینهٔ \fB\-\-output\-file\fR
.TP
\fB\-C\fR, \fB\-\-check\-compatibility\fR
بررسی رفتار مطابق با msgfmt استاندارد X/Open
.TP
\fB\-\-check\-accelerators\fR[=\fI\,CHAR\/\fR]
بررسی وجود شتاب‌دهنده‌های صفحه‌کلید برای موارد منو
.TP
\fB\-f\fR, \fB\-\-use\-fuzzy\fR
استفاده از مدخل‌های فازی (fuzzy) در خروجی
.SS "جزئیات خروجی:"
.TP
\fB\-\-no\-convert\fR
عدم تبدیل پیام‌ها به کدگذاری UTF\-8
.TP
\fB\-\-no\-redundancy\fR
عدم بسط اولیه ماکروهای دستورالعمل رشته قالب ISO C 99 <inttypes.h>
.TP
\fB\-a\fR, \fB\-\-alignment\fR=\fI\,NUMBER\/\fR
تراز کردن رشته‌ها روی \fINUMBER\fR بایت (پیش‌فرض: 1)
.TP
\fB\-\-endianness\fR=\fI\,BYTEORDER\/\fR
نوشتن اعداد ۳۲ بیتی با ترتیب بایت مشخص‌شده (big یا little؛ پیش‌فرض به پلتفرم بستگی دارد)
.TP
\fB\-\-no\-hash\fR
فایل باینری شامل جدول هش (hash table) نخواهد بود
.SS "خروجی اطلاعاتی:"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.TP
\fB\-\-statistics\fR
چاپ آمار مربوط به ترجمه‌ها
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات خروجی
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Ulrich Drepper، Bruno Haible و Daiki Ueno.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی <https://savannah.gnu.org/projects/gettext>
یا از طریق ایمیل به <bug\-gettext@gnu.org>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 1995\-2026 Free Software Foundation, Inc.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>
.br
این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B msgfmt
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B msgfmt
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info msgfmt
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.