نام (NAME)

kitten-@-select-window - انتخاب بصری پنجره در ترمینال kitty

خلاصه دستور (SYNOPSIS)

توضیحات (DESCRIPTION)

شناسه (id) پنجره انتخاب‌شده را چاپ می‌کند. سپس می‌توان دستورات دیگر را برای استفاده از آن به یکدیگر زنجیر کرد.

گزینه‌ها (OPTIONS)

--match, -m

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

مقدار ویژه 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. تب‌های فعال تب‌هایی هستند که در پنجره والد سیستم‌عامل خود فعال هستند. تنها یک تب دارای فوکوس وجود دارد و آن تبی است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ تبی فوکوس نداشته باشد، آخرین تب فوکوس‌شده مطابقت داده می‌شود. مقدار focused_os_window با تمام تب‌های موجود در پنجره سیستم‌عامل دارای فوکوس فعلی مطابقت دارد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرست تب‌ها استفاده کنید.

--response-timeout [=60]

مدت زمان به ثانیه برای انتظار جهت انتخاب پنجره توسط کاربر.

--self [=no]

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

--title

عنوانی که برای توصیف هدف این انتخاب به کاربر نمایش داده می‌شود.

--exclude-active [=no]

مستثنی کردن پنجره فعال فعلی از فهرست پنجره‌های قابل انتخاب.

--reactivate-prev-tab [=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 از - استفاده کنید. برای خواندن از توصیف‌کننده فایل num از fd: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