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