نام (NAME)

kitten-@-close-tab - بستن زبانه‌های مشخص‌شده

نحوه استفاده (USAGE)

kitten @ close-tab

توضیحات (DESCRIPTION)

بستن مجموعه‌ای دلخواه از زبانه‌ها. از گزینهٔ --match می‌توان برای مشخص کردن مجموعه‌های پیچیده‌ای از زبانه‌ها جهت بستن استفاده کرد. به عنوان مثال، برای بستن تمام زبانه‌های غیرفوکوس‌شده در پنجرهٔ دارای فوکوس فعلیِ سیستم‌عامل، از دستور زیر استفاده کنید::

kitten @ close-tab --match "not state:focused and state:parent_focused"

گزینه‌ها (OPTIONS)

--match, -m

زبانه‌ای که باید مطابقت داده شود. مشخصات تطبیق به صورت field:query هستند. فیلد (field) می‌تواند یکی از موارد زیر باشد: id، index، title، window_id، window_title، pid، cwd، cmdline، env، var، state، session و recent. عبارت query همان عبارتی است که باید مطابقت داده شود. این عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم (regular expression) باشند، و می‌توان آن‌ها را با عملگرهای بولی (Boolean) ترکیب کرد.

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

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

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

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

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

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

هنگام استفاده از فیلد 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 برای دریافت فهرستی از زبانه‌ها استفاده کنید.

--no-response [=no]

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

--self [=no]

به جای زبانهٔ فعال، زبانهٔ پنجره‌ای که این دستور در آن اجرا می‌شود را می‌بندد.

--ignore-no-match [=no]

در صورتی که هیچ زبانه‌ای برای بستن پیدا نشد، خطایی بازنگرداند.

--help, -h [=no]

نمایش راهنما برای این دستور

گزینه‌های سراسری (GLOBAL OPTIONS)

--to: آدرسی برای نمونهٔ kitty جهت کنترل. متناظر با آدرسی است که از طریق گزینهٔ --listen-on یا تنظیم listen_on در kitty.conf به نمونهٔ kitty داده شده است. در صورت مشخص نشدن، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کنندهٔ این فرایند ارسال می‌شوند؛ بدین معنا که آن‌ها فقط در صورتی کار خواهند کرد که این فرایند درون یک پنجرهٔ kitty اجرا شده باشد.
--password: گذرواژه‌ای برای استفاده هنگام ارتباط با kitty. این مورد باعث می‌شود kitty برای انجام عمل مشخص‌شده از کاربر اجازه بگیرد، مگر اینکه گذرواژه پیش‌تر پذیرفته شده باشد یا در kitty.conf از پیش پیکربندی شده باشد. برای استفاده از گذرواژهٔ خالی، --use-password را برابر always مشخص کنید.
--password-file [=rc-pass]: فایلی برای خواندن گذرواژه از آن. فاصله‌های خالی انتهای خط نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty ارزیابی می‌شوند. از - برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل (file descriptor) شمارهٔ num استفاده کنید. در صورتی استفاده می‌شود که گزارهٔ --password ارائه نشده باشد. پیش‌فرض، بررسی وجود فایل rc-pass در دایرکتوری پیکربندی kitty است.
--password-env [=KITTY_RC_PASSWORD]: نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورتی استفاده می‌شود که --password-file ارائه نشده باشد. پیش‌فرض، بررسی متغیر محیطی KITTY_RC_PASSWORD است.
--use-password [=if-available]: اگر هیچ گذرواژه‌ای در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. از این گزینه می‌توان برای وادار کردن آن به استفادهٔ همیشگی یا هرگز استفاده نکردن از گذرواژهٔ ارائه‌شده استفاده کرد. اگر روی always تنظیم شود و گذرواژه‌ای مشخص نشده باشد، گذرواژهٔ خالی استفاده می‌شود.
انتخاب‌ها: if-available، always، never