.TH "kitten-@-detach-tab" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-detach-tab \- جدا کردن یک تب از پنجره جاری ترمینال kitty
.SH "خلاصه دستور (SYNOPSIS)"
.SY "kitten @ detach-tab "
.YS
.SH "توضیحات (DESCRIPTION)"
جدا کردن تب‌های مشخص‌شده و انتقال آن‌ها به یک پنجره جدید سیستم‌عامل یا افزودن آن‌ها به پنجره‌ای از سیستم‌عامل که تب مشخص‌شده با
.B \-\-target\-tab
در آن قرار دارد.
.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 عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند عدد یا یک عبارت باقاعده (regular expression) باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

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

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

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

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

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

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

هنگام استفاده از فیلد 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 برای دریافت فهرست تب‌ها استفاده کنید.
.TP
.BI "--target-tab, -t"
تب مورد نظر برای تطبیق. مشخصات تطبیق به فرم field:query هستند. که field می‌تواند یکی از موارد زیر باشد: id، index، title، window_id، window_title، pid، cwd، cmdline، env، var، state، session و recent. شناسه query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند عدد یا یک عبارت باقاعده (regular expression) باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

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

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

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

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

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

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

هنگام استفاده از فیلد 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 برای دریافت فهرست تب‌ها استفاده کنید.
.TP
.BI "--self" " [=no]"
جدا کردن تبی که این دستور در آن اجرا شده است، به جای تب فعال.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنما برای این دستور.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
.BI "--to"
نشانی نمونه kitty برای کنترل. متناظر با نشانی داده‌شده به نمونه kitty از طریق گزینه
.B \-\-listen\-on
یا تنظیم
.B listen_on
در
.I kitty.conf
است. در صورت مشخص نشدن، متغیر محیطی
.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