'\" t
.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "kitten-command-palette" 1 "Jul 30, 2026" "0.48.2" "kitty"
.SH "نام (NAME)"
kitten-command-palette \- مرور و اجرای میان‌برهای صفحه‌کلید و کنش‌ها
.SH "نمای کلی (OVERVIEW)"
.sp
پالت دستورات (command palette) به شما امکان می‌دهد تمام میان‌برهای صفحه‌کلید و کنش‌ها را در \fIkitty\fP از طریق یک لایهٔ رویی (overlay) قابل جستجو مرور، جستجو و اجرا کنید. برای باز کردن آن کلیدهای \fBctrl+shift+f3\fP \%<#\:shortcut-kitty\:.Command-palette> را فشار دهید (پیش‌فرض: \fBCtrl\fP+\fBShift\fP+\fBF3\fP).
.INDENT 0.0
.INDENT 2.5
پالت دستورات که نتایج جستجو برای \fBwin close\fP را نمایش می‌دهد. (تصاویر پشتیبانی نمی‌شوند)
.UNINDENT
.UNINDENT
.sp
تمام کنش‌های نگاشت‌شده (آن‌هایی که میان‌بر صفحه‌کلید دارند) و کنش‌های نگاشت‌نشده (کنش‌های موجود ولی بدون کلید اختصاص‌یافته) بر اساس دسته‌بندی فهرست شده‌اند. نگاشت‌های ماوس در بخشی جداگانه نمایش داده می‌شوند. برای جستجو کافی است تایپ کنید، یک نتیجه را انتخاب کرده و برای اجرای آن \fBEnter\fP را فشار دهید.
.SH "جستجو (SEARCHING)"
.sp
هم‌زمان با تایپ در نوار جستجو، پالت نتایج را به‌صورت هم‌زمان فیلتر می‌کند. تطبیق نسبت به بزرگی و کوچکی حروف حساس نیست (case\-insensitive) و به‌طور هم‌زمان روی سه ستون کار می‌کند: \fBkey\fP (میان‌بر صفحه‌کلید)، نام \fBaction\fP (کنش)، و \fBcategory\fP (دسته‌بندی). نویسه‌های منطبق برجسته می‌شوند تا بتوانید دقیقاً محل تطابق هر عبارت را مشاهده کنید.
.INDENT 0.0
.TP
\fBچندین کلمه\fP
عبارت‌های خود را با فاصله از هم جدا کنید. تایپ کردن \fBscroll page\fP به‌دنبال مواردی می‌گردد که شامل \fIscroll\fP و \fIpage\fP در هر کجای ستون‌های key، action یا category باشند. مواردی که با تعداد بیشتری از عبارت‌های شما مطابقت داشته باشند، رتبهٔ بالاتری نسبت به موارد با تطابق کمتر کسب می‌کنند.
.TP
\fBنحوهٔ تطبیق کلمات جداگانه\fP
هر کلمه در پرس‌وجوی شما با تک‌تک کلمات موجود در سه ستون مقایسه می‌شود. بهترین تطابق برنده شده و امتیاز مورد را برای آن عبارت تعیین می‌کند:
.INDENT 7.0
.IP \(bu 2
\fIکلمهٔ دقیق (Exact word)\fP — کلمهٔ پرس‌وجو دقیقاً با کلمهٔ ستون برابر است (بالاترین امتیاز).
.IP \(bu 2
\fIپیشوند (Prefix)\fP — کلمهٔ ستون با کلمهٔ پرس‌وجو آغاز می‌شود؛ برای مثال \fBscr\fP با \fBscroll\fP مطابقت دارد.
.IP \(bu 2
\fIتحمل غلط املایی (Typo tolerance)\fP — برای کلمات چهار نویسه‌ای یا طولانی‌تر، یک غلط املایی (یک نویسه درج، حذف یا جایگزین شده) همچنان تطابق ایجاد می‌کند و دو غلط املایی تطابقی با امتیاز پایین‌تر می‌دهد.
.UNINDENT
.sp
یک مورد تا زمانی که دست‌کم یک کلمه از پرس‌وجو با چیزی مطابقت داشته باشد در نتایج ظاهر می‌شود. مواردی که کلمات بیشتری از پرس‌وجو با آن‌ها تطابق دارند، بالاتر از مواردی قرار می‌گیرند که تطابق کمتری دارند.
.TP
\fBنام‌های مرکب\fP
جداکننده‌هایی مانند \fB_\fP، \fB+\fP، \fB/\fP و \fB\-\fP در داخل یک کلمهٔ پرس‌وجو دست‌نخورده باقی می‌مانند، بنابراین می‌توانید نام‌های مرکب کنش‌ها را به‌عنوان یک واحد جستجو کنید. تایپ \fBmouse_selection\fP ابتدا تلاش می‌کند آن زیررشتهٔ دقیق را در هر ستون پیدا کند. اگر این کار ناموفق باشد، توکن را به بخش‌های آن (\fBmouse\fP و \fBselection\fP) تقسیم کرده و هر بخش را به‌صورت جداگانه با کلمات ستون مطابقت می‌دهد.
.TP
\fBرتبه‌بندی\fP
هنگامی که چندین مورد با یک پرس‌وجو مطابقت دارند، بر اساس موارد زیر مرتب می‌شوند:
.INDENT 7.0
.IP 1. 3
تعداد کلمات پرس‌وجو که تطابق داشته‌اند (بیشتر، بهتر است).
.IP 2. 3
امتیاز در ستون action (تطابق‌های کنش بالاتر از تطابق‌های key یا category قرار می‌گیرند).
.IP 3. 3
امتیاز در ستون key.
.IP 4. 3
امتیاز در ستون category.
.IP 5. 3
کوتاه‌تر بودن نام کنش به‌عنوان امتیاز شکنندهٔ تساوی (نتایج خاص‌تر در ابتدا).
.UNINDENT
.UNINDENT
.SH "کنترل‌های صفحه‌کلید (KEYBOARD CONTROLS)"
.sp
کلیدهای زیر هنگام باز بودن پالت دستورات در دسترس هستند:
.TS
box center;
l|l.
T{
کلید
T}	T{
کنش
T}
_
T{
هر متنی
T}	T{
فیلتر کردن نتایج با تایپ پرس‌وجوی جستجو
T}
_
T{
\fBEnter\fP
T}	T{
اجرای کنش انتخاب‌شده
T}
_
T{
\fBEscape\fP
T}	T{
پاک کردن پرس‌وجوی جستجو، یا بستن پالت در صورتی که پرس‌وجو از قبل خالی باشد
T}
_
T{
\fBUp\fP / \fBCtrl\fP+\fBK\fP / \fBCtrl\fP+\fBP\fP
T}	T{
حرکت دادن انتخاب به بالا
T}
_
T{
\fBDown\fP / \fBCtrl\fP+\fBJ\fP / \fBCtrl\fP+\fBN\fP
T}	T{
حرکت دادن انتخاب به پایین
T}
_
T{
\fBPage Up\fP
T}	T{
حرکت دادن انتخاب به اندازهٔ یک صفحه به بالا
T}
_
T{
\fBPage Down\fP
T}	T{
حرکت دادن انتخاب به اندازهٔ یک صفحه به پایین
T}
_
T{
\fBHome\fP
T}	T{
پرش به نخستین نتیجه
T}
_
T{
\fBEnd\fP
T}	T{
پرش به آخرین نتیجه
T}
_
T{
\fBBackspace\fP
T}	T{
حذف آخرین نویسه از پرس‌وجو
T}
_
T{
\fBF12\fP
T}	T{
تغییر وضعیت نمایش کنش‌های نگاشت‌نشده
T}
_
T{
کلیک ماوس
T}	T{
انتخاب و اجرای کنش کلیک‌شده
T}
.TE
.SH "کنش‌های نگاشت‌نشده (UNMAPPED ACTIONS)"
.sp
به‌طور پیش‌فرض، پالت هر دو نوع کنش‌های نگاشت‌شده (آن‌هایی که به میان‌بر متصل شده‌اند) و نگاشت‌نشده (آن‌هایی که هیچ میان‌بری به آن‌ها اختصاص داده نشده است) را نشان می‌دهد. کنش‌های نگاشت‌نشده با برچسب \fB(unmapped)\fP در ستون key ظاهر می‌شوند. کلید \fBF12\fP را فشار دهید تا وضعیت نمایش آن‌ها تغییر کند. این ترجیح در نشست‌های بعدی به یاد سپرده می‌شود.
.sp
کنش‌های نگاشت‌نشده برای کشف قابلیت‌هایی که ممکن است میان‌بری برای آن‌ها پیکربندی نکرده باشید مفید هستند. می‌توانید آن‌ها را مستقیماً از پالت اجرا کنید، یا نام کنش را یادداشت کرده و یک نگاشت در \fBkitty.conf\fP اضافه کنید.
.SH "حالت‌های سفارشی صفحه‌کلید (CUSTOM KEYBOARD MODES)"
.sp
اگر در پیکربندی خود حالت‌های سفارشی صفحه‌کلید \%<#\:modal-mappings> را تعریف کرده باشید، کلیدهای آن‌ها زیر سربرگ‌های مجزای هر حالت در پالت نمایش داده می‌شوند. نگاشت‌های \fBpush_keyboard_mode\fP با حالت مقصدی که فعال می‌کنند گروه‌بندی می‌شوند، که مشاهدهٔ نحوهٔ ورود به هر حالت را در کنار میان‌برهای آن آسان می‌سازد.
.SH "پیکربندی (CONFIGURATION)"
.sp
نگاشت پیش‌فرض برای باز کردن پالت دستورات برابر است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
map kitty_mod+f3 command_palette
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانید مانند هر نگاشت دیگری، این مورد را نیز در \fBkitty.conf\fP تغییر دهید؛ برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
map ctrl+p command_palette
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"

Kovid Goyal
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"

2026, Kovid Goyal
.\" End of generated man page.