.TH MSGEN 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر"
.SH "نام (NAME)"
msgen \- ایجاد کاتالوگ پیام انگلیسی
.SH "خلاصه دستور (SYNOPSIS)"
.B msgen
[\fI\,گزینه\/\fR] \fI\,فایل_ورودی\/\fR
.SH "توضیحات (DESCRIPTION)"
.PP
یک کاتالوگ ترجمه انگلیسی ایجاد می‌کند. فایل ورودی آخرین فایل PO انگلیسی ایجادشده، یا یک فایل الگوی PO (عموماً ایجادشده توسط xgettext) است. به مدخل‌های ترجمه‌نشده، ترجمه‌ای اختصاص داده می‌شود که دقیقاً مشابه msgid است.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.SS "محل فایل ورودی:"
.TP
INPUTFILE
فایل ورودی PO یا POT
.TP
\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
افزودن \fIDIRECTORY\fR به فهرست جستجوی فایل‌های ورودی
.PP
اگر فایل ورودی \- باشد، ورودی استاندارد خوانده می‌شود.
.SS "محل فایل خروجی:"
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
نوشتن خروجی در فایل مشخص‌شده
.PP
اگر فایل خروجی تعیین نشود یا \- باشد، نتایج در خروجی استاندارد نوشته می‌شوند.
.SS "نحو فایل ورودی:"
.TP
\fB\-P\fR, \fB\-\-properties\-input\fR
فایل ورودی در نحو .properties جاوا است
.TP
\fB\-\-stringtable\-input\fR
فایل ورودی در نحو .strings مربوط به NeXTstep/GNUstep است
.SS "جزئیات خروجی:"
.TP
\fB\-\-lang\fR=\fI\,CATALOGNAME\/\fR
تنظیم فیلد 'Language' در مدخل سرایند
.TP
\fB\-\-color\fR
استفاده همیشگی از رنگ‌ها و سایر ویژگی‌های متنی
.TP
\fB\-\-color\fR=\fI\,WHEN\/\fR
استفاده از رنگ‌ها و سایر ویژگی‌های متنی طبق \fIWHEN\fR؛ مقادیر مجاز برای WHEN عبارتند از 'always'، 'never'، 'auto' یا 'html'
.TP
\fB\-\-style\fR=\fI\,STYLEFILE\/\fR
مشخص کردن فایل قواعد سبک CSS برای \fB\-\-color\fR
.TP
\fB\-e\fR, \fB\-\-no\-escape\fR
عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیش‌فرض)
.TP
\fB\-E\fR, \fB\-\-escape\fR
استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترش‌یافته
.TP
\fB\-\-force\-po\fR
نوشتن فایل PO حتی در صورت خالی بودن
.TP
\fB\-i\fR, \fB\-\-indent\fR
سبک خروجی دارای تورفتگی (indent)
.TP
\fB\-\-no\-location\fR
عدم درج خطوط '#: filename:line'
.TP
\fB\-n\fR, \fB\-\-add\-location\fR
حفظ خطوط '#: filename:line' (پیش‌فرض)
.TP
\fB\-\-strict\fR
سبک خروجی دقیق و سازگار با Uniforum
.TP
\fB\-p\fR, \fB\-\-properties\-output\fR
نوشتن یک فایل .properties جاوا در خروجی
.TP
\fB\-\-stringtable\-output\fR
نوشتن یک فایل .strings مربوط به NeXTstep/GNUstep در خروجی
.TP
\fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR
تنظیم عرض صفحه خروجی
.TP
\fB\-\-no\-wrap\fR
نشکستن خطوط پیام‌های طولانی (طولانی‌تر از عرض صفحه خروجی) به چند خط
.TP
\fB\-s\fR, \fB\-\-sort\-output\fR
تولید خروجی مرتب‌شده
.TP
\fB\-F\fR, \fB\-\-sort\-by\-file\fR
مرتب‌سازی خروجی بر اساس محل فایل
.SS "خروجی اطلاعاتی:"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Bruno Haible.
.SH "گزارش باگها (REPORTING BUGS)"
گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی <https://savannah.gnu.org/projects/gettext>
یا از طریق ایمیل به <bug\-gettext@gnu.org>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2001\-2026 Free Software Foundation, Inc.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>
.br
این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B msgen
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B msgen
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info msgen
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.