نام (NAME)

kitten-@-focus-tab - تغییر فوکوس به یک تب مشخص در ترمینال kitty

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

kitten @ focus-tab

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

تبی که باید تطبیق داده شود. مشخصات تطبیق به فرم 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]

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

--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 برای خواندن از توصیف‌گر پرونده 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