| MSGMERGE(1) | دستورات کاربر | MSGMERGE(1) |
نام (NAME)
msgmerge - ادغام کاتالوگ پیام و فایل الگو
خلاصه دستور (SYNOPSIS)
msgmerge [گزینه] def.po ref.pot
توضیحات (DESCRIPTION)
دو فایل .po به سبک Uniforum را با یکدیگر ادغام میکند. فایل def.po یک فایل PO موجود با ترجمهها است که تا زمانی که هنوز همخوانی داشته باشند، به فایل تازه ایجادشده منتقل میشوند؛ توضیحات (کامنتها) حفظ خواهند شد، اما توضیحات استخراجشده و موقعیت فایلها نادیده گرفته میشوند. فایل ref.pot آخرین فایل PO ایجادشده با ارجاعات منبع بهروزشده اما ترجمههای قدیمی است، یا یک فایل الگوی PO (معمولاً ایجادشده توسط xgettext)؛ هرگونه ترجمه یا توضیح در این فایل دور ریخته میشود، با این حال توضیحات نقطهدار (dot comments) و موقعیت فایلها حفظ خواهند شد. در جاهایی که تطابق دقیقی یافت نشود، از تطبیق فازی (fuzzy matching) برای ایجاد نتایج بهتر استفاده میشود.
آرگومانهای اجباری برای گزینههای طولانی، برای گزینههای کوتاه نیز اجباری هستند.
محل فایل ورودی:
- def.po
- ترجمههای مرتبط با منابع قدیمی
- ref.pot
- ارجاعات به منابع جدید
- -D, --directory=DIRECTORY
- افزودن DIRECTORY به فهرست جستجوی فایلهای ورودی
- -C, --compendium=FILE
- کتابخانه اضافی از ترجمههای پیام؛ میتواند بیش از یک بار مشخص شود
حالت عملیات:
- -U, --update
- بهروزرسانی def.po؛ در صورتی که def.po از قبل بهروز باشد کاری انجام نمیدهد
محل فایل خروجی:
- -o, --output-file=FILE
- نوشتن خروجی در فایل مشخصشده
اگر فایل خروجی مشخص نشود یا - باشد، نتایج در خروجی استاندارد نوشته میشوند.
محل فایل خروجی در حالت بهروزرسانی (update): نتیجه در همان فایل def.po بازنویسی میشود.
- --backup=CONTROL
- تهیه یک نسخه پشتیبان از def.po
- --suffix=SUFFIX
- بازنویسی پسوند معمول پشتیبان
روش کنترل نسخه ممکن است از طریق گزینهٔ --backup یا از طریق متغیر محیطی VERSION_CONTROL انتخاب شود. مقادیر مجاز عبارتند از:
- none, off
- هرگز نسخه پشتیبان تهیه نشود (حتی اگر --backup داده شده باشد)
- numbered, t
- ایجاد نسخههای پشتیبان شمارهدار
- existing, nil
- اگر نسخههای شمارهدار وجود داشته باشند شمارهدار، در غیر این صورت ساده
- simple, never
- همیشه نسخههای پشتیبان ساده ایجاد شود
پسوند پشتیبان '~' است، مگر اینکه با --suffix یا متغیر محیطی SIMPLE_BACKUP_SUFFIX تنظیم شده باشد.
تغییردهندههای عملیات:
- -m, --multi-domain
- اعمال ref.pot به هر یک از دامنهها در def.po
- --for-msgfmt
- تولید خروجی برای 'msgfmt'، نه برای مترجم
- -N, --no-fuzzy-matching
- عدم استفاده از تطبیق فازی
- --previous
- حفظ msgidهای قبلی پیامهای ترجمهشده
نحو فایل ورودی:
- -P, --properties-input
- فایلهای ورودی در نحو .properties جاوا هستند
- --stringtable-input
- فایلهای ورودی در نحو .strings مربوط به NeXTstep/GNUstep هستند
جزئیات خروجی:
- --lang=CATALOGNAME
- تنظیم فیلد 'Language' در مدخل سرایند
- --color
- استفاده همیشگی از رنگها و سایر ویژگیهای متنی
- --color=WHEN
- استفاده از رنگها و سایر ویژگیهای متنی طبق WHEN. مقدار WHEN میتواند 'always'، 'never'، 'auto' یا 'html' باشد.
- --style=STYLEFILE
- مشخص کردن فایل شیوهنامه (style rule) سیاساس برای --color
- -e, --no-escape
- عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیشفرض)
- -E, --escape
- استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترشیافته
- --force-po
- نوشتن فایل PO حتی در صورت خالی بودن
- -i, --indent
- سبک خروجی با تورفتگی (indent)
- --no-location
- حذف خطوط '#: filename:line'
- -n, --add-location
- حفظ خطوط '#: filename:line' (پیشفرض)
- --strict
- سبک خروجی دقیق و سازگار با Uniforum
- -p, --properties-output
- نوشتن یک فایل .properties جاوا
- --stringtable-output
- نوشتن یک فایل .strings مربوط به NeXTstep/GNUstep
- -w, --width=NUMBER
- تنظیم عرض صفحه خروجی
- --no-wrap
- نشکستن خطوط پیامهای طولانی (طولانیتر از عرض صفحه خروجی) به چند خط
- -s, --sort-output
- تولید خروجی مرتبشده (منسوخشده)
- -F, --sort-by-file
- مرتبسازی خروجی بر اساس محل فایل
خروجی اطلاعاتی:
- -h, --help
- نمایش این راهنما و خروج
- -V, --version
- نمایش اطلاعات نسخه و خروج
- -v, --verbose
- افزایش سطح پرگویی (verbosity)
- -q, --quiet, --silent
- فرونشاندن نشانگرهای پیشرفت
نویسنده (AUTHOR)
نوشتهشده توسط Peter Miller و Bruno Haible.
گزارش باگها (REPORTING BUGS)
گزارش باگها در سامانه ردیابی اشکالات به نشانی https://savannah.gnu.org/projects/gettext یا از طریق ایمیل به <bug-gettext@gnu.org>.
حق نشر (COPYRIGHT)
حق نشر © 1995-2026 Free
Software Foundation, Inc.
مجوز GPLv3+: گنو GPL
نسخه ۳ یا
بالاتر
https://gnu.org/licenses/gpl.html
این یک
نرمافزار
آزاد است:
شما در
ویرایش و
بازتوزیع
آن آزاد
هستید. هیچ
ضمانتی
وجود
ندارد، تا
حدی که
قانون مجاز
میداند.
همچنین ببینید (SEE ALSO)
مستندات کامل برای msgmerge بهصورت یک راهنمای Texinfo نگهداری میشود. اگر برنامههای info و msgmerge بهدرستی روی سیستم شما نصب شده باشند، دستور
- info msgmerge
باید دسترسی شما به راهنمای کامل را فراهم کند.
| January 2026 | GNU gettext-tools 1.0 |