نام (NAME)

kitten-@-remove-marker - حذف نشانه‌گذاری‌های متن در پنجره‌های ترمینال kitty

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

kitten @ remove-marker

توضیحات (DESCRIPTION)

حذف نشانه‌گذاری (marker) فعلی تنظیم‌شده روی پنجره، در صورت وجود.

گزینه‌ها (OPTIONS)

--match, -m: پنجره مورد نظر برای تطبیق. مشخصات تطبیق به فرمت field:query هستند. که در آن field می‌تواند یکی از موارد زیر باشد: id، title، pid، cwd، cmdline، num، env، var، state، neighbor، session و recent. مقدار query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم (regex) باشند و می‌توان آن‌ها را با عملگرهای بولین ترکیب کرد.

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

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

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

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

--self [=no]: اعمال نشانه‌گذاری روی پنجره‌ای که این دستور در آن اجرا می‌شود، به‌جای پنجره فعال.
--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