نام (NAME)

kitten-@-new-window - باز کردن یک پنجره جدید در تب یا پنجره ترمینال kitty

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

kitten @ new-window [CMD ...]

توضیحات (DESCRIPTION)

منسوخ شده: به‌جای این دستور از دستور launch استفاده کنید.

یک پنجره جدید در تب مشخص‌شده باز می‌کند. اگر از گزینه --match استفاده کنید، نخستین تب منطبق به‌کار گرفته می‌شود. در غیر این صورت از تب فعال فعلی استفاده خواهد شد. شناسه (id) پنجره تازه بازشده را چاپ می‌کند (مگر اینکه از گزینه --no-response استفاده شود). هرگونه آرگومان خط فرمان به عنوان دستور برای اجرا در پنجره جدید در نظر گرفته می‌شود؛ در صورت عدم ارائه، پوسته پیش‌فرض اجرا می‌گردد. برای نمونه:

kitten @ new-window --title Email mutt

گزینه‌ها (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 تب‌هایی را که در نشست (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 برای دریافت فهرست تب‌ها استفاده کنید.

--title: عنوان پنجره جدید. به طور پیش‌فرض از عنوان تعیین‌شده توسط برنامه‌ای که درون آن اجرا می‌شود استفاده خواهد کرد.
--cwd: دایرکتوری کاری اولیه برای پنجره جدید. به طور پیش‌فرض برابر با دایرکتوری کاری فرایند kitty که با آن در ارتباط هستید قرار می‌گیرد.
--dont-take-focus, --keep-focus [=no]: حفظ فوکوس روی پنجره فعلی به جای رفتن به پنجره تازه بازشده.
--window-type [=kitty]: نوع پنجره‌ای که باید باز شود. یک پنجره kitty یا یک پنجره سطح بالای سیستم‌عامل (OS).

گزینه‌های انتخابی: kitty, os

--new-tab [=no]: باز کردن یک تب جدید.
--tab-title: تنظیم عنوان تب هنگام باز کردن یک تب جدید.
--no-response [=no]: منتظر نماندن برای پاسخی که شناسه پنجره تازه بازشده را ارائه می‌دهد. توجه داشته باشید که استفاده از این گزینه به این معنی است که از خطاها مطلع نخواهید شد و شناسه پنجره جدید چاپ نمی‌شود.
--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