MSGMERGE(1) دستورات کاربر MSGMERGE(1)

msgmerge - ادغام کاتالوگ پیام و فایل الگو

msgmerge [گزینه] def.po ref.pot

دو فایل .po به سبک Uniforum را با یکدیگر ادغام می‌کند. فایل def.po یک فایل PO موجود با ترجمه‌ها است که تا زمانی که هنوز همخوانی داشته باشند، به فایل تازه ایجادشده منتقل می‌شوند؛ توضیحات (کامنت‌ها) حفظ خواهند شد، اما توضیحات استخراج‌شده و موقعیت فایل‌ها نادیده گرفته می‌شوند. فایل ref.pot آخرین فایل PO ایجادشده با ارجاعات منبع به‌روزشده اما ترجمه‌های قدیمی است، یا یک فایل الگوی PO (معمولاً ایجادشده توسط xgettext)؛ هرگونه ترجمه یا توضیح در این فایل دور ریخته می‌شود، با این حال توضیحات نقطه‌دار (dot comments) و موقعیت فایل‌ها حفظ خواهند شد. در جاهایی که تطابق دقیقی یافت نشود، از تطبیق فازی (fuzzy matching) برای ایجاد نتایج بهتر استفاده می‌شود.

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.

ترجمه‌های مرتبط با منابع قدیمی
ارجاعات به منابع جدید
افزودن DIRECTORY به فهرست جستجوی فایل‌های ورودی
کتابخانه اضافی از ترجمه‌های پیام؛ می‌تواند بیش از یک بار مشخص شود

به‌روزرسانی def.po؛ در صورتی که def.po از قبل به‌روز باشد کاری انجام نمی‌دهد

نوشتن خروجی در فایل مشخص‌شده

اگر فایل خروجی مشخص نشود یا - باشد، نتایج در خروجی استاندارد نوشته می‌شوند.

محل فایل خروجی در حالت به‌روزرسانی (update): نتیجه در همان فایل def.po بازنویسی می‌شود.

تهیه یک نسخه پشتیبان از def.po
بازنویسی پسوند معمول پشتیبان

روش کنترل نسخه ممکن است از طریق گزینهٔ --backup یا از طریق متغیر محیطی VERSION_CONTROL انتخاب شود. مقادیر مجاز عبارتند از:

هرگز نسخه پشتیبان تهیه نشود (حتی اگر --backup داده شده باشد)
ایجاد نسخه‌های پشتیبان شماره‌دار
اگر نسخه‌های شماره‌دار وجود داشته باشند شماره‌دار، در غیر این صورت ساده
همیشه نسخه‌های پشتیبان ساده ایجاد شود

پسوند پشتیبان '~' است، مگر اینکه با --suffix یا متغیر محیطی SIMPLE_BACKUP_SUFFIX تنظیم شده باشد.

اعمال ref.pot به هر یک از دامنه‌ها در def.po
تولید خروجی برای 'msgfmt'، نه برای مترجم
عدم استفاده از تطبیق فازی
حفظ msgidهای قبلی پیام‌های ترجمه‌شده

فایل‌های ورودی در نحو .properties جاوا هستند
فایل‌های ورودی در نحو .strings مربوط به NeXTstep/GNUstep هستند

تنظیم فیلد 'Language' در مدخل سرایند
استفاده همیشگی از رنگ‌ها و سایر ویژگی‌های متنی
استفاده از رنگ‌ها و سایر ویژگی‌های متنی طبق WHEN. مقدار WHEN می‌تواند 'always'، 'never'، 'auto' یا 'html' باشد.
مشخص کردن فایل شیوه‌نامه (style rule) سی‌اس‌اس برای --color
عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیش‌فرض)
استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترش‌یافته
نوشتن فایل PO حتی در صورت خالی بودن
سبک خروجی با تورفتگی (indent)
حذف خطوط '#: filename:line'
حفظ خطوط '#: filename:line' (پیش‌فرض)
سبک خروجی دقیق و سازگار با Uniforum
نوشتن یک فایل .properties جاوا
نوشتن یک فایل .strings مربوط به NeXTstep/GNUstep
تنظیم عرض صفحه خروجی
نشکستن خطوط پیام‌های طولانی (طولانی‌تر از عرض صفحه خروجی) به چند خط
تولید خروجی مرتب‌شده (منسوخ‌شده)
مرتب‌سازی خروجی بر اساس محل فایل

نمایش این راهنما و خروج
نمایش اطلاعات نسخه و خروج
افزایش سطح پرگویی (verbosity)
فرونشاندن نشانگرهای پیشرفت

نوشته‌شده توسط Peter Miller و Bruno Haible.

گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی https://savannah.gnu.org/projects/gettext یا از طریق ایمیل به <bug-gettext@gnu.org>.

حق نشر © 1995-2026 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html
این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.

مستندات کامل برای msgmerge به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و msgmerge به‌درستی روی سیستم شما نصب شده باشند، دستور

info msgmerge

باید دسترسی شما به راهنمای کامل را فراهم کند.

January 2026 GNU gettext-tools 1.0