.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "gnome-extensions" "1" "" "" "دستورات کاربری" .SH "نام (NAME)" gnome-extensions \- ابزار خط فرمان مدیریت افزونه‌های گنوم‌شل .SH "خلاصه دستور (SYNOPSIS)" .nf \fBgnome\-extensions\fP help [\fICOMMAND\fP] \fBgnome\-extensions\fP version \fBgnome\-extensions\fP enable \fIUUID\fP \fBgnome\-extensions\fP disable \fIUUID\fP \fBgnome\-extensions\fP reset \fIUUID\fP \fBgnome\-extensions\fP info \fIUUID\fP \fBgnome\-extensions\fP show \fIUUID\fP \fBgnome\-extensions\fP list [\fIOPTION\fP\&...] \fBgnome\-extensions\fP prefs \fIUUID\fP \fBgnome\-extensions\fP create [\fIOPTION\fP\&...] \fBgnome\-extensions\fP pack [\fIOPTION\fP\&...] \fBgnome\-extensions\fP install [\fIOPTION\fP\&...] \fIPACK\fP \fBgnome\-extensions\fP uninstall \fIUUID\fP \fBgnome\-extensions\fP upload [\fIOPTION\fP\&...] \fIPACK\fP\&... .fi .sp .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgnome\-extensions\fP ابزاری است که برخی از عملیات‌های متداول افزونه‌های گنوم را در خط فرمان در دسترس قرار می‌دهد. .SH "گزینه‌های عمومی (COMMON OPTIONS)" .sp همه دستورات به جز \fBhelp\fP و \fBversion\fP از گزینه‌های زیر پشتیبانی می‌کنند: .sp \fB\-\-quiet\fP, \fB\-q\fP .INDENT 0.0 .INDENT 3.5 عدم چاپ پیام‌های خطا. .UNINDENT .UNINDENT .SH "دستورات (COMMANDS)" .sp \fBhelp\fP [\fICOMMAND\fP] .INDENT 0.0 .INDENT 3.5 نمایش چکیده کوتاهی از دستورات موجود یا ارائه راهنمای دقیق در مورد یک دستور خاص. .UNINDENT .UNINDENT .sp \fBversion\fP .INDENT 0.0 .INDENT 3.5 چاپ نسخه برنامه. .UNINDENT .UNINDENT .sp \fBenable\fP \fIUUID\fP .INDENT 0.0 .INDENT 3.5 افزونه مشخص‌شده با \fIUUID\fP را فعال می‌کند. .sp این دستور خطاهای درون خود افزونه را تشخیص نمی‌دهد؛ از دستور \fBinfo\fP برای اطمینان از قرار داشتن وضعیت افزونه در حالت \fIACTIVE\fP استفاده کنید. .sp اگر افزونه از قبل فعال باشد، این دستور کاری انجام نمی‌دهد. .UNINDENT .UNINDENT .sp \fBdisable\fP \fIUUID\fP .INDENT 0.0 .INDENT 3.5 افزونه مشخص‌شده با \fIUUID\fP را غیرفعال می‌کند. .sp اگر افزونه فعال نباشد، این دستور کاری انجام نمی‌دهد. .UNINDENT .UNINDENT .sp \fBreset\fP \fIUUID\fP .INDENT 0.0 .INDENT 3.5 بازنشانی وضعیت افزونه مشخص‌شده با \fIUUID\fP\&. .sp افزونه در نشست گنوم غیرفعال خواهد شد، اما ممکن است در سایر نشست‌ها مانند گنوم کلاسیک فعال شود. .UNINDENT .UNINDENT .sp \fBinfo\fP \fIUUID\fP .INDENT 0.0 .INDENT 3.5 نمایش جزئیات افزونه مشخص‌شده با \fIUUID\fP شامل نام، توضیحات و وضعیت آن. .UNINDENT .UNINDENT .sp \fBshow\fP \fIUUID\fP .INDENT 0.0 .INDENT 3.5 هم‌معنی با دستور info. .UNINDENT .UNINDENT .sp \fBlist\fP [\fIOPTION\fP\&...] .INDENT 0.0 .INDENT 3.5 نمایش فهرستی از افزونه‌های نصب‌شده. .sp \fBگزینه‌ها (Options)\fP .INDENT 0.0 .INDENT 3.5 \fB\-\-user\fP .INDENT 0.0 .INDENT 3.5 شامل افزونه‌های نصب‌شده در پوشه خانگی کاربر (\fB$HOME\fP) .UNINDENT .UNINDENT .sp \fB\-\-system\fP .INDENT 0.0 .INDENT 3.5 شامل افزونه‌های نصب‌شده در سطح سیستم .UNINDENT .UNINDENT .sp \fB\-\-enabled\fP .INDENT 0.0 .INDENT 3.5 شامل افزونه‌های فعال .UNINDENT .UNINDENT .sp \fB\-\-disabled\fP .INDENT 0.0 .INDENT 3.5 شامل افزونه‌های غیرفعال .UNINDENT .UNINDENT .sp \fB\-\-active\fP .INDENT 0.0 .INDENT 3.5 فقط شامل افزونه‌های در وضعیت فعال (active) .UNINDENT .UNINDENT .sp \fB\-\-inactive\fP .INDENT 0.0 .INDENT 3.5 فقط شامل افزونه‌های در وضعیت غیرفعال (inactive) .UNINDENT .UNINDENT .sp \fB\-\-prefs\fP .INDENT 0.0 .INDENT 3.5 فقط شامل افزونه‌های دارای صفحه تنظیمات (preferences) .UNINDENT .UNINDENT .sp \fB\-\-updates\fP .INDENT 0.0 .INDENT 3.5 فقط شامل افزونه‌های دارای به‌روزرسانی معلق .UNINDENT .UNINDENT .sp \fB\-d\fP, \fB\-\-details\fP .INDENT 0.0 .INDENT 3.5 نمایش اطلاعات تکمیلی برای هر افزونه .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .sp \fBprefs\fP \fIUUID\fP .INDENT 0.0 .INDENT 3.5 باز کردن پنجره تنظیمات افزونه مشخص‌شده با \fIUUID\fP\&. .UNINDENT .UNINDENT .sp \fBcreate\fP [\fIOPTION\fP\&...] .INDENT 0.0 .INDENT 3.5 ایجاد یک افزونه جدید از روی قالب. .sp \fBگزینه‌ها (Options)\fP .INDENT 0.0 .INDENT 3.5 \fB\-\-name\fP=\fINAME\fP .INDENT 0.0 .INDENT 3.5 تنظیم نام قابل مشاهده برای کاربر در متادیتای افزونه به \fINAME\fP .UNINDENT .UNINDENT .sp \fB\-\-description\fP=\fIDESC\fP .INDENT 0.0 .INDENT 3.5 تنظیم توضیحات در متادیتای افزونه به \fIDESC\fP .UNINDENT .UNINDENT .sp \fB\-\-uuid\fP=\fIUUID\fP .INDENT 0.0 .INDENT 3.5 تنظیم شناسه یکتای افزونه در متادیتا به \fIUUID\fP .UNINDENT .UNINDENT .sp \fB\-\-gettext\-domain\fP=\fIDOMAIN\fP .INDENT 0.0 .INDENT 3.5 تنظیم دامنه gettext مورد استفاده افزونه .UNINDENT .UNINDENT .sp \fB\-\-settings\-schema\fP=\fISCHEMA\fP .INDENT 0.0 .INDENT 3.5 تنظیم اسکیمای GSettings مورد استفاده افزونه .UNINDENT .UNINDENT .sp \fB\-\-template\fP=\fITEMPLATE\fP .INDENT 0.0 .INDENT 3.5 استفاده از \fITEMPLATE\fP به عنوان پایه برای افزونه جدید .UNINDENT .UNINDENT .sp \fB\-\-prefs\fP .INDENT 0.0 .INDENT 3.5 گنجاندن قالب prefs.js .UNINDENT .UNINDENT .sp \fB\-i\fP, \fB\-\-interactive\fP .INDENT 0.0 .INDENT 3.5 پرسش تعاملی برای دریافت هر متادیتایی که در خط فرمان ارائه نشده است .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .sp \fBpack\fP [\fIOPTION\fP\&...] [\fISOURCE\-DIRECTORY\fP] .INDENT 0.0 .INDENT 3.5 ایجاد یک بسته افزونه مناسب برای انتشار. .sp این بسته همواره شامل فایل‌های الزامی extension.js و metadata.json و همچنین هر یک از فایل‌های اختیاری stylesheet.css، stylesheet\-dark.css، stylesheet\-light.css یا prefs.js در صورت وجود خواهد بود. هر فایل منبع اضافی دیگری که باید گنجانده شود باید با گزینه \fB\-\-extra\-source\fP مشخص گردد. .sp اگر افزونه شامل یک یا چند اسکیمای GSettings باشد، می‌توان آن‌ها را در پوشه schemas/ قرار داد تا به صورت خودکار شناسایی شوند یا با گزینه \fB\-\-schema\fP مشخص شوند. .sp به همین ترتیب، ترجمه‌ها هنگامی که در پوشه po/ قرار داشته باشند به صورت خودکار گنجانده می‌شوند، در غیر این صورت می‌توان از گزینه \fB\-\-podir\fP برای اشاره به پوشه مناسب استفاده کرد. اگر هیچ دامنه gettext در خط فرمان مشخص نشود، از مقدار فیلد متادیتای \fBgettext\-domain\fP در صورت وجود، و در غیر این صورت از شناسه یکتای افزونه (UUID) استفاده خواهد شد. .sp جستجوی تمام فایل‌ها در صورت تعیین \fISOURCE\-DIRECTORY\fP در آن پوشه و در غیر این صورت در پوشه جاری انجام می‌شود. .sp \fBگزینه‌ها (Options)\fP .INDENT 0.0 .INDENT 3.5 \fB\-\-extra\-source\fP=\fIFILE\fP .INDENT 0.0 .INDENT 3.5 منبع اضافی برای گنجاندن در بسته .UNINDENT .UNINDENT .sp \fB\-\-schema\fP=\fISCHEMA\fP .INDENT 0.0 .INDENT 3.5 اسکیمای GSettings که باید در بسته گنجانده شود .UNINDENT .UNINDENT .sp \fB\-\-podir\fP=\fIPODIR\fP .INDENT 0.0 .INDENT 3.5 پوشه حاوی ترجمه‌ها که باید کامپایل شده و در بسته قرار گیرد .UNINDENT .UNINDENT .sp \fB\-\-gettext\-domain\fP=\fIDOMAIN\fP .INDENT 0.0 .INDENT 3.5 دامنه gettext مورد استفاده برای ترجمه‌ها .UNINDENT .UNINDENT .sp \fB\-f\fP, \fB\-\-force\fP .INDENT 0.0 .INDENT 3.5 بازنویسی روی بسته موجود .UNINDENT .UNINDENT .sp \fB\-o\fP, \fB\-\-out\-dir\fP=\fIDIRECTORY\fP .INDENT 0.0 .INDENT 3.5 پوشه‌ای که بسته باید در آن ایجاد شود .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .sp \fBinstall\fP [\fIOPTION\fP\&...] \fIPACK\fP .INDENT 0.0 .INDENT 3.5 نصب یک افزونه از فایل بسته \fIPACK\fP\&. .sp این دستور فایل‌های افزونه را استخراج کرده و به محل مورد نظر در پوشه خانگی کاربر (\fB$HOME\fP) منتقل می‌کند تا در نشست بعدی بارگذاری شود. .sp این دستور عمدتاً برای آزمایش طراحی شده است و جایگزینی برای وب‌سایت افزونه‌ها نیست. از آنجا که افزونه‌ها دسترسی سطح بالایی به نشست کاربر دارند، توصیه می‌شود هرگز افزونه‌ها را از منابع نامعتبر بدون بررسی دقیق محتوای آن‌ها بارگذاری نکنید. .sp \fBگزینه‌ها (Options)\fP .INDENT 0.0 .INDENT 3.5 \fB\-\-force\fP .INDENT 0.0 .INDENT 3.5 بازنویسی و جایگزینی افزونه موجود .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .sp \fBuninstall\fP \fIUUID\fP .INDENT 0.0 .INDENT 3.5 حذف افزونه مشخص‌شده با \fIUUID\fP\&. .UNINDENT .UNINDENT .sp \fBupload\fP [\fIOPTION\fP\&...] \fIPACK\fP\&... .INDENT 0.0 .INDENT 3.5 بارگذاری یک یا چند بسته افزونه در \&. .sp اگر اطلاعات ورود به سیستم مورد نیاز باشد، هنگام درخواست می‌توان آن‌ها را به صورت تعاملی وارد کرد. این روش معمولاً بر گزینه‌های \fB\-\-password\fP یا \fB\-\-password\-file\fP ترجیح داده می‌شود، زیرا این گزینه‌ها بسته به شیوه ارائه، خطر افشای رمز عبور در گزارش‌ها، متغیرهای محیطی یا فایل‌سیستم را به همراه دارند. .sp \fBگزینه‌ها (Options)\fP .INDENT 0.0 .INDENT 3.5 \fB\-\-accept\-tos\fP .INDENT 0.0 .INDENT 3.5 پذیرش شرایط خدمات در .UNINDENT .UNINDENT .sp \fB\-\-user\fP=\fIUSER\fP .INDENT 0.0 .INDENT 3.5 نام کاربری برای ورود به .UNINDENT .UNINDENT .sp \fB\-\-password\fP=\fIPASSWORD\fP .INDENT 0.0 .INDENT 3.5 رمز عبور برای ورود به .UNINDENT .UNINDENT .sp \fB\-\-password\-file\fP=\fIFILE\fP .INDENT 0.0 .INDENT 3.5 فایل برای خواندن رمز عبور .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp در صورت موفقیت مقدار 0 و در غیر این صورت یک کد شکست غیر صفر بازگردانده می‌شود. .SH "اشکالات (BUGS)" .sp این ابزار بخشی از پروژه gnome\-shell است و اشکالات باید در ردیاب مشکلات آن در گزارش شوند. .\" End of generated man page.