نام (NAME)

kitten-@-set-tab-title - تغییر عنوان تب‌های ترمینال Kitty از راه دور

خلاصه دستور (SYNOPSIS)

kitten @ set-tab-title TITLE ...

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

--match, -m

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

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

--help, -h [=no]

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

گزینه‌های عمومی (GLOBAL OPTIONS)

--to: نشانی نمونه kitty برای کنترل. متناظر با نشانی ارائه‌شده به نمونه kitty از طریق گزینه --listen-on یا تنظیم listen_on در فایل kitty.conf است. اگر مشخص نشود، متغیر محیطی 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