kitten-@-set-spacing(1) kitten Manual kitten-@-set-spacing(1)

kitten-@-set-spacing - تنظیم فاصله‌های درونی و حاشیه‌های پنجره

kitten @ set-spacing MARGIN_OR_PADDING ...

تنظیم فاصله‌های درونی (paddings) و حاشیه‌های (margins) پنجره‌های مشخص‌شده (پیش‌فرض پنجرهٔ فعال است). برای مثال: margin=20 یا padding-left=10 یا margin-h=30. حالت کوتاه تمام مقادیر را تنظیم می‌کند و حالت‌های *-h و *-v مقادیر افقی و عمودی را مشخص می‌سازند. مقدار ویژهٔ default تنظیمات را به مقدار پیش‌فرض بازمی‌گرداند. اگر به جای پنجره یک تب را مشخص کنید، تمام پنجره‌های آن تب تحت تأثیر قرار می‌گیرند.

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

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

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

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

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

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

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

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

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

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

فیلد state با وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self، overlay_parent. پنجره‌های فعال پنجره‌هایی هستند که در تب والد خود فعال می‌باشند. تنها یک پنجره دارای فوکوس است و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای دارای فوکوس نباشد، آخرین پنجرهٔ فوکوس‌شده مطابقت داده می‌شود. مقدار 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 همان عبارتی است که باید مطابقت داده شود. عبارت‌ها می‌توانند یک عدد یا یک عبارت باقاعده باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

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

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

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

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

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

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

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

فیلد state با وضعیت تب تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused و focused_os_window. تب‌های فعال تب‌هایی هستند که در پنجرهٔ سیستم‌عامل والد خود فعال می‌باشند. تنها یک تب دارای فوکوس است و آن تبی است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ تبی فوکوس نداشته باشد، آخرین تب فوکوس‌شده تطبیق می‌یابد. مقدار focused_os_window با تمام تب‌های موجود در پنجرهٔ سیستم‌عامل دارای فوکوس فعلی مطابقت دارد.

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

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

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

گزینه‌ها: if-available، always، never

July 30, 2026 0.48.2