.TH MSGFILTER 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر"
.SH "نام (NAME)"
msgfilter \- اعمال فیلتر و دستور روی ترجمههای کاتالوگ پیام
.SH "خلاصه دستور (SYNOPSIS)"
.B msgfilter
[\fI\,گزینه\/\fR] \fI\,فیلتر\/\fR [\fI\,گزینه_فیلتر\/\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
یک فیلتر را روی تمامی ترجمه‌های یک کاتالوگ ترجمه اعمال می‌کند.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.SS "محل فایل ورودی:"
.TP
\fB\-i\fR, \fB\-\-input\fR=\fI\,INPUTFILE\/\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
اگر هیچ فایل خروجی مشخص نشود یا \- باشد، نتایج در خروجی استاندارد نوشته می‌شوند.
.PP
\fIFILTER\fR می‌تواند هر برنامه‌ای باشد که یک ترجمه را از ورودی استاندارد می‌خواند و ترجمهٔ تغییریافته را در خروجی استاندارد می‌نویسد.
.SS "ورودی و خروجی فیلتر:"
.TP
\fB\-\-newline\fR
افزودن یک خط جدید به انتهای ورودی و حذف یک خط جدید از انتهای خروجی
.SS "گزینه‌های مفید فیلتر هنگامی که فیلتر 'sed' است:"
.TP
\fB\-e\fR, \fB\-\-expression\fR=\fI\,SCRIPT\/\fR
افزودن \fISCRIPT\fR به دستوراتی که باید اجرا شوند
.TP
\fB\-f\fR, \fB\-\-file\fR=\fI\,SCRIPTFILE\/\fR
افزودن محتویات \fISCRIPTFILE\fR به دستوراتی که باید اجرا شوند
.TP
\fB\-n\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
جلوگیری از چاپ خودکار فضای الگو (pattern space)
.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\-\-no\-escape\fR
عدم استفاده از کاراکترهای اسکیپ C در خروجی (پیش‌فرض)
.TP
\fB\-E\fR, \fB\-\-escape\fR
استفاده از کاراکترهای اسکیپ C در خروجی، بدون کاراکترهای گسترش‌یافته
.TP
\fB\-\-force\-po\fR
نوشتن فایل PO حتی اگر خالی باشد
.TP
\fB\-\-indent\fR
سبک خروجی با تورفتگی
.TP
\fB\-\-keep\-header\fR
دست‌نخورده نگه‌داشتن مدخل سرایند و فیلتر نکردن آن
.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 msgfilter
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B msgfilter
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info msgfilter
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.