| XGETTEXT(1) | دستورات کاربر | XGETTEXT(1) |
نام (NAME)
xgettext - استخراج رشتههای قابل ترجمه از کدهای منبع
خلاصه دستور (SYNOPSIS)
xgettext [گزینه]... [فایل_ورودی]...
توضیحات (DESCRIPTION)
استخراج رشتههای قابل ترجمه از فایلهای ورودی مشخصشده.
آرگومانهای اجباری برای گزینههای طولانی، برای گزینههای کوتاه نیز اجباری هستند. همین امر برای آرگومانهای اختیاری نیز صدق میکند.
محل فایل ورودی:
- INPUTFILE ...
- فایلهای ورودی
- -f, --files-from=FILE
- دریافت فهرست فایلهای ورودی از FILE
- -D, --directory=DIRECTORY
- افزودن DIRECTORY به فهرست جستجوی فایلهای ورودی
اگر فایل ورودی - باشد، ورودی استاندارد خوانده میشود.
محل فایل خروجی:
- -d, --default-domain=NAME
- استفاده از NAME.po برای خروجی (به جای messages.po)
- -o, --output=FILE
- نوشتن خروجی در فایل مشخصشده
- -p, --output-dir=DIR
- فایلهای خروجی در دایرکتوری DIR قرار خواهند گرفت
اگر فایل خروجی - باشد، خروجی در خروجی استاندارد نوشته میشود.
انتخاب زبان فایل ورودی:
- -L, --language=NAME
- تشخیص زبان مشخصشده (C, C++, ObjectiveC, PO, Python, Java, JavaProperties, C#, JavaScript, TypeScript, TSX, Scheme, Guile, Lisp, EmacsLisp, librep, Rust, Go, Ruby, Shell, awk, Lua, Modula-2, D, OCaml, Smalltalk, Vala, Tcl, Perl, PHP, GCC-source, YCP, NXStringTable, RST, RSJ, Glade, GSettings, Desktop)
- -C, --c++
- کوتاهشدهٔ --language=C++
بهطور پیشفرض زبان فایل بر اساس پسوند نام فایل ورودی حدس زده میشود.
تفسیر فایل ورودی:
- --from-code=NAME
- کدگذاری فایلهای ورودی (بهجز Python، Tcl و Glade)
بهطور پیشفرض فرض میشود که فایلهای ورودی با کدگذاری ASCII هستند.
حالت عملیات:
- -j, --join-existing
- ادغام پیامها با فایل موجود
- -x, --exclude-file=FILE.po
- مدخلهای موجود در FILE.po استخراج نمیشوند
- -cTAG, --add-comments=TAG
- قرار دادن بلوکهای توضیح (کامنت) آغازشده با TAG که پیش از خطوط کلمات کلیدی آمدهاند در فایل خروجی
- -c, --add-comments
- قرار دادن تمام بلوکهای توضیح که پیش از خطوط کلمات کلیدی آمدهاند در فایل خروجی
- --check=NAME
- انجام بررسی نحو روی پیامها (ellipsis-unicode, space-ellipsis,
- quote-unicode, bullet-unicode)
- --no-check=NAME
- عدم انجام بررسی نحو روی پیامها (url, email)
- --sentence-end=TYPE
- نوع مشخصکنندهٔ پایان جمله (single-space، که حالت پیشفرض است،
- یا double-space)
گزینههای ویژهٔ زبان:
- -a, --extract-all
- استخراج تمام رشتهها (فقط برای زبانهای C, C++, ObjectiveC, Python, Java, C#, JavaScript, TypeScript, TSX, Scheme, Guile, Lisp, EmacsLisp, librep, Rust, Go, Shell, awk, Lua, Modula-2, D, OCaml, Vala, Tcl, Perl, PHP, GCC-source, Glade, GSettings)
- -kWORD, --keyword=WORD
- جستجو برای WORD بهعنوان کلمه کلیدی اضافی
- -k, --keyword
- عدم استفاده از کلمات کلیدی پیشفرض (فقط برای زبانهای C, C++, ObjectiveC, Python, Java, C#, JavaScript, TypeScript, TSX, Scheme, Guile, Lisp, EmacsLisp, librep, Rust, Go, Shell, awk, Lua, Modula-2, D, OCaml, Vala, Tcl, Perl, PHP, GCC-source, Glade, GSettings, Desktop)
- --flag=WORD:ARG:FLAG
- فلگ اضافی برای رشتههای داخل آرگومان شمارهٔ ARG از کلمه کلیدی WORD
- (فقط برای زبانهای C, C++, ObjectiveC, Python,
- Java, C#, JavaScript, TypeScript, TSX, Scheme, Guile, Lisp, EmacsLisp, librep, Rust, Go, Shell, awk, Lua, Modula-2, D, OCaml, Vala, Tcl, Perl, PHP, GCC-source, YCP)
- --tag=WORD:FORMAT
- تعریف رفتار الگوهای رشتهای نشانهگذاریشده (tagged template literals) با برچسب WORD
- (فقط برای زبان JavaScript)
- -T, --trigraphs
- درک سهنویسهایهای (trigraphs) استاندارد ANSI C برای ورودی (منسوخشده؛ فقط برای زبانهای C, C++, ObjectiveC)
- --its=FILE
- اعمال قواعد ITS از FILE (فقط برای زبانهای مبتنی بر XML)
- --qt
- شناسایی رشتههای قالب Qt (فقط برای زبان C++)
- --kde
- شناسایی رشتههای قالب KDE 4 (فقط برای زبان C++)
- --boost
- شناسایی رشتههای قالب Boost (فقط برای زبان C++)
- --debug
- نتایج شناسایی دقیقتر رشتههای قالب (formatstring)
جزئیات خروجی:
- --color
- استفاده همیشگی از رنگها و سایر ویژگیهای متنی
- --color=WHEN
- استفاده از رنگها و سایر ویژگیهای متنی طبق WHEN؛ مقادیر مجاز برای WHEN عبارتند از 'always'، 'never'، 'auto' یا 'html'
- --style=STYLEFILE
- مشخص کردن فایل قواعد سبک CSS برای --color
- -e, --no-escape
- عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیشفرض)
- -E, --escape
- استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترشیافته
- --force-po
- نوشتن فایل PO حتی در صورت خالی بودن
- -i, --indent
- نوشتن فایل .po با سبک تورفتگی (indent)
- --no-location
- عدم نوشتن خطوط '#: filename:line'
- -n, --add-location
- تولید خطوط '#: filename:line' (پیشفرض)
- --strict
- نوشتن فایل .po سازگار و دقیق با استاندارد Uniforum
- --properties-output
- نوشتن یک فایل .properties جاوا در خروجی
- --stringtable-output
- نوشتن یک فایل .strings مربوط به NeXTstep/GNUstep در خروجی
- --itstool
- نوشتن توضیحات itstool
- -w, --width=NUMBER
- تنظیم عرض صفحه خروجی
- --no-wrap
- نشکستن خطوط پیامهای طولانی (طولانیتر از عرض صفحه خروجی) به چند خط
- -s, --sort-output
- تولید خروجی مرتبشده (منسوخشده)
- -F, --sort-by-file
- مرتبسازی خروجی بر اساس محل فایل
- --omit-header
- عدم نوشتن سرایند با مدخل 'msgid ""'
- --no-git
- عدم استفاده از برنامه git برای تولید فیلد بازتولیدپذیر 'POT-Creation-Date' در خروجی
- --copyright-holder=STRING
- تنظیم دارنده حق نشر در خروجی
- --foreign-user
- حذف حق نشر FSF در خروجی برای کاربر خارجی
- --package-name=PACKAGE
- تنظیم نام بسته در خروجی
- --package-version=VERSION
- تنظیم نسخه بسته در خروجی
- --msgid-bugs-address=EMAIL@ADDRESS
- تنظیم نشانی گزارش برای باگهای msgid
- --generated=FILE
- اعلام اینکه FILE دادهشده تولیدشده است و بنابراین نباید تأثیری بر فیلد 'POT-Creation-Date' در خروجی داشته باشد
- --reference=FILE
- اعلام اینکه خروجی به محتویات FILE دادهشده بستگی دارد؛ این امر بر فیلد 'POT-Creation-Date' در خروجی تأثیر میگذارد
- -m[STRING], --msgstr-prefix[=STRING]
- استفاده از STRING یا "" بهعنوان پیشوند برای مقادیر msgstr
- -M[STRING], --msgstr-suffix[=STRING]
- استفاده از STRING یا "" بهعنوان پسوند برای مقادیر msgstr
خروجی اطلاعاتی:
- -h, --help
- نمایش این راهنما و خروج
- -V, --version
- نمایش اطلاعات نسخه و خروج
- -v, --verbose
- افزایش سطح جزئیات خروجی
نویسندگان (AUTHORS)
نوشتهشده توسط Ulrich Drepper و 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)
مستندات کامل برای xgettext بهصورت یک راهنمای Texinfo نگهداری میشود. اگر برنامههای info و xgettext بهدرستی روی سیستم شما نصب شده باشند، دستور
- info xgettext
باید دسترسی شما به راهنمای کامل را فراهم کند.
| January 2026 | GNU gettext-tools 1.0 |