.TH XGETTEXT 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر" .SH "نام (NAME)" xgettext \- استخراج رشتههای قابل ترجمه از کدهای منبع .SH "خلاصه دستور (SYNOPSIS)" .B xgettext [\fI\,گزینه\/\fR]... [\fI\,فایل_ورودی\/\fR]... .SH "توضیحات (DESCRIPTION)" .PP استخراج رشته‌های قابل ترجمه از فایل‌های ورودی مشخص‌شده. .PP آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند. همین امر برای آرگومان‌های اختیاری نیز صدق می‌کند. .SS "محل فایل ورودی:" .TP \fIINPUTFILE\fR ... فایل‌های ورودی .TP \fB\-f\fR, \fB\-\-files\-from\fR=\fI\,FILE\/\fR دریافت فهرست فایل‌های ورودی از \fIFILE\fR .TP \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR افزودن \fIDIRECTORY\fR به فهرست جستجوی فایل‌های ورودی .PP اگر فایل ورودی \- باشد، ورودی استاندارد خوانده می‌شود. .SS "محل فایل خروجی:" .TP \fB\-d\fR, \fB\-\-default\-domain\fR=\fI\,NAME\/\fR استفاده از \fINAME.po\fR برای خروجی (به جای \fImessages.po\fR) .TP \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR نوشتن خروجی در فایل مشخص‌شده .TP \fB\-p\fR, \fB\-\-output\-dir\fR=\fI\,DIR\/\fR فایل‌های خروجی در دایرکتوری \fIDIR\fR قرار خواهند گرفت .PP اگر فایل خروجی \- باشد، خروجی در خروجی استاندارد نوشته می‌شود. .SS "انتخاب زبان فایل ورودی:" .TP \fB\-L\fR, \fB\-\-language\fR=\fI\,NAME\/\fR تشخیص زبان مشخص‌شده (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) .TP \fB\-C\fR, \fB\-\-c\fR++ کوتاه‌شدهٔ \fB\-\-language\fR=\fI\,C\/\fR++ .PP به‌طور پیش‌فرض زبان فایل بر اساس پسوند نام فایل ورودی حدس زده می‌شود. .SS "تفسیر فایل ورودی:" .TP \fB\-\-from\-code\fR=\fI\,NAME\/\fR کدگذاری فایل‌های ورودی (به‌جز Python، Tcl و Glade) .PP به‌طور پیش‌فرض فرض می‌شود که فایل‌های ورودی با کدگذاری ASCII هستند. .SS "حالت عملیات:" .TP \fB\-j\fR, \fB\-\-join\-existing\fR ادغام پیام‌ها با فایل موجود .TP \fB\-x\fR, \fB\-\-exclude\-file\fR=\fI\,FILE\/\fR.po مدخل‌های موجود در \fIFILE.po\fR استخراج نمی‌شوند .TP \fB\-cTAG\fR, \fB\-\-add\-comments\fR=\fI\,TAG\/\fR قرار دادن بلوک‌های توضیح (کامنت) آغازشده با \fITAG\fR که پیش از خطوط کلمات کلیدی آمده‌اند در فایل خروجی .TP \fB\-c\fR, \fB\-\-add\-comments\fR قرار دادن تمام بلوک‌های توضیح که پیش از خطوط کلمات کلیدی آمده‌اند در فایل خروجی .TP \fB\-\-check\fR=\fI\,NAME\/\fR انجام بررسی نحو روی پیام‌ها (ellipsis\-unicode, space\-ellipsis, .IP quote\-unicode, bullet\-unicode) .TP \fB\-\-no\-check\fR=\fI\,NAME\/\fR عدم انجام بررسی نحو روی پیام‌ها (url, email) .TP \fB\-\-sentence\-end\fR=\fI\,TYPE\/\fR نوع مشخص‌کنندهٔ پایان جمله (single\-space، که حالت پیش‌فرض است، .IP یا double\-space) .SS "گزینه‌های ویژهٔ زبان:" .TP \fB\-a\fR, \fB\-\-extract\-all\fR استخراج تمام رشته‌ها (فقط برای زبان‌های 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) .TP \fB\-kWORD\fR, \fB\-\-keyword\fR=\fI\,WORD\/\fR جستجو برای \fIWORD\fR به‌عنوان کلمه کلیدی اضافی .TP \fB\-k\fR, \fB\-\-keyword\fR عدم استفاده از کلمات کلیدی پیش‌فرض (فقط برای زبان‌های 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) .TP \fB\-\-flag\fR=\fI\,WORD\/\fR:ARG:FLAG فلگ اضافی برای رشته‌های داخل آرگومان شمارهٔ ARG از کلمه کلیدی WORD .TP (فقط برای زبان‌های 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) .TP \fB\-\-tag\fR=\fI\,WORD\/\fR:FORMAT تعریف رفتار الگوهای رشته‌ای نشانه‌گذاری‌شده (tagged template literals) با برچسب WORD .IP (فقط برای زبان JavaScript) .TP \fB\-T\fR, \fB\-\-trigraphs\fR درک سه‌نویسه‌ای‌های (trigraphs) استاندارد ANSI C برای ورودی (منسوخ‌شده؛ فقط برای زبان‌های C, C++, ObjectiveC) .TP \fB\-\-its\fR=\fI\,FILE\/\fR اعمال قواعد ITS از \fIFILE\fR (فقط برای زبان‌های مبتنی بر XML) .TP \fB\-\-qt\fR شناسایی رشته‌های قالب Qt (فقط برای زبان C++) .TP \fB\-\-kde\fR شناسایی رشته‌های قالب KDE 4 (فقط برای زبان C++) .TP \fB\-\-boost\fR شناسایی رشته‌های قالب Boost (فقط برای زبان C++) .TP \fB\-\-debug\fR نتایج شناسایی دقیق‌تر رشته‌های قالب (formatstring) .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\-e\fR, \fB\-\-no\-escape\fR عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیش‌فرض) .TP \fB\-E\fR, \fB\-\-escape\fR استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترش‌یافته .TP \fB\-\-force\-po\fR نوشتن فایل PO حتی در صورت خالی بودن .TP \fB\-i\fR, \fB\-\-indent\fR نوشتن فایل .po با سبک تورفتگی (indent) .TP \fB\-\-no\-location\fR عدم نوشتن خطوط '#: filename:line' .TP \fB\-n\fR, \fB\-\-add\-location\fR تولید خطوط '#: filename:line' (پیش‌فرض) .TP \fB\-\-strict\fR نوشتن فایل .po سازگار و دقیق با استاندارد Uniforum .TP \fB\-\-properties\-output\fR نوشتن یک فایل .properties جاوا در خروجی .TP \fB\-\-stringtable\-output\fR نوشتن یک فایل .strings مربوط به NeXTstep/GNUstep در خروجی .TP \fB\-\-itstool\fR نوشتن توضیحات itstool .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 مرتب‌سازی خروجی بر اساس محل فایل .TP \fB\-\-omit\-header\fR عدم نوشتن سرایند با مدخل 'msgid ""' .TP \fB\-\-no\-git\fR عدم استفاده از برنامه git برای تولید فیلد بازتولیدپذیر 'POT\-Creation\-Date' در خروجی .TP \fB\-\-copyright\-holder\fR=\fI\,STRING\/\fR تنظیم دارنده حق نشر در خروجی .TP \fB\-\-foreign\-user\fR حذف حق نشر FSF در خروجی برای کاربر خارجی .TP \fB\-\-package\-name\fR=\fI\,PACKAGE\/\fR تنظیم نام بسته در خروجی .TP \fB\-\-package\-version\fR=\fI\,VERSION\/\fR تنظیم نسخه بسته در خروجی .TP \fB\-\-msgid\-bugs\-address\fR=\fI\,EMAIL\/\fR@ADDRESS تنظیم نشانی گزارش برای باگ‌های msgid .TP \fB\-\-generated\fR=\fI\,FILE\/\fR اعلام اینکه FILE داده‌شده تولیدشده است و بنابراین نباید تأثیری بر فیلد 'POT\-Creation\-Date' در خروجی داشته باشد .TP \fB\-\-reference\fR=\fI\,FILE\/\fR اعلام اینکه خروجی به محتویات FILE داده‌شده بستگی دارد؛ این امر بر فیلد 'POT\-Creation\-Date' در خروجی تأثیر می‌گذارد .TP \fB\-m[STRING]\fR, \fB\-\-msgstr\-prefix\fR[=\fI\,STRING\/\fR] استفاده از STRING یا "" به‌عنوان پیشوند برای مقادیر msgstr .TP \fB\-M[STRING]\fR, \fB\-\-msgstr\-suffix\fR[=\fI\,STRING\/\fR] استفاده از STRING یا "" به‌عنوان پسوند برای مقادیر msgstr .SS "خروجی اطلاعاتی:" .TP \fB\-h\fR, \fB\-\-help\fR نمایش این راهنما و خروج .TP \fB\-V\fR, \fB\-\-version\fR نمایش اطلاعات نسخه و خروج .TP \fB\-v\fR, \fB\-\-verbose\fR افزایش سطح جزئیات خروجی .SH "نویسندگان (AUTHORS)" نوشته‌شده توسط Ulrich Drepper و Bruno Haible. .SH "گزارش باگ‌ها (REPORTING BUGS)" گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی یا از طریق ایمیل به . .SH "حق نشر (COPYRIGHT)" حق نشر \(co 1995\-2026 Free Software Foundation, Inc. .br مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر .br این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند. .SH "همچنین ببینید (SEE ALSO)" مستندات کامل برای .B xgettext به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های .B info و .B xgettext به‌درستی روی سیستم شما نصب شده باشند، دستور .IP .B info xgettext .PP باید دسترسی شما به راهنمای کامل را فراهم کند.