kitten-@-disable-ligatures(1) kitten Manual kitten-@-disable-ligatures(1)

kitten-@-disable-ligatures - فعال یا غیرفعال کردن لیگاتورهای فونت در پنجره‌های ترمینال kitty

kitten @ disable-ligatures STRATEGY

کنترل نحوه رندر لیگاتورها (حروف پیوسته) برای پنجره‌ها یا زبانه‌های مشخص‌شده (پیش‌فرض پنجره فعال است). مقدار STRATEGY می‌تواند یکی از این موارد باشد: never، always یا cursor.

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

مقدار ویژه 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 برای دریافت فهرست پنجره‌ها استفاده کنید.

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

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

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

هنگام استفاده از title یا id، ابتدا به دنبال زبانه منطبق گشته می‌شود و در صورت نیافتن، به دنبال پنجره منطبق گشته شده و زبانه مربوط به آن پنجره استفاده می‌شود.

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

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

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

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

آدرسی برای نمونه کیتی (kitty instance) مورد نظر جهت کنترل. متناظر با آدرسی است که از طریق گزینه --listen-on یا تنظیم listen_on در فایل kitty.conf به نمونه کیتی داده شده است. در صورت عدم تعیین، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن هم یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرایند ارسال می‌گردند؛ یعنی تنها در صورتی کار خواهند کرد که این فرایند درون یکی از پنجره‌های کیتی اجرا شده باشد.
گذرواژه‌ای برای استفاده هنگام برقراری ارتباط با کیتی. این امر باعث می‌شود که کیتی از کاربر برای انجام عملیات مشخص‌شده درخواست مجوز کند، مگر اینکه گذرواژه قبلاً پذیرفته شده باشد یا از قبل در فایل kitty.conf پیکربندی شده باشد. برای استفاده از گذرواژه خالی، گزینه --use-password را برابر با always تعیین کنید.
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به پوشه پیکربندی کیتی سنجیده می‌شوند. از - برای خواندن از ورودی استاندارد (STDIN) استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل شماره num استفاده نمایید. در صورتی استفاده می‌شود که گزینه‌ای برای --password ارائه نشده باشد. مقدار پیش‌فرض، بررسی فایل rc-pass در پوشه پیکربندی کیتی است.
نام متغیر محیطی برای خواندن گذرواژه از آن. در صورتی استفاده می‌شود که گزینه‌ای برای --password-file ارائه نشده باشد. به‌طور پیش‌فرض متغیر محیطی KITTY_RC_PASSWORD بررسی می‌شود.
اگر هیچ گذرواژه‌ای در دسترس نباشد، کیتی معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. اگر روی always تنظیم شود و هیچ گذرواژه‌ای ارائه نشده باشد، از گذرواژه خالی استفاده می‌شود.

انتخاب‌ها: if-available, always, never

July 30, 2026 0.48.2