نام (NAME)

intltool-update - به‌روزرسانی پرونده قالب PO و ادغام ترجمه‌ها با آن

خلاصه دستور (SYNOPSIS)

intltool-update [گزینه‌ها]...
intltool-update LANGCODE

دستور intltool-update قالب‌های جدید پرونده po را از کد منبع تولید کرده و ترجمه‌های موجود را با این قالب‌های جدید po ادغام می‌کند.

پیش از اجرای intltool-update، باید دایرکتوری کاری را به زیردایرکتوری حاوی ترجمه‌ها (معمولاً "po/") تغییر دهید.

هنگام اجرای intltool-update، در هر نوبت تنها استفاده از یک حالت عملکرد مجاز است.

-p
--pot: تنها تولید قالب po (با پسوند ‎.pot).
-s
--headers: اجرای intltool-extract(8) جهت استخراج رشته‌های درون پرونده‌های با سبک XML/INI فهرست‌شده در POTFILES.in، و نوشتن رشته‌های استخراج‌شده در پرونده‌های سرآیند (header)، به‌گونه‌ای که این رشته‌ها توسط xgettext(1) قابل شناسایی باشند.
-m
--maintain: جستجو برای پرونده‌های جاافتاده‌ای که باید در POTFILES.in یا POTFILES.skip فهرست می‌شدند. فهرستی از تمام این پرونده‌ها در پرونده دیگری به نام "missing" نوشته می‌شود.
-r
--report: نمایش گزارش وضعیت برای تمام ترجمه‌های موجود در نرم‌افزار.
-d LANGCODE
--dist LANGCODE: ادغام LANGCODE.po با قالب PO موجود.

-g NAME
--gettext-package=NAME: مشخص کردن دستی نام پرونده قالب PO، به‌جای تعیین خودکار نام از روی کد منبع. این گزینه همراه با گزینه -p/--pot کاربرد دارد. همچنین یک اثر جانبی دیگر نیز دارد: نام دایرکتوری کاری فعلی دیگر به "po" یا "po-*" محدود نخواهد بود.
-o FILENAME
--output-file=FILENAME: مشخص کردن دستی نام پرونده خروجی (FILENAME) پس از ادغام ترجمه قدیمی با قالب PO. چه همراه با گزینه -d/--dist و چه بدون هیچ گزینه‌ای مفید است.
-x
--verbose: نمایش بازخوردها و جزئیات فراوان در خروجی.
--version: نمایش اطلاعات نسخه.
--help: نمایش نحوه استفاده و اطلاعات راهنمای پایه.

تولید یک قالب PO جدید از روی کد منبع و نام‌گذاری آن به foo.pot:

intltool-update --pot --gettext-package=foo

به‌روزرسانی پرونده ترجمه xy.po با استفاده از قالب po موجود به نام "bar.pot" و نوشتن خروجی در "xy1.po":

intltool-update --dist --gettext-package=bar --output-file=xy1.po xy

تولید قالب PO جدید و به‌روزرسانی پرونده ترجمه xy.po (پرونده xy.po با محتوای جدید بازنویسی می‌شود):

intltool-update xy

(معادل با intltool-update --pot && intltool-update --dist xy)

po/POTFILES.in: شامل فهرستی از پرونده‌های منبع که حاوی رشته‌های قابل ترجمه هستند، یک پرونده در هر خط.
po/POTFILES.skip
po/POTFILES.ignore (منسوخ): شامل فهرستی از پرونده‌های منبع که هنگام جستجو برای رشته‌های قابل ترجمه باید نادیده گرفته شوند.

Darin Adler <darin@bentspoon.com>
Kenneth Christiansen <kenneth@gnu.org>
Maciej Stachowiak <mjs@eazel.com>