نام (NAME)

kitten-@-set-colors - تغییر پالت رنگ‌های ترمینال kitty به صورت زنده

نحوه استفاده (USAGE)

kitten @ set-colors COLOR_OR_FILE ...

توضیحات (DESCRIPTION)

تنظیم رنگ‌های ترمینال برای پنجره‌ها/تب‌های مشخص‌شده (به‌طور پیش‌فرض پنجره فعال). می‌توانید مسیر یک فایل پیکربندی (با قالبی مشابه kitty.conf) را برای خواندن رنگ‌ها مشخص کنید، یا رنگ‌های تکی را مستقیماً تعیین نمایید؛ برای مثال:

kitten @ set-colors foreground=red background=white

گزینه‌ها (OPTIONS)

--all, -a [=no]: به‌طور پیش‌فرض، رنگ‌ها تنها برای پنجره فعال جاری تغییر می‌کنند. این گزینه باعث تغییر رنگ‌ها در تمامی پنجره‌ها می‌شود.
--configured, -c [=no]: رنگ‌های پیکربندی‌شده را نیز تغییر می‌دهد (رنگ‌هایی که kitty برای پنجره‌های جدید یا پس از بازنشانی استفاده خواهد کرد).
--reset [=no]: تمامی رنگ‌ها را به مقادیر زمان راه‌اندازی kitty بازمی‌گرداند. توجه داشته باشید که با تعیین این گزینه، هرگونه آرگومان رنگ نادیده گرفته شده و گزینه‌های --configured و --all به‌صورت ضمنی فعال می‌شوند.
--match, -m: پنجره مورد نظر برای تطبیق. مشخصات تطبیق به فرمت field:query هستند؛ که در آن field می‌تواند یکی از موارد زیر باشد: id، title، pid، cwd، cmdline، num، env، var، state، neighbor، session و recent. عبارت query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا عبارت باقاعده (regex) باشند و با عملگرهای بولی ترکیب شوند.

مقدار ویژه all با تمامی پنجره‌ها تطبیق می‌یابد.

برای فیلدهای عددی id، pid، num و recent، عبارت به‌صورت یک عدد تفسیر می‌شود نه عبارت باقاعده. مقادیر منفی برای id از بالاترین شماره شناسه به سمت پایین تطبیق می‌یابند؛ به‌ویژه مقدار -1 با تازه‌ترین پنجره ایجادشده مطابقت دارد.

فیلد num به موقعیت پنجره در تب جاری اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (همان ترتیبی که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسه پنجره جاری در متغیر محیطی KITTY_WINDOW_ID در دسترس است.

فیلد recent به پنجره‌های اخیراً فعال در تب فعال جاری اشاره دارد؛ به این صورت که صفر پنجره فعال جاری، یک پنجره فعال قبلی و به همین ترتیب است.

فیلد neighbor به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از مقادیر left، right، top یا bottom باشد.

فیلد session با پنجره‌هایی که در نشست (session) مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت ^$ برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از . برای تطبیق با نشست فعال جاری و از ~ برای تطبیق با نشست فعال جاری یا آخرین نشست فعال (در صورت فعال نبودن هیچ نشستی) استفاده کنید.

هنگام استفاده از فیلد env برای تطبیق روی متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را تعیین کنید؛ مانند env:MY_ENV_VAR=2.

به‌طور مشابه، فیلد var روی متغیرهای کاربری تنظیم‌شده برای پنجره تطبیق می‌یابد. همانند فیلد env می‌توانید نام یا نام و مقدار را تعیین کنید.

فیلد state روی وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self و overlay_parent. پنجره‌های active پنجره‌هایی هستند که در تب والد خود فعال می‌باشند. تنها یک پنجره focused وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن ارسال می‌شود. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره دارای فوکوس تطبیق داده می‌شود. مقدار focused_os_window با تمامی پنجره‌ها در پنجره سیستم‌عامل دارای فوکوس جاری تطبیق می‌یابد. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا شده مطابقت دارد. مقدار overlay_parent با پنجره زیرین پنجره self (هنگامی که پنجره self به‌صورت overlay باشد) تطبیق می‌یابد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرست پنجره‌ها استفاده کنید.

--match-tab, -t: تب مورد نظر برای تطبیق. مشخصات تطبیق به فرمت field:query هستند؛ که در آن field می‌تواند یکی از موارد زیر باشد: id، index، title، window_id، window_title، pid، cwd، cmdline، env، var، state، session و recent. عبارت query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا عبارت باقاعده (regex) باشند و با عملگرهای بولی ترکیب شوند.

مقدار ویژه all با تمامی تب‌ها تطبیق می‌یابد.

برای فیلدهای عددی id، index، window_id، pid و recent، عبارت به‌صورت یک عدد تفسیر می‌شود نه عبارت باقاعده. مقادیر منفی برای id/window_id از بالاترین شماره شناسه به سمت پایین تطبیق می‌یابند؛ به‌ویژه مقدار -1 با تازه‌ترین تب/پنجره ایجادشده مطابقت دارد.

هنگام استفاده از title یا id، ابتدا یک تب منطبق جستجو می‌شود و در صورت نیافتن، یک پنجره منطبق جستجو شده و تب مربوط به آن پنجره استفاده می‌شود.

همچنین می‌توانید از window_id و window_title برای تطبیق با تبی که شامل پنجره‌ای با شناسه یا عنوان مشخص‌شده است استفاده کنید.

شماره index برای تطبیق با n-اُمین تب در پنجره سیستم‌عامل فعال جاری استفاده می‌شود. شماره recent با تب‌های اخیراً فعال در پنجره سیستم‌عامل فعال جاری تطبیق می‌یابد؛ به این صورت که صفر تب فعال جاری، یک تب فعال قبلی و به همین ترتیب است.

فیلد session با تب‌هایی که در نشست (session) مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت ^$ برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از . برای تطبیق با نشست فعال جاری و از ~ برای تطبیق با نشست فعال جاری یا آخرین نشست فعال (در صورت فعال نبودن هیچ نشستی) استفاده کنید.

هنگام استفاده از فیلد env برای تطبیق روی متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را تعیین کنید؛ مانند env:MY_ENV_VAR=2. تب‌هایی که شامل هر پنجره‌ای با متغیرهای محیطی مشخص‌شده باشند تطبیق داده می‌شوند. به‌طور مشابه، var با تب‌هایی که شامل هر پنجره‌ای با متغیر کاربری مشخص‌شده باشند مطابقت می‌یابد.

فیلد state روی وضعیت تب تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused و focused_os_window. تب‌های active تب‌هایی هستند که در پنجره سیستم‌عامل والد خود فعال هستند. تنها یک تب focused وجود دارد و آن تبی است که رویدادهای صفحه‌کلید به آن ارسال می‌شود. اگر هیچ تبی فوکوس نداشته باشد، آخرین تب دارای فوکوس تطبیق داده می‌شود. مقدار focused_os_window با تمامی تب‌ها در پنجره سیستم‌عامل دارای فوکوس جاری تطبیق می‌یابد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرست تب‌ها استفاده کنید.

--help, -h [=no]: نمایش راهنمای این دستور

گزینه‌های عمومی (GLOBAL OPTIONS)

--to: آدرس نمونه‌ای از kitty برای کنترل. متناظر با آدرسی است که از طریق گزینه --listen-on یا تنظیم listen_on در kitty.conf به نمونه kitty داده شده است. در صورت عدم تعیین، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن هم یافت نشود، پیام‌ها به ترمینال کنترل‌کننده همین فرآیند ارسال می‌شوند؛ یعنی تنها در صورتی عمل خواهند کرد که این فرآیند درون یک پنجره kitty اجرا شده باشد.
--password: گذرواژه‌ای برای استفاده هنگام برقراری ارتباط با kitty. این باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بخواهد، مگر اینکه گذرواژه از قبل پذیرفته شده باشد یا در kitty.conf از پیش پیکربندی شده باشد. برای استفاده از گذرواژه خالی، گزینه --use-password را برابر always قرار دهید.
--password-file [=rc-pass]: فایلی برای خواندن گذرواژه از آن. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی بر مبنای دایرکتوری پیکربندی kitty سنجیده می‌شوند. برای خواندن از ورودی استاندارد (STDIN) از - استفاده کنید. برای خواندن از توصیف‌گر فایل num از fd:num استفاده کنید. در صورت عدم ارائه گزینه --password استفاده می‌شود. به‌طور پیش‌فرض وجود فایل rc-pass در دایرکتوری پیکربندی kitty بررسی می‌شود.
--password-env [=KITTY_RC_PASSWORD]: نام متغیر محیطی برای خواندن گذرواژه از آن. در صورت عدم ارائه گزینه --password-file استفاده می‌شود. به‌طور پیش‌فرض متغیر محیطی KITTY_RC_PASSWORD بررسی می‌شود.
--use-password [=if-available]: اگر گذرواژه‌ای در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. اگر روی always تنظیم شود و هیچ گذرواژه‌ای ارائه نشود، گذرواژه خالی استفاده خواهد شد.
گزینه‌های مجاز: if-available، always، never