.TH "kitten-@-resize-os-window" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-resize-os-window \- تغییر اندازه، نمایش، پنهان‌سازی و مدیریت پنجره‌های مشخص‌شده سیستم‌عامل
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ resize-os-window  [OS Panel settings ...]"
.YS
.SH "توضیحات (DESCRIPTION)"
تغییر اندازه (یا سایر عملیات) روی پنجره‌های مشخص‌شده سیستم‌عامل (OS Windows). توجه داشته باشید که برخی از مدیران پنجره یا محیط‌های گرافیکی (مانند مدیران پنجره کاشی‌کاری‌شده یا tiling) به برنامه‌ها اجازه تغییر اندازه پنجره‌هایشان را نمی‌دهند.
.PP
برای اصلاح پنل‌های سیستم‌عامل ایجادشده با
.BR "panel kitten" ،
از گزینه
.B \-\-action=os\-panel
استفاده کنید. تغییرات مورد نظر را با همان ساختار نحوی به‌کاررفته در
.BR "panel kitten"
و بدون خط‌تیره‌های ابتدایی مشخص کنید. از گزینه
.B \-\-incremental
برای اعمال تغییرات تنها روی تنظیمات مشخص‌شده پنل استفاده کنید. برای مثال، جهت انتقال پنل به لبه پایینی و تنظیم ارتفاع آن روی دو خط:
.PP
.nf
\-\-action=os\-panel \-\-incremental lines=2 edge=bottom
.fi
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m"
پنجره مورد نظر برای مطابقت. مشخصات مطابقت به قالب
.I field:query
هستند؛ که در آن
.I field
می‌تواند یکی از موارد زیر باشد:
.BR id ،
.BR title ،
.BR pid ،
.BR cwd ،
.BR cmdline ،
.BR num ،
.BR env ،
.BR var ،
.BR state ،
.BR neighbor ،
.B session
و
.BR recent .
مقدار
.I query
عبارتی است که باید مطابقت داده شود. این عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم (Regex) باشند و می‌توان آن‌ها را با عملگرهای بولی (Boolean) ترکیب کرد.

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

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

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

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

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

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

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

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

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

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

توجه داشته باشید که می‌توانید از دستور
.B kitten @ ls
برای دریافت فهرست پنجره‌ها استفاده کنید.
.TP
.BI "--action" " [=resize]"
عملیاتی که باید انجام شود.

انتخاب‌ها: resize, hide, os-panel, show, toggle-fullscreen, toggle-maximized, toggle-visibility
.TP
.BI "--unit" " [=cells]"
واحدی که اندازه‌های مشخص‌شده بر اساس آن تفسیر می‌شوند.

انتخاب‌ها: cells, pixels
.TP
.BI "--width" " [=0]"
تغییر عرض پنجره. مقدار صفر عرض را بدون تغییر باقی می‌گذارد.
.TP
.BI "--height" " [=0]"
تغییر ارتفاع پنجره. مقدار صفر ارتفاع را بدون تغییر باقی می‌گذارد.
.TP
.BI "--incremental" " [=no]"
در نظر گرفتن اندازه‌های مشخص‌شده به‌عنوان افزایش یا کاهش نسبت به اندازه فعلی پنجره به جای اندازه‌های مطلق. هنگام استفاده از
.BR \-\-action=os\-panel ،
تنها تنظیمات مشخص‌شده تغییر می‌یابند؛ در غیر این صورت، تنظیمات نامشخص مقادیر فعلی خود را حفظ می‌کنند.
.TP
.BI "--self" " [=no]"
تغییر اندازه پنجره‌ای که این دستور در آن اجرا می‌شود، به جای پنجره فعال.
.TP
.BI "--no-response" " [=no]"
عدم انتظار برای پاسخی که نشان‌دهنده موفقیت‌آمیز بودن عملیات باشد. توجه داشته باشید که استفاده از این گزینه به این معنی است که از خرابی‌ها و خطاهای رخ‌داده مطلع نخواهید شد.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنمای این دستور
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.TP
.BI "--to"
آدرسی برای نمونه کیتی (kitty instance) مورد نظر جهت کنترل. متناظر با آدرسی است که از طریق گزینه
.B \-\-listen\-on
یا تنظیم
.B listen_on
در فایل
.I kitty.conf
به نمونه کیتی داده شده است. در صورت عدم تعیین، متغیر محیطی
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن هم یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرایند ارسال می‌گردند؛ یعنی تنها در صورتی کار خواهند کرد که این فرایند درون یکی از پنجره‌های کیتی اجرا شده باشد.
.TP
.BI "--password"
گذرواژه‌ای برای استفاده هنگام برقراری ارتباط با کیتی. این امر باعث می‌شود که کیتی از کاربر برای انجام عملیات مشخص‌شده درخواست مجوز کند، مگر اینکه گذرواژه قبلاً پذیرفته شده باشد یا از قبل در فایل
.I kitty.conf
پیکربندی شده باشد. برای استفاده از گذرواژه خالی، گزینه
.B \-\-use\-password
را برابر با
.B always
تعیین کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به پوشه پیکربندی کیتی سنجیده می‌شوند. از
.B \-
برای خواندن از ورودی استاندارد (STDIN) استفاده کنید. از
.B fd:num
برای خواندن از توصیف‌گر فایل شماره
.I num
استفاده نمایید. در صورتی استفاده می‌شود که گزینه‌ای برای
.B \-\-password
ارائه نشده باشد. مقدار پیش‌فرض، بررسی فایل
.I rc\-pass
در پوشه پیکربندی کیتی است.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام متغیر محیطی برای خواندن گذرواژه از آن. در صورتی استفاده می‌شود که گزینه‌ای برای
.B \-\-password\-file
ارائه نشده باشد. به‌طور پیش‌فرض متغیر محیطی
.B KITTY_RC_PASSWORD
بررسی می‌شود.
.TP
.BI "--use-password" " [=if\-available]"
اگر هیچ گذرواژه‌ای در دسترس نباشد، کیتی معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. اگر روی
.B always
تنظیم شود و هیچ گذرواژه‌ای ارائه نشده باشد، از گذرواژه خالی استفاده می‌شود.

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