.TH MSGCONV 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر"
.SH "نام (NAME)"
msgconv \- تبدیل کدبندی نویسه‌ها برای کاتالوگ پیام
.SH "خلاصه دستور (SYNOPSIS)"
.B msgconv
[\fI\,گزینه\/\fR] [\fI\,فایل_ورودی\/\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
یک کاتالوگ ترجمه را به یک کدبندی نویسهٔ دیگر تبدیل می‌کند.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.SS "محل فایل ورودی:"
.TP
\fIINPUTFILE\fR
فایل PO ورودی
.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\-t\fR, \fB\-\-to\-code\fR=\fI\,NAME\/\fR
کدبندی برای خروجی
.PP
کدبندی پیش‌فرض، کدبندی لوکال فعلی است.
.SS "نحو فایل ورودی:"
.TP
\fB\-P\fR, \fB\-\-properties\-input\fR
فایل ورودی در نحو .properties جاوا است
.TP
\fB\-\-stringtable\-input\fR
فایل ورودی در نحو .strings مربوط به NeXTstep/GNUstep است
.SS "جزئیات خروجی:"
.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 msgconv
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B msgconv
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info msgconv
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.