.TH "kitten-@-focus-tab" "1" "Jul 30, 2026" "0.48.2" "راهنمای kitten"
.SH "نام (NAME)"
kitten-@-focus-tab \- تغییر فوکوس به یک تب مشخص در ترمینال kitty
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ focus-tab "
.YS
.SH "توضیحات (DESCRIPTION)"
پنجره فعال در تب مشخص‌شده فوکوس داده خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m"
تبی که باید تطبیق داده شود. مشخصات تطبیق به فرم \fIfield:query\fR است؛ که در آن \fIfield\fR می‌تواند یکی از موارد زیر باشد: \fBid\fR، \fBindex\fR، \fBtitle\fR، \fBwindow_id\fR، \fBwindow_title\fR، \fBpid\fR، \fBcwd\fR، \fBcmdline\fR، \fBenv\fR، \fBvar\fR، \fBstate\fR، \fBsession\fR و \fBrecent\fR. مقدار \fIquery\fR عبارتی است که باید تطبیق داده شود. عبارت‌ها می‌توانند یک عدد یا یک عبارت باقاعده (regular expression) باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی (Boolean) ترکیب نمود.
.sp
مقدار ویژه \fBall\fR با تمام تب‌ها تطبیق می‌یابد.
.sp
برای فیلدهای عددی: \fBid\fR، \fBindex\fR، \fBwindow_id\fR، \fBpid\fR و \fBrecent\fR، عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت باقاعده. مقادیر منفی برای \fBid\fR/\fBwindow_id\fR از بالاترین شماره شناسه به سمت پایین تطبیق می‌یابند؛ به‌ویژه \fB\-1\fR تازه‌ترین تب/پنجره ایجادشده است.
.sp
هنگام استفاده از \fBtitle\fR یا \fBid\fR، ابتدا یک تب منطبق جستجو می‌شود، و در صورت پیدا نشدن یک پنجره منطبق جستجو شده و از تب مربوط به آن پنجره استفاده می‌شود.
.sp
همچنین می‌توانید از \fBwindow_id\fR و \fBwindow_title\fR برای تطبیق تبی که شامل پنجره‌ای با شناسه یا عنوان مشخص‌شده است استفاده کنید.
.sp
شماره \fBindex\fR برای تطبیق nامین تب در پنجره سیستم‌عامل در حال حاضر فعال استفاده می‌شود. شماره \fBrecent\fR با تب‌های اخیراً فعال در پنجره سیستم‌عامل در حال حاضر فعال تطبیق می‌یابد، که در آن صفر تب در حال حاضر فعال، یک تب فعال قبلی و به همین ترتیب است.
.sp
فیلد \fBsession\fR تب‌هایی را که در نشست (session) مشخص‌شده ایجاد شده‌اند تطبیق می‌دهد. از عبارت \fB\(ha$\fR برای تطبیق پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از \fB.\fR برای تطبیق نشست در حال حاضر فعال، و از \fB\(ti\fR برای تطبیق نشست فعال فعلی یا آخرین نشست فعال (هنگامی که هیچ نشستی فعال نیست) استفاده کنید.
.sp
هنگام استفاده از فیلد \fBenv\fR برای تطبیق متغیرهای محیطی، می‌توانید فقط نام متغیر محیطی یا یک نام و مقدار را مشخص کنید، برای مثال: \fBenv:MY_ENV_VAR=2\fR. تب‌هایی که شامل هر پنجره‌ای با متغیرهای محیطی مشخص‌شده باشند تطبیق داده می‌شوند. به همین ترتیب، \fBvar\fR تب‌هایی را که شامل هر پنجره‌ای با متغیر کاربری مشخص‌شده باشند تطبیق می‌دهد.
.sp
فیلد \fBstate\fR با وضعیت تب تطبیق داده می‌شود. وضعیت‌های پشتیبانی‌شده عبارتند از: \fBactive\fR، \fBfocused\fR، \fBneeds_attention\fR، \fBparent_active\fR، \fBparent_focused\fR و \fBfocused_os_window\fR. تب‌های فعال (\fBactive\fR) تب‌هایی هستند که در پنجره سیستم‌عامل والد خود فعال هستند. تنها یک تب فوکوس‌شده (\fBfocused\fR) وجود دارد و آن تبی است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ تبی فوکوس نداشته باشد، آخرین تب فوکوس‌شده تطبیق داده می‌شود. مقدار \fBfocused_os_window\fR تمام تب‌های موجود در پنجره سیستم‌عامل با فوکوس فعلی را تطبیق می‌دهد.
.sp
توجه داشته باشید که می‌توانید از دستور \fBkitten @ ls\fR برای دریافت فهرست تب‌ها استفاده کنید.
.TP
.BI "--no-response" " [=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
را برابر با
.B always
تعیین کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
پرونده‌ای برای خواندن گذرواژه از آن. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به پوشه پیکربندی kitty سنجیده می‌شوند. از
.B \-
برای خواندن از ورودی استاندارد (STDIN) استفاده کنید. از
.B fd:num
برای خواندن از توصیف‌گر پرونده
.I 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 معمولاً فقط دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. اگر روی
.B always
تنظیم شود و هیچ گذرواژه‌ای ارائه نشود، گذرواژه خالی استفاده خواهد شد.
.sp
انتخاب‌ها: \fBif\-available\fR، \fBalways\fR، \fBnever\fR