.TH "kitten-@-create-marker" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-create-marker \- ایجاد نشانگر برای برجسته‌سازی متن مشخص‌شده
.SH "نحوه استفاده (USAGE)"
.SY "kitten @ create-marker  MARKER SPECIFICATION"
.YS
.SH "توضیحات (DESCRIPTION)"
ایجاد یک نشانگر که می‌تواند متن را در پنجره مشخص‌شده برجسته سازد. برای مثال:
.B create_marker text 1 ERROR
برای جزئیات کامل،
.I marks
را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m"
پنجره‌ای که باید مطابقت داده شود. مشخصات تطبیق به صورت
.I field:query
است، که در آن
.I field
می‌تواند یکی از موارد زیر باشد:
.BR id ،
.BR title ،
.BR pid ،
.BR cwd ،
.BR cmdline ،
.BR num ،
.BR env ،
.BR var ،
.BR state ،
.BR neighbor ،
.B session
و
.BR recent .
مقدار
.I query
عبارتی است که باید مطابقت داده شود. عبارت‌ها می‌توانند یک عدد یا یک عبارت باقاعده باشند و می‌توان آن‌ها را با استفاده از عملگرهای بولی با یکدیگر ترکیب کرد.

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

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

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

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

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

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

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

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

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

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

توجه داشته باشید که می‌توانید از دستور
.B kitten @ ls
برای دریافت فهرستی از پنجره‌ها استفاده کنید.
.TP
.BI "--self" " [=no]"
اعمال نشانگر بر روی پنجره‌ای که این دستور در آن اجرا می‌شود، به جای پنجره فعال.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنمای این دستور
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
.BI "--to"
یک نشانی برای نمونه کیتی جهت کنترل. این نشانی مطابق با نشانی داده‌شده به نمونه کیتی از طریق گزینه
.B \-\-listen\-on
یا تنظیم
.B listen_on
در فایل
.I kitty.conf
است. در صورت مشخص نشدن، متغیر محیطی
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند؛ یعنی تنها در صورتی کار خواهند کرد که این فرآیند درون یک پنجره کیتی اجرا شود.
.TP
.BI "--password"
گذرواژه‌ای برای استفاده هنگام برقراری ارتباط با کیتی. این امر باعث می‌شود کیتی برای انجام اقدام مشخص‌شده از کاربر درخواست مجوز کند، مگر اینکه گذرواژه پیش‌تر پذیرفته شده باشد یا در فایل
.I kitty.conf
از قبل پیکربندی شده باشد. برای استفاده از یک گذرواژه خالی، گزینه
.B \-\-use\-password
را برابر با
.B always
مشخص کنید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به پوشه پیکربندی کیتی حل می‌شوند. از
.B \-
برای خواندن از ورودی استاندارد (STDIN) استفاده کنید. از
.B fd:num
برای خواندن از توصیف‌گر فایل شماره
.I num
استفاده کنید. در صورتی که گزینه
.B \-\-password
داده نشده باشد، استفاده می‌شود. پیش‌فرض، بررسی وجود فایل
.I rc\-pass
در پوشه پیکربندی کیتی است.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام یک متغیر محیطی برای خواندن گذرواژه از آن. در صورتی که گزینه
.B \-\-password\-file
داده نشده باشد، استفاده می‌شود. پیش‌فرض، بررسی متغیر محیطی
.B KITTY_RC_PASSWORD
است.
.TP
.BI "--use-password" " [=if\-available]"
اگر هیچ گذرواژه‌ای در دسترس نباشد، کیتی معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. این گزینه می‌تواند برای اجبار به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده به کار رود. در صورت تنظیم روی
.B always
و ارائه نشدن گذرواژه، از گذرواژه خالی استفاده می‌شود.

گزینه‌های انتخابی:
.BR if\-available ،
.BR always ،
.B never