نام (NAME)

kitten-@-action - اجرای عملیات قابل‌نگاشت مشخص‌شده

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

kitten @ action ACTION [ARGS FOR ACTION...]

توضیحات (DESCRIPTION)

اجرای عملیات قابل‌نگاشت مشخص‌شده. برای فهرستی از تمام عملیات‌های قابل‌نگاشت موجود، actions را ببینید. هرگونه آرگومان برای ACTION باید پس از action بیاید. توجه داشته باشید که تجزیهٔ آرگومان‌ها به عملیات وابسته است؛ بنابراین برای دستیابی به بهترین نتیجه، تمام آرگومان‌ها را به‌صورت یک رشتهٔ واحد در خط فرمان با همان قالبی که برای آن عملیات در kitty.conf به کار می‌برید، مشخص کنید.

گزینه‌ها (OPTIONS)

--self [=no]

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

--no-response [=no]

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

--match, -m

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

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

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

فیلد num به موقعیت پنجره در زبانهٔ فعلی اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این همان ترتیبی است که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسهٔ پنجرهٔ فعلی در متغیر محیطی KITTY_WINDOW_ID در دسترس است.

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

فیلد neighbor به همسایهٔ پنجرهٔ فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد: left، right، top یا bottom.

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

هنگام استفاده از فیلد env برای مطابقت با متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید، برای مثال env:MY_ENV_VAR=2.

به همین ترتیب، فیلد var بر اساس متغیرهای کاربری تنظیم‌شده روی پنجره مطابقت می‌دهد. می‌توانید همانند فیلد env، نام یا نام و مقدار را مشخص کنید.

فیلد 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) باشد.

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

--help, -h [=no]

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

گزینه‌های عمومی (GLOBAL OPTIONS)

--to: نشانی نمونهٔ kitty برای کنترل. متناظر با نشانی داده‌شده به نمونهٔ kitty از طریق گزینهٔ --listen-on یا تنظیم listen_on در kitty.conf است. در صورت عدم تعیین، متغیر محیطی 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) یا عدم استفاده همیشگی (never) از گذرواژهٔ ارائه‌شده استفاده شود. اگر روی always تنظیم شود و هیچ گذرواژه‌ای ارائه نشود، از گذرواژهٔ خالی استفاده می‌شود.
انتخاب‌ها: if-available، always، never