.TH "kitten-@-last-used-layout" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-last-used-layout \- جابه‌جایی به آخرین چیدمان استفاده‌شده
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ last-used-layout "
.YS
.SH "توضیحات (DESCRIPTION)"
تغییر به آخرین چیدمان پنجرهٔ استفاده‌شده در زبانه‌های مشخص‌شده (یا زبانهٔ فعال در صورت تعیین نشدن).
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--all, -a" " [=no]"
تغییر چیدمان در تمامی زبانه‌ها.
.TP
.BI "--no-response" " [=no]"
منتظر پاسخ از سوی kitty نمانید. این بدان معناست که حتی در صورت پیدا نشدن زبانهٔ منطبق، دستور با وضعیت موفقیت خارج می‌شود.
.TP
.BI "--match, -m" 
زبانه‌ای که باید مطابقت داده شود. مشخصات تطبیق به صورت 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 برای تطبیق با زبانه‌ای که شامل پنجره‌ای با شناسه یا عنوان مشخص‌شده است استفاده کنید.

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

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

هنگام استفاده از فیلد 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 برای دریافت فهرستی از زبانه‌ها استفاده کنید.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنما برای این دستور.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.TP
.BI "--to" 
آدرسی برای نمونه kitty مورد نظر جهت کنترل. مطابق با آدرسی است که از طریق گزینه 
.B \-\-listen\-on
یا تنظیم 
.B listen_on
در 
.I kitty.conf
به نمونه kitty داده شده است. در صورت مشخص نشدن، متغیر محیطی 
.B KITTY_LISTEN_ON
بررسی می‌شود. در صورت پیدا نشدن آن نیز، پیام‌ها به ترمینال کنترل‌کنندهٔ این فرایند ارسال می‌شوند؛ بدین معنا که تنها در صورتی کار خواهند کرد که این فرایند درون پنجره‌ای از kitty اجرا شود.
.TP
.BI "--password" 
گذرواژه‌ای برای استفاده هنگام اتصال به kitty. این مورد باعث می‌شود kitty برای انجام عملیات مشخص‌شده از کاربر اجازه بخواهد، مگر اینکه گذرواژه قبلاً پذیرفته شده باشد یا از پیش در 
.I kitty.conf
پیکربندی شده باشد. برای استفاده از گذرواژهٔ خالی، 
.B \-\-use\-password
را روی always مشخص کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty حل می‌شوند. برای خواندن از STDIN از \- استفاده کنید. برای خواندن از توصیف‌گر فایل num از fd:num استفاده کنید. در صورت ارائه نشدن 
.B \-\-password
به کار می‌رود. پیش‌فرض، بررسی فایل 
.I rc\-pass
در دایرکتوری پیکربندی kitty است.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورت ارائه نشدن 
.B \-\-password\-file
به کار می‌رود. پیش‌فرض، بررسی متغیر محیطی 
.B KITTY_RC_PASSWORD
است.
.TP
.BI "--use-password" " [=if\-available]"
اگر هیچ گذرواژه‌ای در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژهٔ ارائه‌شده استفاده شود. در صورت تنظیم روی always و ارائه نشدن گذرواژه، گذرواژهٔ خالی استفاده می‌شود.

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