نام (NAME)

kitten-@-resize-window - تغییر اندازه پنجره‌های فعال در ترمینال kitty

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

kitten @ resize-window

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

--match, -m

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

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

برای فیلدهای عددی: id، pid، num و recent، عبارت به عنوان عدد تفسیر می‌شود نه عبارت باقاعده. مقادیر منفی برای 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 برای دریافت فهرست پنجره‌ها استفاده کنید.

--increment, -i [=2]

تعداد سلول‌ها برای تغییر اندازه؛ می‌تواند برای کاهش اندازه منفی باشد.

--axis, -a [=horizontal]

محور تغییر اندازه. اگر horizontal باشد، پنجره را به اندازه گام مشخص‌شده عریض‌تر یا باریک‌تر می‌کند. اگر vertical باشد، پنجره را به اندازه گام مشخص‌شده بلندتر یا کوتاه‌تر می‌کند. مقدار ویژه reset چیدمان را به پیکربندی پیش‌فرض بازمی‌گرداند.

انتخاب‌ها: horizontal، reset، vertical

--self [=no]

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

--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 تنظیم شود و گذرواژه‌ای ارائه نشود، از گذرواژه خالی استفاده می‌شود.
انتخاب‌ها: if-available، always، never