.TH "kitten-@-set-tab-color" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-set-tab-color \- تنظیم رنگ زبانه‌های مشخص‌شده در نوار زبانه
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ set-tab-color  COLORS"
.YS
.SH "توضیحات (DESCRIPTION)"
تنظیم رنگ زبانه‌های مشخص‌شده در نوار زبانه

رنگ‌های پیش‌زمینه و پس‌زمینه در حالت‌های فعال و غیرفعال را می‌توان با استفاده از این دستور بازنویسی کرد. ساختار نحو برای مشخص‌کردن رنگ‌ها به این صورت است: active_fg=color active_bg=color inactive_fg=color inactive_bg=color. که در آن color می‌تواند نام یک رنگ، یا مقداری به قالب #rrggbb، یا کلیدواژه NONE برای بازگشت به استفاده از رنگ‌های پیش‌فرض باشد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m"
زبانه مورد نظر برای تطبیق. مشخصات تطبیق به قالب field:query هستند. که در آن field می‌تواند یکی از موارد روبه‌رو باشد: id، index، title، window_id، window_title، pid، cwd، cmdline، env، var، state، session و recent. بخش query عبارتی است که باید تطبیق داده شود. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم باشند، و می‌توان آن‌ها را با استفاده از عملگرهای بولی ترکیب کرد.

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

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

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

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

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

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

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

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

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرستی از زبانه‌ها استفاده کنید.
.TP
.BI "--self" " [=no]"
تنظیم رنگ برای زبانه‌ای که این دستور در آن اجرا می‌شود، به‌جای زبانه فعال.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنما برای این دستور.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.TP
.BI "--to"
آدرسی برای نمونه kitty جهت کنترل. مطابق با آدرسی است که از طریق گزینه 
.B \-\-listen\-on
یا تنظیم 
.B listen_on
در 
.I kitty.conf
به نمونه kitty داده شده است. اگر مشخص نشود، متغیر محیطی 
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن هم یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرایند ارسال می‌شوند؛ یعنی تنها در صورتی کار خواهند کرد که این فرایند درون یک پنجره kitty اجرا شود.
.TP
.BI "--password"
گذرواژه‌ای برای استفاده هنگام برقراری ارتباط با kitty. این گزینه باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بخواهد، مگر اینکه گذرواژه قبلاً پذیرفته شده باشد یا در 
.I kitty.conf
از پیش پیکربندی شده باشد. برای استفاده از گذرواژه خالی، 
.B \-\-use\-password
را برابر always مشخص کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی برای خواندن گذرواژه از آن. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty سنجیده می‌شوند. برای خواندن از STDIN از \- استفاده کنید. برای خواندن از توصیف‌گر فایل num از fd:num استفاده کنید. در صورت ارائه نشدن 
.B \-\-password
استفاده می‌شود. مقدار پیش‌فرض، بررسی وجود فایل 
.I rc\-pass
در دایرکتوری پیکربندی kitty است.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورت ارائه نشدن 
.B \-\-password\-file
استفاده می‌شود. مقدار پیش‌فرض، بررسی متغیر محیطی 
.B KITTY_RC_PASSWORD
است.
.TP
.BI "--use-password" " [=if\-available]"
اگر گذرواژه‌ای در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای وادار کردن آن به استفاده همیشگی یا عدم استفاده همیشگی از گذرواژه ارائه‌شده استفاده شود. اگر روی always تنظیم شود و گذرواژه‌ای ارائه نشود، از گذرواژه خالی استفاده می‌شود.

انتخاب‌ها: if-available، always، never