gnome-extensions(1) دستورات کاربری gnome-extensions(1)

gnome-extensions - ابزار خط فرمان مدیریت افزونه‌های گنوم‌شل

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...

دستور gnome-extensions ابزاری است که برخی از عملیات‌های متداول افزونه‌های گنوم را در خط فرمان در دسترس قرار می‌دهد.

همه دستورات به جز help و version از گزینه‌های زیر پشتیبانی می‌کنند:

--quiet, -q

عدم چاپ پیام‌های خطا.

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...

بارگذاری یک یا چند بسته افزونه در https://extensions.gnome.org.

اگر اطلاعات ورود به سیستم مورد نیاز باشد، هنگام درخواست می‌توان آن‌ها را به صورت تعاملی وارد کرد. این روش معمولاً بر گزینه‌های --password یا --password-file ترجیح داده می‌شود، زیرا این گزینه‌ها بسته به شیوه ارائه، خطر افشای رمز عبور در گزارش‌ها، متغیرهای محیطی یا فایل‌سیستم را به همراه دارند.

گزینه‌ها (Options)

--accept-tos
پذیرش شرایط خدمات در https://extensions.gnome.org/upload

--user=USER

نام کاربری برای ورود به https://extensions.gnome.org

--password=PASSWORD

رمز عبور برای ورود به https://extensions.gnome.org

--password-file=FILE

فایل برای خواندن رمز عبور https://extensions.gnome.org

در صورت موفقیت مقدار 0 و در غیر این صورت یک کد شکست غیر صفر بازگردانده می‌شود.

این ابزار بخشی از پروژه gnome-shell است و اشکالات باید در ردیاب مشکلات آن در https://gitlab.gnome.org/GNOME/gnome-shell/issues گزارش شوند.