نام (NAME)

kitten-@-create-marker - ایجاد نشانگر برای برجسته‌سازی متن مشخص‌شده

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

kitten @ create-marker MARKER SPECIFICATION

توضیحات (DESCRIPTION)

ایجاد یک نشانگر که می‌تواند متن را در پنجره مشخص‌شده برجسته سازد. برای مثال: create_marker text 1 ERROR برای جزئیات کامل، marks را ببینید.

گزینه‌ها (OPTIONS)

--match, -m

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

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

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

فیلد num به موقعیت پنجره در زبانه فعلی اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب مشابه ترتیبی است که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسه پنجره فعلی در متغیر محیطی KITTY_WINDOW_ID در دسترس است.

فیلد recent به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد، که در آن صفر پنجره فعال فعلی، یک پنجره فعال قبلی و به همین ترتیب است.

فیلد neighbor به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد: left، right، top یا bottom باشد.

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

هنگام استفاده از فیلد env برای تطبیق بر اساس متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار را مشخص کنید؛ برای مثال: env:MY_ENV_VAR=2.

به همین ترتیب، فیلد var با متغیرهای کاربری تنظیم‌شده روی پنجره مطابقت دارد. می‌توانید مانند فیلد env نام یا نام و مقدار را مشخص کنید.

فیلد state با وضعیت پنجره مطابقت دارد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self و overlay_parent. پنجره‌های فعال پنجره‌هایی هستند که در زبانه والد خود فعال می‌باشند. تنها یک پنجره دارای فوکوس وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن ارسال می‌شوند. اگر هیچ پنجره‌ای دارای فوکوس نباشد، آخرین پنجره فوکوس‌شده مطابقت داده می‌شود. مقدار focused_os_window با تمام پنجره‌های موجود در پنجره سیستم‌عامل با فوکوس فعلی مطابقت دارد. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود مطابقت دارد. مقدار overlay_parent با پنجره‌ای که زیر پنجره self قرار دارد (هنگامی که پنجره self به صورت روکش یا پوششی است) مطابقت می‌کند.

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

--self [=no]

اعمال نشانگر بر روی پنجره‌ای که این دستور در آن اجرا می‌شود، به جای پنجره فعال.

--help, -h [=no]

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

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

--to: یک نشانی برای نمونه کیتی جهت کنترل. این نشانی مطابق با نشانی داده‌شده به نمونه کیتی از طریق گزینه --listen-on یا تنظیم listen_on در فایل kitty.conf است. در صورت مشخص نشدن، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند؛ یعنی تنها در صورتی کار خواهند کرد که این فرآیند درون یک پنجره کیتی اجرا شود.
--password: گذرواژه‌ای برای استفاده هنگام برقراری ارتباط با کیتی. این امر باعث می‌شود کیتی برای انجام اقدام مشخص‌شده از کاربر درخواست مجوز کند، مگر اینکه گذرواژه پیش‌تر پذیرفته شده باشد یا در فایل kitty.conf از قبل پیکربندی شده باشد. برای استفاده از یک گذرواژه خالی، گزینه --use-password را برابر با always مشخص کنید.
--password-file [=rc-pass]: فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به پوشه پیکربندی کیتی حل می‌شوند. از - برای خواندن از ورودی استاندارد (STDIN) استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل شماره num استفاده کنید. در صورتی که گزینه --password داده نشده باشد، استفاده می‌شود. پیش‌فرض، بررسی وجود فایل rc-pass در پوشه پیکربندی کیتی است.
--password-env [=KITTY_RC_PASSWORD]: نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورتی که گزینه --password-file داده نشده باشد، استفاده می‌شود. پیش‌فرض، بررسی متغیر محیطی KITTY_RC_PASSWORD است.
--use-password [=if-available]: اگر هیچ گذرواژه‌ای در دسترس نباشد، کیتی معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. در صورت تنظیم روی always و ارائه نشدن گذرواژه، از گذرواژه خالی استفاده می‌شود.
گزینه‌های انتخابی: if-available، always، never