.TH "kitten-@-focus-window" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-focus-window \- تغییر فوکوس به یک پنجره مشخص در ترمینال kitty
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ focus-window "
.YS
.SH "توضیحات (DESCRIPTION)"
تغییر فوکوس به پنجره مشخص‌شده؛ اگر هیچ پنجره‌ای مشخص نشود، فوکوس به پنجره‌ای که این دستور در آن اجرا شده منتقل می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m"
پنجره مورد نظر برای تطبیق. مشخصات تطبیق به صورت
.I field:query
هستند. که در آن
.I field
می‌تواند یکی از موارد زیر باشد:
.BR id ،
.BR title ،
.BR pid ،
.BR cwd ،
.BR cmdline ،
.BR num ،
.BR env ،
.BR var ،
.BR state ،
.BR neighbor ،
.B session
و
.BR recent .
مقدار
.I query
عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی ترکیب کرد.
.sp
مقدار ویژه
.B all
با همه پنجره‌ها تطبیق می‌یابد.
.sp
برای فیلدهای عددی:
.BR id ،
.BR pid ،
.B num
و
.BR recent ،
عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت منظم. مقادیر منفی برای
.B id
از بالاترین شماره شناسه به سمت پایین تطبیق داده می‌شوند؛ به طور خاص،
.B \-1
نشان‌دهنده جدیدترین پنجره ایجاد شده است.
.sp
فیلد
.B num
به موقعیت پنجره در زبانه فعلی اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب مشابه ترتیبی است که پنجره‌ها توسط دستور
.B kitten @ ls
گزارش می‌شوند).
.sp
شناسه پنجره فعلی از طریق متغیر محیطی
.B KITTY_WINDOW_ID
در دسترس است.
.sp
فیلد
.B recent
به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد؛ به طوری که صفر پنجره فعال فعلی، یک پنجره فعال قبلی و به همین ترتیب است.
.sp
فیلد
.B neighbor
به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد:
.BR left ،
.BR right ،
.B top
یا
.B bottom
باشد.
.sp
فیلد
.B session
با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت
.B \(ha$
برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از
.B .
برای تطبیق با نشست فعال فعلی و از
.B \(ti
برای تطبیق با نشست فعال فعلی یا آخرین نشست فعال (در صورتی که هیچ نشستی فعال نباشد) استفاده کنید.
.sp
هنگام استفاده از فیلد
.B env
برای تطبیق بر اساس متغیرهای محیطی، می‌توانید فقط نام متغیر محیطی یا نام و مقدار آن را مشخص کنید؛ به عنوان مثال
.BR env:MY_ENV_VAR=2 .
.sp
به طور مشابه، فیلد
.B var
بر اساس متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌دهد. می‌توانید مانند فیلد
.B env
تنها نام یا نام و مقدار را تعیین کنید.
.sp
فیلد
.B state
بر اساس وضعیت پنجره تطبیق می‌دهد. وضعیت‌های پشتیبانی‌شده عبارتند از:
.BR active ،
.BR focused ،
.BR needs_attention ،
.BR parent_active ،
.BR parent_focused ،
.BR focused_os_window ،
.B self
و
.BR overlay_parent .
پنجره‌های
.B active
پنجره‌هایی هستند که در زبانه والد خود فعال هستند. فقط یک پنجره
.B focused
وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن ارسال می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره دارای فوکوس تطبیق داده می‌شود. مقدار
.B focused_os_window
با تمام پنجره‌های موجود در پنجره سیستم‌عامل دارای فوکوس فعلی تطبیق می‌یابد. مقدار
.B self
با پنجره‌ای که دستور کنترل از راه دور در آن اجرا شده تطبیق دارد. مقدار
.B overlay_parent
با پنجره‌ای که زیر پنجره
.B self
قرار دارد (هنگامی که پنجره
.B self
یک لایه رویی یا overlay باشد) تطبیق می‌یابد.
.sp
توجه داشته باشید که می‌توانید از دستور
.B kitten @ ls
برای دریافت فهرست پنجره‌ها استفاده کنید.
.TP
.BI "--no-response" " [=no]"
منتظر پاسخ از سوی kitty نمان. این بدان معناست که حتی اگر پنجره منطبقی یافت نشود، دستور با کد موفقیت خارج می‌شود.
.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
برای خواندن از توصیف‌کننده فایل 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
انتخاب‌ها:
.BR if\-available ،
.B always
و
.B never