gnome-extensions(1) دستورات کاربری gnome-extensions(1) نام (NAME) gnome-extensions - ابزار خط فرمان مدیریت افزونه‌های گنوم‌شل خلاصه دستور (SYNOPSIS) gnome-extensions help [COMMAND] gnome-extensions version gnome-extensions enable UUID gnome-extensions disable UUID gnome-extensions reset UUID gnome-extensions info UUID gnome-extensions show UUID gnome-extensions list [OPTION...] gnome-extensions prefs UUID gnome-extensions create [OPTION...] gnome-extensions pack [OPTION...] gnome-extensions install [OPTION...] PACK gnome-extensions uninstall UUID gnome-extensions upload [OPTION...] PACK... توضیحات (DESCRIPTION) دستور gnome-extensions ابزاری است که برخی از عملیات‌های متداول افزونه‌های گنوم را در خط فرمان در دسترس قرار می‌دهد. گزینه‌های عمومی (COMMON OPTIONS) همه دستورات به جز help و version از گزینه‌های زیر پشتیبانی می‌کنند: --quiet, -q عدم چاپ پیام‌های خطا. دستورات (COMMANDS) help [COMMAND] نمایش چکیده کوتاهی از دستورات موجود یا ارائه راهنمای دقیق در مورد یک دستور خاص. version چاپ نسخه برنامه. enable UUID افزونه مشخص‌شده با UUID را فعال می‌کند. این دستور خطاهای درون خود افزونه را تشخیص نمی‌دهد؛ از دستور info برای اطمینان از قرار داشتن وضعیت افزونه در حالت ACTIVE استفاده کنید. اگر افزونه از قبل فعال باشد، این دستور کاری انجام نمی‌دهد. disable UUID افزونه مشخص‌شده با UUID را غیرفعال می‌کند. اگر افزونه فعال نباشد، این دستور کاری انجام نمی‌دهد. reset UUID بازنشانی وضعیت افزونه مشخص‌شده با UUID. افزونه در نشست گنوم غیرفعال خواهد شد، اما ممکن است در سایر نشست‌ها مانند گنوم کلاسیک فعال شود. info UUID نمایش جزئیات افزونه مشخص‌شده با UUID شامل نام، توضیحات و وضعیت آن. show UUID هم‌معنی با دستور info. list [OPTION...] نمایش فهرستی از افزونه‌های نصب‌شده. گزینه‌ها (Options) --user شامل افزونه‌های نصب‌شده در پوشه خانگی کاربر ($HOME) --system شامل افزونه‌های نصب‌شده در سطح سیستم --enabled شامل افزونه‌های فعال --disabled شامل افزونه‌های غیرفعال --active فقط شامل افزونه‌های در وضعیت فعال (active) --inactive فقط شامل افزونه‌های در وضعیت غیرفعال (inactive) --prefs فقط شامل افزونه‌های دارای صفحه تنظیمات (preferences) --updates فقط شامل افزونه‌های دارای به‌روزرسانی معلق -d, --details نمایش اطلاعات تکمیلی برای هر افزونه prefs UUID باز کردن پنجره تنظیمات افزونه مشخص‌شده با UUID. create [OPTION...] ایجاد یک افزونه جدید از روی قالب. گزینه‌ها (Options) --name=NAME تنظیم نام قابل مشاهده برای کاربر در متادیتای افزونه به NAME --description=DESC تنظیم توضیحات در متادیتای افزونه به DESC --uuid=UUID تنظیم شناسه یکتای افزونه در متادیتا به UUID --gettext-domain=DOMAIN تنظیم دامنه gettext مورد استفاده افزونه --settings-schema=SCHEMA تنظیم اسکیمای GSettings مورد استفاده افزونه --template=TEMPLATE استفاده از TEMPLATE به عنوان پایه برای افزونه جدید --prefs گنجاندن قالب prefs.js -i, --interactive پرسش تعاملی برای دریافت هر متادیتایی که در خط فرمان ارائه نشده است pack [OPTION...] [SOURCE-DIRECTORY] ایجاد یک بسته افزونه مناسب برای انتشار. این بسته همواره شامل فایل‌های الزامی extension.js و metadata.json و همچنین هر یک از فایل‌های اختیاری stylesheet.css، stylesheet-dark.css، stylesheet-light.css یا prefs.js در صورت وجود خواهد بود. هر فایل منبع اضافی دیگری که باید گنجانده شود باید با گزینه --extra-source مشخص گردد. اگر افزونه شامل یک یا چند اسکیمای GSettings باشد، می‌توان آن‌ها را در پوشه schemas/ قرار داد تا به صورت خودکار شناسایی شوند یا با گزینه --schema مشخص شوند. به همین ترتیب، ترجمه‌ها هنگامی که در پوشه po/ قرار داشته باشند به صورت خودکار گنجانده می‌شوند، در غیر این صورت می‌توان از گزینه --podir برای اشاره به پوشه مناسب استفاده کرد. اگر هیچ دامنه gettext در خط فرمان مشخص نشود، از مقدار فیلد متادیتای gettext-domain در صورت وجود، و در غیر این صورت از شناسه یکتای افزونه (UUID) استفاده خواهد شد. جستجوی تمام فایل‌ها در صورت تعیین SOURCE-DIRECTORY در آن پوشه و در غیر این صورت در پوشه جاری انجام می‌شود. گزینه‌ها (Options) --extra-source=FILE منبع اضافی برای گنجاندن در بسته --schema=SCHEMA اسکیمای GSettings که باید در بسته گنجانده شود --podir=PODIR پوشه حاوی ترجمه‌ها که باید کامپایل شده و در بسته قرار گیرد --gettext-domain=DOMAIN دامنه gettext مورد استفاده برای ترجمه‌ها -f, --force بازنویسی روی بسته موجود -o, --out-dir=DIRECTORY پوشه‌ای که بسته باید در آن ایجاد شود install [OPTION...] PACK نصب یک افزونه از فایل بسته PACK. این دستور فایل‌های افزونه را استخراج کرده و به محل مورد نظر در پوشه خانگی کاربر ($HOME) منتقل می‌کند تا در نشست بعدی بارگذاری شود. این دستور عمدتاً برای آزمایش طراحی شده است و جایگزینی برای وب‌سایت افزونه‌ها نیست. از آنجا که افزونه‌ها دسترسی سطح بالایی به نشست کاربر دارند، توصیه می‌شود هرگز افزونه‌ها را از منابع نامعتبر بدون بررسی دقیق محتوای آن‌ها بارگذاری نکنید. گزینه‌ها (Options) --force بازنویسی و جایگزینی افزونه موجود uninstall UUID حذف افزونه مشخص‌شده با UUID. upload [OPTION...] PACK... بارگذاری یک یا چند بسته افزونه در . اگر اطلاعات ورود به سیستم مورد نیاز باشد، هنگام درخواست می‌توان آن‌ها را به صورت تعاملی وارد کرد. این روش معمولاً بر گزینه‌های --password یا --password-file ترجیح داده می‌شود، زیرا این گزینه‌ها بسته به شیوه ارائه، خطر افشای رمز عبور در گزارش‌ها، متغیرهای محیطی یا فایل‌سیستم را به همراه دارند. گزینه‌ها (Options) --accept-tos پذیرش شرایط خدمات در --user=USER نام کاربری برای ورود به --password=PASSWORD رمز عبور برای ورود به --password-file=FILE فایل برای خواندن رمز عبور وضعیت خروج (EXIT STATUS) در صورت موفقیت مقدار 0 و در غیر این صورت یک کد شکست غیر صفر بازگردانده می‌شود. اشکالات (BUGS) این ابزار بخشی از پروژه gnome-shell است و اشکالات باید در ردیاب مشکلات آن در گزارش شوند. gnome-extensions(1)