نام (NAME)

kitten-@-set-window-title - تنظیم عنوان پنجره

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

kitten @ set-window-title [TITLE ...]

توضیحات (DESCRIPTION)

تنظیم عنوان برای پنجره‌های مشخص‌شده. اگر از گزینه --match استفاده کنید، عنوان برای تمام پنجره‌های منطبق تنظیم خواهد شد. به‌طور پیش‌فرض، فقط پنجره‌ای که دستور در آن اجرا شده است تحت تأثیر قرار می‌گیرد. اگر عنوانی را مشخص نکنید، آخرین عنوان تنظیم‌شده توسط فرایند فرزند در حال اجرا در پنجره استفاده خواهد شد.

گزینه‌ها (OPTIONS)

--temporary [=no]

به‌طور پیش‌فرض، عنوان به‌صورت دائمی تغییر خواهد کرد و برنامه‌های در حال اجرا در پنجره دیگر قادر به تغییر مجدد آن نخواهند بود. اگر می‌خواهید به سایر برنامه‌ها اجازه دهید پس از آن عنوان را تغییر دهند، از این گزینه استفاده کنید.

--match, -m

پنجره‌ای که باید تطبیق داده شود. مشخصات تطبیق به فرم 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 از بالاترین شماره شناسه به سمت پایین تطبیق می‌یابند؛ به‌ویژه -1 تازه‌ترین پنجره ایجادشده است.

فیلد num به موقعیت پنجره در زبانه (tab) جاری اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب مشابه ترتیبی است که پنجره‌ها توسط دستور 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. پنجره‌های فعال (active) پنجره‌هایی هستند که در زبانه والد خود فعال هستند. تنها یک پنجره فوکوس‌شده (focused) وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره فوکوس‌شده مطابقت داده می‌شود. مقدار focused_os_window تمام پنجره‌های موجود در پنجره سیستم‌عامل با فوکوس فعلی را تطبیق می‌دهد. مقدار self با پنجره‌ای که دستور کنترل از راه دور (remote control) در آن اجرا شده است تطبیق می‌یابد. مقدار overlay_parent پنجره‌ای را که در زیر پنجره self قرار دارد، در صورتی که پنجره self یک پنجره همپوشان (overlay) باشد، تطبیق می‌دهد.

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

--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