نام (NAME)

kitten-@-set-enabled-layouts - تنظیم چیدمان‌های مجاز در زبانه‌ها

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

kitten @ set-enabled-layouts LAYOUT ...

توضیحات (DESCRIPTION)

تنظیم چیدمان‌های مجاز در زبانه‌های مشخص‌شده (یا زبانه فعال در صورت مشخص نشدن). می‌توانید از مقدار تطبیق ویژه all برای تنظیم چیدمان‌های مجاز در تمام زبانه‌ها استفاده کنید. اگر چیدمان فعلی زبانه در میان چیدمان‌های مجاز نباشد، چیدمان آن به اولین چیدمان مجاز تغییر می‌یابد.

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

--configured [=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