.\" 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 "kitty.conf" 5 "Jul 30, 2026" "0.48.2" "kitty" .SH "نام (NAME)" kitty.conf \- پرونده پیکربندی شبیه‌ساز ترمینال kitty .SH "بررسی اجمالی (OVERVIEW)" .sp \fIkitty\fP بسیار سفارشی‌پذیر است؛ از میان‌برهای صفحه‌کلید گرفته تا نرخ فریم رندر. در ادامه بررسی اجمالی تمام امکانات سفارشی‌سازی آمده است. .sp می‌توانید پرونده پیکربندی را درون \fIkitty\fP با فشردن \fBctrl+shift+f2\fP (\fB⌘\fP+\fB,\fP در macOS) باز کنید. اگر پرونده وجود نداشته باشد، یک \fBkitty.conf\fP حاوی توضیحات و مقادیر پیش‌فرض کامنت‌شده ایجاد می‌شود. با تغییر پرونده، پیکربندی به‌طور خودکار بارگذاری مجدد می‌شود که توسط \fBauto_reload_config\fP کنترل می‌شود. بارگذاری مجدد دستی با فشردن \fBctrl+shift+f5\fP (\fB⌃\fP+\fB⌘\fP+\fB,\fP در macOS) یا ارسال سیگنال \fBSIGUSR1\fP به \fIkitty\fP با دستور \fBkill \-SIGUSR1 $KITTY_PID\fP انجام‌پذیر است. همچنین برای نمایش پیکربندی فعلی می‌توانید \fBctrl+shift+f6\fP (\fB⌥\fP+\fB⌘\fP+\fB,\fP در macOS) را فشار دهید. .sp \fIkitty\fP پرونده پیکربندی را در مسیرهای پیکربندی سیستم‌عامل (معمولاً \fB~/.config/kitty/kitty.conf\fP) جستجو می‌کند، اما می‌توان مسیری مشخص را با گزینه \fBkitty \-\-config\fP \%<#\:cmdoption-kitty-config> منتقل کرد یا از متغیر محیطی \fBKITTY_CONFIG_DIRECTORY\fP \%<#\:envvar-KITTY_CONFIG_DIRECTORY> استفاده نمود. برای جزئیات کامل \fBkitty \-\-config\fP \%<#\:cmdoption-kitty-config> را ببینید. .sp \fBتوضیحات (کامنت‌ها)\fP با افزودن نویسه \fB#\fP در ابتدای خط ایجاد می‌شوند. این قابلیت تنها زمانی کار می‌کند که نویسه \fB#\fP نخستین نویسه خط باشد. .sp \fBشکستن خطوط\fP با شروع خط بعدی با نویسه \fB\e\fP انجام می‌شود. تمامی فاصله‌های خالی ابتدایی و نویسه \fB\e\fP حذف خواهند شد. .sp می‌توان \fBپرونده‌های پیکربندی ثانویه را درج کرد\fP با دستور \fBinclude\fP. اگر مسیر نسبی برای \fBinclude\fP استفاده شود، نسبت به مکان پرونده پیکربندی فعلی سنجیده می‌شود. متغیرهای محیطی بسط داده می‌شوند، بنابراین \fB${USER}.conf\fP در صورت \fBUSER=name\fP تبدیل به \fBname.conf\fP می‌شود. متغیر محیطی ویژه \fBKITTY_OS\fP \%<#\:envvar-KITTY_OS> برای تشخیص سیستم‌عامل در دسترس است و مقادیر \fBlinux\fP، \fBmacos\fP یا \fBbsd\fP دارد. همچنین می‌توان از \fBglobinclude\fP برای درج پرونده‌های منطبق با الگوی glob پوسته و از \fBenvinclude\fP برای درج پیکربندی از متغیرهای محیطی استفاده کرد. در نهایت، با اجرای برنامه توسط \fBgeninclude\fP می‌توان پیکربندی را به‌صورت پویا تولید کرد. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # درج other.conf include other.conf # درج پرونده‌های *.conf از تمام زیرپوشه‌های kitty.d درون دایرکتوری پیکربندی kitty globinclude kitty.d/**/*.conf # درج محتوای تمام متغیرهای محیطی که با KITTY_CONF_ شروع می‌شوند envinclude KITTY_CONF_* # اجرای اسکریپت dynamic.py واقع در دایرکتوری همین پرونده پیکربندی # و درج خروجی استاندارد :file:\(gaSTDOUT\(ga آن. اسکریپت‌های پایتون سریع‌ترین هستند # زیرا از مفسر درون‌برنامه‌ای پایتون استفاده می‌کنند، اما هر اسکریپت یا برنامه اجرایی # به هر زبانی پشتیبانی می‌شود. نشاندار کردن پرونده اسکریپت به‌عنوان قابل اجرا فراموش نشود. geninclude dynamic.py .EE .UNINDENT .UNINDENT .SH "قلم‌ها (FONTS)" .sp kitty دارای مدیریت قلم بسیار قدرتمندی است. می‌توانید قلم‌های منفرد را پیکربندی کرده و حتی قلم‌های خاصی برای نویسه‌های مشخص تعیین کنید. .INDENT 0.0 .TP .B font_family, bold_font, italic_font, bold_italic_font .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX font_family monospace bold_font auto italic_font auto bold_italic_font auto .EE .UNINDENT .UNINDENT .sp می‌توانید قلم‌های متفاوتی برای گونه‌های bold/italic/bold\-italic مشخص کنید. ساده‌ترین راه برای انتخاب قلم‌ها اجرای دستور \fBkitten choose\-fonts\fP است که یک رابط کاربری مناسب با قابلیت پیش‌نمایش و پشتیبانی از انتخاب قلم‌های متغیر و ویژگی‌های قلم ارائه می‌دهد. برای یادگیری انتخاب دستی قلم‌ها، ساختار نحوی مشخص‌کردن قلم \%<#\:font-spec-syntax> را مطالعه کنید. .INDENT 0.0 .TP .B font_size .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX font_size 11.0 .EE .UNINDENT .UNINDENT .sp اندازه قلم (بر حسب pt). .INDENT 0.0 .TP .B force_ltr .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX force_ltr no .EE .UNINDENT .UNINDENT .sp kitty از متن دوجهته (BIDI) پشتیبانی نمی‌کند، با این حال برای خطوط راست‌به‌چپ (RTL)، کلمات به‌طور خودکار راست‌به‌چپ نمایش داده می‌شوند. یعنی در یک خط RTL، کلمات \(dqHELLO WORLD\(dq در kitty به‌صورت \(dqWORLD HELLO\(dq نمایش می‌یابند، و اگر بخشی از یک رشته راست‌به‌چپ را انتخاب کنید، نویسه‌ای را دریافت می‌کنید که در صورت چپ‌به‌راست بودن رشته در آنجا قرار می‌گرفت. برای نمونه در کلمه عبری ירושלים، انتخاب نویسه‌ای که روی صفحه ם دیده می‌شود در واقع نویسه י را در بافر انتخاب می‌نویسد. رفتار پیش‌فرض kitty در ترکیب با فیلتری برای معکوس کردن ترتیب کلمات مفید است؛ با این حال اگر مایل به کار با گلیف‌های RTL باشید، کار با آن می‌تواند دشوار باشد، بنابراین این گزینه برای غیرفعال‌سازی آن ارائه شده است. علاوه بر این، این گزینه را می‌توان همراه با برنامه خط فرمان GNU FriBidi \% برای دریافت پشتیبانی BIDI استفاده کرد، زیرا kitty را مجبور می‌کند همیشه با متن به‌صورت چپ‌به‌راست (LTR) رفتار کند، چیزی که FriBidi برای ترمینال‌ها انتظار دارد. .INDENT 0.0 .TP .B symbol_map .UNINDENT .sp مقدار پیش‌فرضی ندارد. مقادیر نمونه در زیر نشان داده شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX symbol_map U+E0A0\-U+E0A3,U+E0C0\-U+E0C7 PowerlineSymbols .EE .UNINDENT .UNINDENT .sp نگاشت کدپوینت‌های یونیکد مشخص‌شده به یک قلم خاص. در صورت نیاز به رندر ویژه برای برخی نمادها، مانند Powerline، مفید است و نیاز به قلم‌های پچ‌شده را رفع می‌کند. هر کدپوینت یونیکد به قالب \fBU+\fP مشخص می‌شود. می‌توانید چندین کدپوینت را با کاما و بازه‌ها را با خط پیوند جدا کنید. این گزینه می‌تواند چندین بار مشخص شود. نحو دستور: .INDENT 0.0 .INDENT 3.5 .sp .EX symbol_map codepoints Font Family Name .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B narrow_symbols .UNINDENT .sp مقدار پیش‌فرضی ندارد. مقادیر نمونه در زیر نشان داده شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX narrow_symbols U+E0A0\-U+E0A3,U+E0C0\-U+E0C7 1 .EE .UNINDENT .UNINDENT .sp معمولاً برای نویسه‌های یونیکد ناحیه استفاده اختصاصی (Private Use) و برخی نویسه‌های نماد/dingbat، اگر نویسه با یک یا چند فاصله همراه باشد، در صورت داشتن نسبت تصویر عریض در قلم، kitty از آن سلول‌های اضافی برای رندر بزرگ‌تر نویسه استفاده می‌کند. با این گزینه می‌توانید kitty را ملزم کنید کدپوینت‌های مشخص را تنها در تعداد سلول مشخص‌شده (پیش‌فرض یک سلول) رندر کند. این گزینه می‌تواند چندین بار مشخص شود. نحو دستور: .INDENT 0.0 .INDENT 3.5 .sp .EX narrow_symbols codepoints [optionally the number of cells] .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B disable_ligatures .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX disable_ligatures never .EE .UNINDENT .UNINDENT .sp نحوه مدیریت خط‌نگاشت‌های چندنویسه‌ای (ligatures). حالت پیش‌فرض رندر همیشگی آن‌ها است. می‌توانید با \fBcursor\fP به kitty بگویید هنگام قرارگیری مکان‌نما روی آن‌ها رندر نشوند تا ویرایش آسان‌تر شود، یا با \fBalways\fP رندر آن‌ها را کلاً غیرفعال کنید. استراتژی خط‌نگاشت می‌تواند برای هر پنجره به‌طور جداگانه با قابلیت کنترل از راه دور kitty یا با تعریف میان‌برها در \fBkitty.conf\fP تنظیم شود، برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map alt+1 disable_ligatures_in active always map alt+2 disable_ligatures_in all never map alt+3 disable_ligatures_in tab cursor .EE .UNINDENT .UNINDENT .sp توجه داشته باشید این مورد به خط‌نگاشت‌های برنامه‌نویسی اشاره دارد که معمولاً با ویژگی OpenType با نام \fBcalt\fP پیاده‌سازی می‌شوند. برای غیرفعال‌سازی خط‌نگاشت‌های عمومی از گزینه \fBfont_features\fP استفاده کنید. .INDENT 0.0 .TP .B font_features .UNINDENT .sp مقدار پیش‌فرضی ندارد. مقادیر نمونه در زیر نشان داده شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX font_features none .EE .UNINDENT .UNINDENT .sp انتخاب دقیق ویژگی‌های OpenType جهت فعال یا غیرفعال‌سازی. توجه داشته باشید که برای قلم‌های اصلی، ویژگی‌ها هنگام انتخاب قلم با kitten با نام choose\-fonts قابل تعیین هستند. این تنظیم برای قلم‌های جایگزین (fallback) کاربرد دارد. .sp برخی قلم‌ها ویژگی‌های مفیدی برای ترمینال دارند. برای نمونه، Fira Code شامل ویژگی اختیاری \fBzero\fP است که شکل صفر (0) را تغییر می‌دهد تا از Ø متمایز شود. Fira Code همچنین شامل مجموعه‌های سبک‌شناسی (Stylistic Sets) با برچسب‌های \fBss01\fP تا \fBss20\fP است. .sp برای نحو دقیق استفاده از ویژگی‌های منفرد، مستندات HarfBuzz را ببینید: \%\&. .sp توجه داشته باشید که این پیکربندی با نام PostScript نمایه‌گذاری می‌شود و نه با نام خانواده قلم (font family). این قابلیت امکان تنظیم بسیار دقیق را می‌دهد؛ مثلاً غیرفعال کردن یک ویژگی در قلم italic بدون تأثیر بر قلم regular. .sp در لینوکس، ویژگی‌های قلم ابتدا از پایگاه داده FontConfig خوانده شده و سپس این گزینه اعمال می‌شود؛ بنابراین می‌توان آن‌ها را در مکانی واحد و مرکزی پیکربندی کرد. .sp برای دریافت نام PostScript قلم، از دستور \fBfc\-scan file.ttf\fP در لینوکس یا ابزار Font Book در macOS استفاده کنید \%\&. .sp فعال‌سازی صفر جایگزین و ارقام سبک قدیم: .INDENT 0.0 .INDENT 3.5 .sp .EX font_features FiraCode\-Retina +zero +onum .EE .UNINDENT .UNINDENT .sp فعال‌سازی فقط صفر جایگزین در قلم bold: .INDENT 0.0 .INDENT 3.5 .sp .EX font_features FiraCode\-Bold +zero .EE .UNINDENT .UNINDENT .sp غیرفعال‌سازی خط‌نگاشت‌های عادی با حفظ ویژگی \fBcalt\fP که (در این قلم) یکنواختی را از بین می‌برد: .INDENT 0.0 .INDENT 3.5 .sp .EX font_features TT2020StyleB\-Regular \-liga +calt .EE .UNINDENT .UNINDENT .sp همراه با \fBforce_ltr\fP، ممکن است بخواهید اتصال حروف عربی (shaping) را کاملاً غیرفعال کنید تا فقط اشکال مجزا نمایش یابند. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX font_features UnifontMedium +isol \-medi \-fina \-init .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B modify_font .UNINDENT .sp تغییر ویژگی‌های قلم مانند موقعیت یا ضخامت خط زیرین (underline) و خط‌خورده (strikethrough). پسوند \fBpx\fP نشان‌دهنده پیکسل و \fB%\fP نشان‌دهنده درصد مقدار اصلی است. عدم وجود پسوند به معنی واحد pt است. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX modify_font underline_position \-2 modify_font underline_thickness 150% modify_font strikethrough_thickness 200% modify_font strikethrough_position 2px .EE .UNINDENT .UNINDENT .sp علاوه بر این، می‌توانید اندازه سلولی که هر گلیف قلم در آن رندر می‌شود و خط مبنا (baseline) قرارگیری گلیف در سلول را تغییر دهید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX modify_font cell_width 80% modify_font cell_height \-2px modify_font baseline 3 .EE .UNINDENT .UNINDENT .sp توجه کنید که تغییر خط مبنا، موقعیت خط زیرین و خط‌خورده را به همان میزان تنظیم می‌کند. افزایش خط مبنا گلیف‌ها را در سلول بالاتر می‌برد و کاهش آن، گلیف‌ها را پایین‌تر می‌آورد. کاهش اندازه سلول ممکن است خطاهای گرافیکی رندر ایجاد کند؛ با احتیاط استفاده شود. .INDENT 0.0 .TP .B box_drawing_scale .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX box_drawing_scale 0.001, 1, 1.5, 2 .EE .UNINDENT .UNINDENT .sp اندازه خطوط استفاده‌شده برای نویسه‌های یونیکد رسم جعبه (box drawing). این مقادیر بر حسب pt هستند و بر اساس DPI نمایشگر به پیکسل مقیاس‌بندی می‌شوند. باید چهار مقدار متناظر با خطوط نازک، معمولی، ضخیم و خیلی ضخیم مشخص شوند. .INDENT 0.0 .TP .B undercurl_style .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX undercurl_style thin\-sparse .EE .UNINDENT .UNINDENT .sp سبک رندر خطوط موج‌دار زیرین (undercurl). این گزینه به صورت \fB(thin|thick)\-(sparse|dense)\fP مقدار می‌گیرد. گزینه‌های Thin و thick ضخامت موج را کنترل می‌کنند. گزینه‌های Sparse و dense بسامد نوسان موج را کنترل می‌کنند. در حالت sparse موج به ازای هر نویسه یک قله و در dense دو قله خواهد داشت. تغییر پویای این گزینه با بارگذاری مجدد پیکربندی یا کنترل از راه دور تعریف‌نشده است. .INDENT 0.0 .TP .B underline_exclusion .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX underline_exclusion 1 .EE .UNINDENT .UNINDENT .sp به‌طور پیش‌فرض kitty در خطوط زیرین در محل تداخل با دنباله پایین حروف (descenderها، مانند بخش پایینی در y، q، p و غیره) فاصله ایجاد می‌کند. این گزینه ضخامت این فاصله‌ها را کنترل می‌کند. می‌تواند عددی بدون واحد (کسری از ضخامت خط زیرین مشخص‌شده در قلم) باشد یا دارای پسوند \fBpx\fP برای پیکسل یا \fBpt\fP برای پوینت باشد. برای غیرفعال‌سازی این فاصله مقدار را صفر بگذارید. تغییر پویای این گزینه از طریق بارگذاری مجدد پیکربندی یا کنترل از راه دور تعریف‌نشده است. .INDENT 0.0 .TP .B text_composition_strategy .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX text_composition_strategy platform .EE .UNINDENT .UNINDENT .sp کنترل نحوه ترکیب گلیف‌های متن روی رنگ پس‌زمینه توسط kitty. مقدار پیش‌فرض \fBplatform\fP تلاش می‌کند رندر متن تا حد امکان نزدیک به حالت بومی (native) پلتفرمی باشد که kitty روی آن اجرا می‌شود. .sp مقدار \fBlegacy\fP از روش قدیمی (پیش از kitty 0.28) برای ترکیب گلیف‌ها استفاده می‌کند. این کار متن تیره روی پس‌زمینه روشن را ضخیم‌تر و متن روشن روی پس‌زمینه تیره را نازک‌تر نشان می‌دهد؛ همچنین ممکن است در برخی متون خطوط ناهموار به نظر برسند. .sp می‌توانید منحنی کنتراست واقعی مورد استفاده برای ترکیب گلیف‌ها را با تعیین حداکثر دو عدد جداشده با فاصله تنظیم دقیق کنید. .sp عدد نخست تنظیم گاما است که ضخامت متن تیره روی پس‌زمینه روشن را کنترل می‌کند. افزایش مقدار، متن را ضخیم‌تر می‌کند. مقدار پیش‌فرض آن در لینوکس \fB1.0\fP و در macOS برابر \fB1.7\fP است. مقادیر مجاز \fB0.01\fP و بالاتر هستند. نتیجه بر اساس تفاوت روشنایی (luminance) پس‌زمینه و پیش‌زمینه مقیاس‌بندی می‌شود؛ متن تیره روی پس‌زمینه روشن بیشترین تأثیر را از منحنی می‌گیرد، در حالی که متن روشن روی پس‌زمینه تیره تأثیر بسیار کمی می‌پذیرد. .sp عدد دوم کنتراست ضربی اضافی است؛ درصدی از \fB0\fP تا \fB100\fP\&. مقدار پیش‌فرض در لینوکس \fB0\fP و در macOS برابر \fB30\fP است. .sp برای دستیابی به ضخامت ظاهری مشابه در پوسته‌های روشن و تیره، نقطه شروع مناسب مقدار \fB1.0 0\fP روی پوسته تیره است. سپس پارامتر دوم را تا رسیدن به ظاهر مطلوب تنظیم کنید. پس از آن به پوسته روشن رفته و پارامتر اول را طوری تغییر دهید که ضخامت متن با پوسته تیره هماهنگ شود. .INDENT 0.0 .TP .B text_fg_override_threshold .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX text_fg_override_threshold 0 .EE .UNINDENT .UNINDENT .sp تنظیمی برای جلوگیری از کنتراست پایین میان رنگ‌های پیش‌زمینه و پس‌زمینه. هنگام کار با برنامه‌هایی که رنگ‌های ناسازگار با طرح رنگی انتخابی دارند کاربرد دارد. مقدار پیش‌فرض \fB0\fP است، به معنی عدم بازنویسی رنگ‌ها. دو حالت عملکردی وجود دارد: .sp مقداری با پسوند \fBratio\fP نشان‌دهنده حداقل نسبت کنتراست پذیرفته‌شده میان رنگ پیش‌زمینه و پس‌زمینه است. مقادیر مجاز از \fB0.0 ratio\fP تا \fB21.0 ratio\fP هستند. برای نمونه، جهت انطباق با سطح AA در استانداردهای WCAG \% مقدار \fB4.5 ratio\fP مناسب است. این الگوریتم با HSLuv \% پیاده‌سازی شده که روشنایی ادراک‌شده رنگ را دقیقاً به میزان لازم و بدون تغییر فام و اشباع تنظیم می‌کند. .sp مقداری با پسوند \fB%\fP نشان‌دهنده حداقل تفاوت روشنایی پذیرفته‌شده میان رنگ پیش‌زمینه و پس‌زمینه است که در مقادیر کمتر از آن، kitty رنگ پیش‌زمینه را بازنویسی می‌کند؛ درصدی از \fB0 %\fP تا \fB100 %\fP\&. اگر تفاوت روشنایی کمتر از این آستانه باشد، رنگ پیش‌زمینه برای پس‌زمینه‌های تیره روی سفید و برای پس‌زمینه‌های روشن روی سیاه تنظیم خواهد شد. .sp هشدار: برخی برنامه‌ها از نویسه‌ها (مانند نویسه‌های بلوکی) برای نمایش گرافیکی استفاده کرده و انتظار دارند پیش‌زمینه و پس‌زمینه را روی رنگ یکسان (یا مشابه) تنظیم کنند. در صورت مشاهده راه‌راه‌ها، نقاط، خطوط غیرمنتظره، رنگ نادرست، عدم نمایش رنگ مورد انتظار یا هرگونه اشکال در نمایش گرافیکی، مقدار \fBtext_fg_override_threshold\fP را روی \fB0\fP قرار دهید تا ریشه مشکل مشخص شود، یا از حالت \fBratio\fP به جای حالت \fB%\fP استفاده کنید. .SH "سفارشی‌سازی مکان‌نمای متن (Text cursor customization)" .INDENT 0.0 .TP .B cursor .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor #cccccc .EE .UNINDENT .UNINDENT .sp رنگ پیش‌فرض مکان‌نمای متن. در صورت تنظیم روی مقدار ویژهٔ \fBnone\fP، مکان‌نما با جلوهٔ «وارونگی تصویر» (\(dqreverse video\(dq) ترسیم می‌شود. رنگ آن رنگِ متن سلولی خواهد بود که روی آن قرار دارد و متن نیز با رنگ پس‌زمینهٔ سلول نمایش داده می‌شود. توجه داشته باشید که اگر برنامهٔ در حال اجرا در ترمینال رنگ مکان‌نما را تعیین کند، اولویت با آن خواهد بود. همچنین در صورت کنتراست بسیار کم میان رنگ پس‌زمینه و پیش‌زمینهٔ سلول، رنگ‌های مکان‌نما اصلاح می‌شوند. توجه داشته باشید که برخی پوسته‌ها این مقدار را تنظیم می‌کنند؛ بنابراین برای بازنویسی آن، مقدار خود را بعد از خطوط گنجاندن پروندهٔ پوسته قرار دهید. .INDENT 0.0 .TP .B cursor_text_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_text_color #111111 .EE .UNINDENT .UNINDENT .sp رنگ متنِ زیر مکان‌نما. اگر می‌خواهید با رنگ پس‌زمینهٔ سلول زیرین رندر شود، از کلیدواژهٔ ویژهٔ \fIbackground\fP\& استفاده کنید. توجه داشته باشید در صورتی که \fBcursor\fP روی \fBnone\fP تنظیم شده باشد، این گزینه نادیده گرفته می‌شود. همچنین برخی پوسته‌ها این مقدار را تعیین می‌کنند، بنابراین برای بازنویسی آن، مقدار خود را بعد از خطوط مربوط به پوسته قرار دهید. .INDENT 0.0 .TP .B cursor_shape .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_shape block .EE .UNINDENT .UNINDENT .sp شکل مکان‌نما می‌تواند یکی از مقادیر \fBblock\fP، \fBbeam\fP یا \fBunderline\fP\& باشد. توجه داشته باشید که هنگام بارگذاری مجدد پیکربندی، این مقدار تنها در صورتی تغییر می‌کند که شکل مکان‌نما توسط برنامهٔ در حال اجرا در ترمینال تنظیم نشده باشد. این گزینه شکل پیش‌فرض مکان‌نما را تعیین می‌کند و برنامه‌های ترمینال می‌توانند آن را بازنویسی کنند. به‌ویژه یکپارچه‌سازی پوسته \%<#\:shell-integration> در kitty شکل مکان‌نما را در اعلان خط فرمان به \fBbeam\fP تغییر می‌دهد. می‌توانید با تنظیم \fBshell_integration\fP به \fBno\-cursor\fP\& از این رفتار جلوگیری کنید. .INDENT 0.0 .TP .B cursor_shape_unfocused .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_shape_unfocused hollow .EE .UNINDENT .UNINDENT .sp شکل مکان‌نمای متن را هنگامی که پنجرهٔ سیستم‌عامل فوکوس ندارد تعیین می‌کند. شکل مکان‌نمای بدون فوکوس می‌تواند یکی از مقادیر \fBblock\fP، \fBbeam\fP، \fBunderline\fP، \fBhollow\fP و \fBunchanged\fP (بدون تغییر ماندن شکل مکان‌نما) باشد. .INDENT 0.0 .TP .B cursor_beam_thickness .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_beam_thickness 1.5 .EE .UNINDENT .UNINDENT .sp ضخامت مکان‌نمای خطی (beam) بر حسب پوینت (pts). .INDENT 0.0 .TP .B cursor_underline_thickness .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_underline_thickness 2.0 .EE .UNINDENT .UNINDENT .sp ضخامت مکان‌نمای خط زیرین (underline) بر حسب پوینت (pts). .INDENT 0.0 .TP .B cursor_blink_interval .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_blink_interval \-1 .EE .UNINDENT .UNINDENT .sp بازهٔ زمانی چشمک‌زدن مکان‌نما (بر حسب ثانیه). برای غیرفعال کردن چشمک‌زدن، روی صفر تنظیم کنید. مقادیر منفی به معنای استفاده از پیش‌فرض سیستم است. توجه داشته باشید که کمینهٔ این بازه به \fBrepaint_delay\fP\& محدود خواهد شد. همچنین می‌توانید با تعیین یک تابع گذار \%<#\:term-easing-function>\& به چشمک‌زدن پویانمایی بدهید. برای نمونه، تنظیم این گزینه روی \fB0.5 ease\-in\-out\fP باعث می‌شود چشمک‌زدن در طول یک ثانیه پویانمایی شود؛ در نیم ثانیه اول از کدر به شفاف و در نیم ثانیه بعدی به حالت اول بازگردد. می‌توانید توابع گذار متفاوتی را برای دو نیمه مشخص کنید، مانند: \fB\-1 linear ease\-out\fP\&. برنامهٔ kitty از تمام توابع گذار CSS \%\& پشتیبانی می‌کند. توجه داشته باشید که فعال‌سازی پویانمایی مصرف انرژی را افزایش می‌دهد زیرا صفحه در هر بازهٔ چشمک‌زدن چندین بار بازترسیم می‌شود. همچنین ببینید: \fBcursor_stop_blinking_after\fP\&. این تنظیم متن‌های چشمک‌زن را نیز که دقیقا همگام با مکان‌نما چشمک می‌زنند کنترل می‌کند. .INDENT 0.0 .TP .B cursor_stop_blinking_after .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_stop_blinking_after 15.0 .EE .UNINDENT .UNINDENT .sp توقف چشمک‌زدن مکان‌نما پس از تعداد ثانیه‌های مشخص عدم فعالیت صفحه‌کلید. مقدار صفر باعث می‌شود چشمک‌زدن هرگز متوقف نشود. این تنظیم بر متن‌های چشمک‌زن نیز اثر می‌گذارد و با همان ریتم مکان‌نما چشمک می‌زنند. .INDENT 0.0 .TP .B cursor_trail .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_trail 0 .EE .UNINDENT .UNINDENT .sp تنظیم این گزینه روی مقداری بزرگ‌تر از صفر، پویانمایی «رد مکان‌نما» (\(dqcursor trail\(dq) را فعال می‌کند. این پویانمایی «ردی» را به دنبال حرکت مکان‌نمای متن نمایش می‌دهد که دنبال کردن جهش‌های بزرگ مکان‌نما را ساده‌تر کرده و جلوهٔ بصری جذابی ایجاد می‌کند. مقدار این گزینه مشخص می‌کند که پویانمایی چه زمانی فعال شود (بر حسب میلی‌ثانیه). پویانمایی رد تنها برای مکان‌نماهایی اعمال می‌شود که بیش از این تعداد میلی‌ثانیه در جای خود ثابت مانده باشند. این کار از ایجاد رد هنگام به‌روزرسانی سریع رابط کاربری در برنامه‌های پیچیده جلوگیری می‌کند. برای کنترل سرعت پویانمایی به \fBcursor_trail_decay\fP و برای کنترل آستانهٔ شروع رد به \fBcursor_trail_start_threshold\fP مراجعه کنید. .INDENT 0.0 .TP .B cursor_trail_decay .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_trail_decay 0.1 0.4 .EE .UNINDENT .UNINDENT .sp مدت زمان محو شدن اثر رد مکان‌نما را در صورت فعال بودن \fBcursor_trail\fP کنترل می‌کند. این گزینه دو مقدار اعشاری مثبت دریافت می‌کند که کمترین و بیشترین زمان محو شدن را بر حسب ثانیه مشخص می‌کنند. مقدار اول مربوط به سریع‌ترین زمان محو شدن (کمینه) و مقدار دوم مربوط به کندترین زمان (بیشینه) است. مقدار دوم باید مساوی یا بزرگ‌تر از مقدار اول باشد. مقادیر کوچک‌تر باعث محو شدن سریع‌تر رد مکان‌نما می‌شوند. این مقادیر را برای کنترل سرعت محو شدن رد مکان‌نما تنظیم کنید. .INDENT 0.0 .TP .B cursor_trail_start_threshold .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_trail_start_threshold 2 .EE .UNINDENT .UNINDENT .sp آستانهٔ مسافت برای شروع رد مکان‌نما. این گزینه یک یا دو مقدار عدد صحیح مثبت می‌پذیرد. در صورت تعیین یک مقدار، همان آستانه برای هر دو جهت افقی (x) و عمودی (y) اعمال می‌شود. در صورت تعیین دو مقدار، مقدار اول آستانهٔ افقی و مقدار دوم آستانهٔ عمودی است. این مقادیر حداقل تعداد سلول‌هایی هستند که مکان‌نما باید در هر راستا حرکت کند تا پویانمایی رد فعال شود. اگر حرکت مکان‌نما در هر دو جهت کمتر از آستانه باشد، پویانمایی رد اعمال نمی‌شود تا از پویانمایی‌های غیرضروری جلوگیری شود. .INDENT 0.0 .TP .B cursor_trail_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cursor_trail_color none .EE .UNINDENT .UNINDENT .sp تنظیم رنگ رد مکان‌نما هنگامی که \fBcursor_trail\fP فعال است. اگر روی \(aqnone\(aq (پیش‌فرض) تنظیم شود، رد مکان‌نما از رنگ پس‌زمینهٔ مکان‌نما استفاده می‌کند. در غیر این صورت، یک مقدار رنگ (مانند #ff0000 برای قرمز یا نام یک رنگ مانند \(aqred\(aq) تعیین کنید. این امکان اجازه می‌دهد ظاهر رد مکان‌نما را مستقل از رنگ خود مکان‌نما سفارشی‌سازی کنید. .SH "پیمایش به عقب (Scrollback)" .INDENT 0.0 .TP .B scrollback_lines .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollback_lines 2000 .EE .UNINDENT .UNINDENT .sp تعداد خطوط پیشینه که برای پیمایش به عقب در حافظه نگهداری می‌شوند. حافظه بر حسب نیاز تخصیص می‌یابد. اعداد منفی به معنای پیمایش نامحدود هستند. توجه داشته باشید که تعیین مقادیر بسیار بزرگ توصیه نمی‌شود چون می‌تواند کارایی ترمینال را کاهش داده و مقدار زیادی حافظهٔ رم مصرف کند. به جای آن، استفاده از \fBscrollback_pager_history_size\fP\& را مد نظر قرار دهید. توجه کنید که در بارگذاری مجدد پیکربندی، تغییر این گزینه تنها پنجره‌های تازه ایجاد شده را تحت تأثیر قرار می‌دهد، نه پنجره‌های موجود را. .INDENT 0.0 .TP .B scrollbar .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar scrolled .EE .UNINDENT .UNINDENT .sp کنترل زمان نمایش نوار پیمایش. .INDENT 0.0 .TP .B \fBscrolled\fP به معنای نمایش هنگام آغاز پیمایش به عقب است. .TP .B \fBhovered\fP به معنای نمایش هنگام قرار گرفتن اشاره‌گر موشواره روی لبهٔ راست پنجره است. .TP .B \fBscrolled\-and\-hovered\fP به معنای نمایش هنگامی است که موشواره روی ناحیهٔ نوار پیمایش قرار دارد \fIو\fP پیمایش به عقب آغاز شده باشد. .TP .B \fBalways\fP به معنای نمایش دائمی هر زمان که تاریخچهٔ پیمایشی وجود داشته باشد. .TP .B \fBnever\fP به معنای غیرفعال کردن نوار پیمایش است. .UNINDENT .INDENT 0.0 .TP .B scrollbar_interactive .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_interactive yes .EE .UNINDENT .UNINDENT .sp در صورت غیرفعال بودن، نوار پیمایش توسط موشواره قابل کنترل نخواهد بود و تمام رویدادهای موشواره از نوار پیمایش عبور می‌کنند. .INDENT 0.0 .TP .B scrollbar_jump_on_click .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_jump_on_click yes .EE .UNINDENT .UNINDENT .sp هنگام فعال بودن، کلیک روی مسیر نوار پیمایش باعث پرش موقعیت پیمایش به محل کلیک می‌شود؛ در غیر این صورت، موقعیت پیمایش تنها به اندازهٔ یک صفحه به سمت آن نقطه حرکت می‌کند (رفتار سنتی نوارهای پیمایش). .INDENT 0.0 .TP .B scrollbar_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_width 0.5 .EE .UNINDENT .UNINDENT .sp عرض نوار پیمایش بر حسب واحد عرض سلول. .INDENT 0.0 .TP .B scrollbar_hover_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_hover_width 1 .EE .UNINDENT .UNINDENT .sp عرض نوار پیمایش هنگامی که موشواره روی آن قرار دارد، بر حسب واحد عرض سلول. .INDENT 0.0 .TP .B scrollbar_handle_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_handle_opacity 0.5 .EE .UNINDENT .UNINDENT .sp میزان کدر بودن دستگیرهٔ نوار پیمایش؛ 0 کاملاً شفاف و 1 کاملاً کدر. .INDENT 0.0 .TP .B scrollbar_radius .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_radius 0.3 .EE .UNINDENT .UNINDENT .sp شعاع (انحنای) دستگیرهٔ نوار پیمایش بر حسب واحد عرض سلول. باید کمتر از \fBscrollbar_width\fP\& باشد. .INDENT 0.0 .TP .B scrollbar_gap .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_gap 0.1 .EE .UNINDENT .UNINDENT .sp فاصلهٔ میان نوار پیمایش و لبهٔ پنجره بر حسب واحد عرض سلول. .INDENT 0.0 .TP .B scrollbar_min_handle_height .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_min_handle_height 1 .EE .UNINDENT .UNINDENT .sp حداقل ارتفاع دستگیرهٔ نوار پیمایش بر حسب واحد ارتفاع سلول. از بیش از حد کوچک شدن دستگیره هنگام وجود تاریخچهٔ پیمایش طولانی جلوگیری می‌کند. .INDENT 0.0 .TP .B scrollbar_hitbox_expansion .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_hitbox_expansion 0.25 .EE .UNINDENT .UNINDENT .sp ناحیهٔ اضافی اطراف دستگیره برای گرفتن آسان‌تر نوار پیمایش بر حسب واحد عرض سلول. .INDENT 0.0 .TP .B scrollbar_track_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_track_opacity 0 .EE .UNINDENT .UNINDENT .sp میزان کدر بودن مسیر نوار پیمایش؛ 0 کاملاً شفاف و 1 کاملاً کدر. .INDENT 0.0 .TP .B scrollbar_track_hover_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_track_hover_opacity 0.1 .EE .UNINDENT .UNINDENT .sp میزان کدر بودن مسیر نوار پیمایش هنگامی که موشواره روی نوار پیمایش است؛ 0 کاملاً شفاف و 1 کاملاً کدر. .INDENT 0.0 .TP .B scrollbar_handle_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_handle_color foreground .EE .UNINDENT .UNINDENT .sp رنگ دستگیرهٔ نوار پیمایش. مقدار \fBforeground\fP به معنای استفاده از رنگ پیش‌زمینهٔ متن جاری و مقدار \fBselection_background\fP به معنای استفاده از رنگ پس‌زمینهٔ متن انتخاب‌شده است. همچنین می‌توانید از رنگ‌های دلخواه مانند \fB#12af59\fP یا \fBred\fP\& استفاده کنید. .INDENT 0.0 .TP .B scrollbar_track_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollbar_track_color foreground .EE .UNINDENT .UNINDENT .sp رنگ مسیر نوار پیمایش. مقدار \fBforeground\fP به معنای استفاده از رنگ پیش‌زمینهٔ متن جاری و مقدار \fBselection_background\fP به معنای استفاده از رنگ پس‌زمینهٔ متن انتخاب‌شده است. همچنین می‌توانید از رنگ‌های دلخواه مانند \fB#12af59\fP یا \fBred\fP\& استفاده کنید. .INDENT 0.0 .TP .B progress_bar .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX progress_bar top .EE .UNINDENT .UNINDENT .sp هنگامی که برنامه‌ای از توالی گریز OSC 9;4 برای گزارش پیشرفت استفاده می‌کند، یک نوار پیشرفت در موقعیت مشخص‌شده از پنجره رسم می‌شود. این نوار از تنظیمات سبک و رنگ مشابه نوار پیمایش استفاده می‌کند. .INDENT 0.0 .TP .B \fBleft\fP نوار پیشرفت عمودی روی لبهٔ چپ .TP .B \fBright\fP نوار پیشرفت عمودی روی لبهٔ راست .TP .B \fBtop\fP نوار پیشرفت افقی روی لبهٔ بالا .TP .B \fBbottom\fP نوار پیشرفت افقی روی لبهٔ پایین .TP .B \fBhidden\fP عدم نمایش نوار پیشرفت .UNINDENT .INDENT 0.0 .TP .B scrollback_pager .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollback_pager less \-\-chop\-long\-lines \-\-RAW\-CONTROL\-CHARS +INPUT_LINE_NUMBER .EE .UNINDENT .UNINDENT .sp برنامه‌ای که پیشینهٔ پیمایش با آن در پنجره‌ای جدید مشاهده می‌شود. میانگیر پیشینه به عنوان STDIN به این برنامه ارسال می‌شود. در صورت تغییر آن، اطمینان حاصل کنید که برنامهٔ مورد نظر توانایی پردازش توالی‌های گریز ANSI برای رنگ‌ها و قالب‌بندی متن را داشته باشد. متغیر INPUT_LINE_NUMBER در خط فرمان بالا با یک عدد صحیح که نشان‌دهندهٔ خط بالای صفحه است جایگزین خواهد شد. به همین ترتیب CURSOR_LINE و CURSOR_COLUMN با موقعیت فعلی مکان‌نما جایگزین می‌شوند یا در صورت نبود مکان‌نما (مثلاً هنگام نمایش خروجی آخرین دستور) روی 0 تنظیم می‌گردند. .sp اگر ترجیح می‌دهید از neovim برای مشاهدهٔ پیشینهٔ پیمایش استفاده کنید، تنظیمی شبیه به این به کار ببرید: .INDENT 0.0 .INDENT 3.5 .sp .EX scrollback_pager nvim \-\-cmd \(aqset eventignore=FileType\(aq +\(aqnnoremap q ZQ\(aq +\(aqcall nvim_open_term(0, {})\(aq +\(aqset nomodified nolist\(aq +\(aq$\(aq \- .EE .UNINDENT .UNINDENT .sp دستور بالا برای neovim 0.12 و نسخه‌های جدیدتر کار می‌کند. همچنین یک افزونهٔ اختصاصی به نام kitty\-scrollback.nvim \% وجود دارد که امکانات بیشتری ارائه داده و با نسخه‌های قدیمی‌تر neovim نیز سازگار است. .INDENT 0.0 .TP .B scrollback_pager_history_size .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollback_pager_history_size 0 .EE .UNINDENT .UNINDENT .sp اندازه تاریخچه پیمایش به عقب مجزا (به مگابایت)، که تنها برای مرور بافر پیمایش به عقب با صفحه‌بند (pager) استفاده می‌شود. این بافر مجزا برای پیمایش تعاملی در دسترس نیست اما هنگام مشاهده بافر پیمایش به عقب در پنجره‌ای جداگانه، به برنامه صفحه‌بند هدایت (pipe) می‌شود. پیاده‌سازی فعلی داده‌ها را به صورت UTF\-8 ذخیره می‌کند، بنابراین برای متن اسکی خالص و بدون قالب‌بندی، به ازای هر ۱۰۰ نویسه در هر خط، تقریباً ۱۰۰۰۰ خط در هر مگابایت خواهد بود. مقدار صفر یا کمتر این قابلیت را غیرفعال می‌کند. حداکثر اندازه مجاز 4GB است. توجه داشته باشید که در صورت بارگذاری مجدد پیکربندی، تغییر این مقدار تنها روی پنجره‌های تازه‌ساخته‌شده اثر می‌گذارد، نه پنجره‌های موجود. .INDENT 0.0 .TP .B scrollback_fill_enlarged_window .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX scrollback_fill_enlarged_window no .EE .UNINDENT .UNINDENT .sp پر کردن فضای جدید با خطوط بافر پیمایش به عقب پس از بزرگ‌کردن پنجره. .INDENT 0.0 .TP .B wheel_scroll_multiplier .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX wheel_scroll_multiplier 5.0 .EE .UNINDENT .UNINDENT .sp ضریب تعداد خطوط پیمایش‌شده با چرخک موشواره. توجه داشته باشید این مورد تنها برای دستگاه‌های پیمایش با دقت پایین استفاده می‌شود، نه دستگاه‌های پیمایش با دقت بالا در بسترهایی چون macOS و Wayland. برای تغییر جهت پیمایش از اعداد منفی استفاده کنید. همچنین \fBwheel_scroll_min_lines\fP را ببینید. .INDENT 0.0 .TP .B wheel_scroll_min_lines .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX wheel_scroll_min_lines 1 .EE .UNINDENT .UNINDENT .sp حداقل تعداد خطوط پیمایش‌شده با چرخک موشواره. \fBscroll multiplier\fP تنها پس از رسیدن به این تعداد اعمال می‌شود. توجه داشته باشید این گزینه تنها برای دستگاه‌های پیمایش با دقت پایین نظیر موشواره‌های چرخک‌دار که هنگام استفاده از چرخک به میزان بسیار کمی پیمایش می‌کنند، کاربرد دارد. با مقدار منفی، حداقل تعداد خطوط همیشه افزوده خواهد شد. .INDENT 0.0 .TP .B touch_scroll_multiplier .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX touch_scroll_multiplier 1.0 .EE .UNINDENT .UNINDENT .sp ضریب تعداد خطوط پیمایش‌شده با تاچ‌پد. توجه داشته باشید این گزینه تنها برای دستگاه‌های پیمایش با دقت بالا در بسترهایی چون macOS و Wayland استفاده می‌شود. برای تغییر جهت پیمایش از اعداد منفی استفاده کنید. .INDENT 0.0 .TP .B pixel_scroll .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX pixel_scroll yes .EE .UNINDENT .UNINDENT .sp فعال‌سازی پیمایش پیکسل‌به‌پیکسل در بافر پیمایش به عقب kitty هنگام استفاده از دستگاه‌های ورودی با دقت بالا (برای نمونه تاچ‌پدها). در صورت فعال بودن، پیمایش به عقب خود kitty به‌جای خطوط کامل، با گام‌های کسری از خط جابه‌جا می‌شود. این تنظیم بر برنامه‌های در حال اجرا درون ترمینال (مثلاً TUIهای تمام‌صفحه) که پیمایش را خود مدیریت می‌کنند، اثر نمی‌گذارد. .INDENT 0.0 .TP .B momentum_scroll .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX momentum_scroll 0.96 .EE .UNINDENT .UNINDENT .sp میزان اصطکاک اعمال‌شده برای کند کردن پیمایش لختی (اینرسیایی). عددی از 0 تا 1، که در آن 0 به معنی عدم پیمایش لختی و 1 به معنی پیمایش نامحدود است. توجه داشته باشید این تنظیم تنها روی بسترهایی نظیر Wayland اعمال می‌شود که پیمایش لختی بومی ارائه نمی‌دهند. در macOS از پیمایش لختی بومی سیستم‌عامل استفاده می‌شود. همچنین، پیمایش لختی تنها به دستگاه‌های مبتنی بر «انگشت» نظیر تاچ‌پدها و نمایشگرهای لمسی اعمال می‌شود. تغییرات این تنظیم تنها پس از راه‌اندازی مجدد kitty اعمال خواهند شد. .SH "موشواره (MOUSE)" .INDENT 0.0 .TP .B mouse_hide_wait .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_hide_wait 3.0 .EE .UNINDENT .UNINDENT .sp پنهان‌سازی نشانگر موشواره پس از گذشت تعداد ثانیه‌های مشخص‌شده در صورت عدم استفاده از موشواره. برای غیرفعال کردن پنهان‌سازی نشانگر موشواره روی صفر تنظیم کنید. برای پنهان‌سازی فوری نشانگر موشواره هنگام تایپ متن، روی مقداری منفی تنظیم کنید. به طور پیش‌فرض در macOS غیرفعال است زیرا راه‌اندازی پایدار آن در میان دریای باگ‌های پیوسته در حال تغییر Cocoa زحمت بسیار دارد. .sp به طور پیش‌فرض، پس از پنهان شدن نشانگر، با هر رویداد موشواره بعدی بلافاصله آشکار می‌شود. .INDENT 0.0 .TP .B دو قالب پشتیبانی می‌شود: .INDENT 7.0 .IP \(bu 2 \fB\fP .IP \(bu 2 \fB \fP .UNINDENT .UNINDENT .sp برای تغییر رفتار آشکارسازی، می‌توان پارامترهای اختیاری \fB\fP، \fB\fP و \fB\fP را تنظیم کرد. .INDENT 0.0 .TP .B \fB\fP صبر کردن به میزان ثانیه‌های مشخص پس از رویدادهای موشواره پیش از آشکارسازی نشانگر موشواره. برای آشکارسازی فوری نشانگر موشواره هنگام فعالیت موشواره، روی صفر تنظیم کنید. این گزینه برای جلوگیری از آشکار شدن نشانگر هنگام کشیدن‌های تصادفی روی ترک‌پد مفید است. .TP .B \fB\fP تنظیم آستانه فعالیت موشواره مورد نیاز برای آشکارسازی نشانگر، در صورتی که گزینه غیرصفر باشد. در صورت صفر بودن ، بی‌اثر است. .sp برای نمونه، اگر \fB\fP برابر ۴۰ و \fB\fP برابر ۲.۵ باشد، هنگام تشخیص رویداد موشواره توسط kitty، تعداد رویدادهای موشواره در ۲.۵ ثانیه بعدی ثبت شده و بررسی می‌شود که آیا از ۴۰ * ۲.۵ = ۱۰۰ فراتر می‌رود یا خیر. در این صورت، نشانگر موشواره آشکار می‌شود، در غیر این صورت هیچ اتفاقی نمی‌افتد. .TP .B \fB\fP کنترل اینکه کدام رویدادهای موشواره می‌توانند نشانگر را آشکار کنند. در صورت فعال بودن، هر دو رویداد پیمایش و حرکت می‌توانند نشانگر را آشکار سازند. در صورت غیرفعال بودن، تنها حرکات موشواره نشانگر را آشکار می‌کنند. .TP .B نمونه‌هایی از مقادیر معتبر: .INDENT 7.0 .IP \(bu 2 \fB0.0\fP .IP \(bu 2 \fB1.0\fP .IP \(bu 2 \fB\-1.0\fP .IP \(bu 2 \fB0.1 3.0 40 yes\fP .UNINDENT .UNINDENT .INDENT 0.0 .TP .B url_color, url_style .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX url_color #0087bd url_style curly .EE .UNINDENT .UNINDENT .sp رنگ و سبک برجسته‌سازی نشانی‌های وب (URL) هنگام قرار گرفتن موشواره روی آن‌ها. \fBurl_style\fP می‌تواند یکی از موارد زیر باشد: \fBnone\fP، \fBstraight\fP، \fBdouble\fP، \fBcurly\fP، \fBdotted\fP، \fBdashed\fP\&. .INDENT 0.0 .TP .B open_url_with .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX open_url_with default .EE .UNINDENT .UNINDENT .sp برنامه مورد استفاده برای باز کردن نشانی‌های وب کلیک‌شده. مقدار ویژه \fBdefault\fP ابتدا به دنبال گرداننده‌های URL تعریف‌شده از طریق سازوکار اسکریپت‌نویسی کلیک موشواره \%<> می‌گردد و اگر چیزی یافت نشود، از گرداننده URL پیش‌فرض سیستم‌عامل (\fBopen\fP در macOS و \fBxdg\-open\fP در Linux) استفاده خواهد کرد. .INDENT 0.0 .TP .B url_prefixes .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX url_prefixes file ftp ftps gemini git gopher http https irc ircs kitty mailto news sftp ssh .EE .UNINDENT .UNINDENT .sp مجموعه پیشوندهای URL برای جستجو هنگام تشخیص URL زیر نشانگر موشواره. .INDENT 0.0 .TP .B detect_urls .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX detect_urls yes .EE .UNINDENT .UNINDENT .sp تشخیص URLهای زیر موشواره. URLهای شناسایی‌شده با خط زیرین برجسته می‌شوند و نشانگر موشواره روی آن‌ها به شکل دست درمی‌آید. حتی در صورت غیرفعال بودن این گزینه، URLها همچنان قابل کلیک هستند. همچنین برای کنترل نحوه نمایش ابرپیوندها (در مقایسه با URLهای متن ساده) گزینه \fBunderline_hyperlinks\fP را ببینید. .INDENT 0.0 .TP .B url_excluded_characters .UNINDENT .sp نویسه‌های اضافی غیرمجاز در URLها هنگام تشخیص URLهای زیر نشانگر موشواره. به طور پیش‌فرض، تمام نویسه‌های مجاز در URL پذیرفته می‌شوند. افزون بر این، نویسه‌های خط جدید مجاز هستند (اما حذف می‌شوند). این برای سازگاری با برنامه‌هایی چون mutt است که حتی برای خطوط ادامه‌دار نیز شکستگی خطی سخت اضافه می‌کنند. برای غیرفعال کردن این رفتار، می‌توان \fB\en\fP را به این گزینه افزود. نویسه‌های خاص را می‌توان با گریز بک‌اسلش مشخص کرد؛ برای مشخص کردن بک‌اسلش از دو بک‌اسلش استفاده کنید. .INDENT 0.0 .TP .B show_hyperlink_targets .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX show_hyperlink_targets never .EE .UNINDENT .UNINDENT .sp هنگام قرار گرفتن موشواره روی یک ابرپیوند ترمینال، نشانی URL واقعی که هنگام کلیک روی ابرپیوند فعال می‌شود را نشان می‌دهد. برای نمایش تنها هنگام فشردن کلید تبدیل‌کننده متناظر، روی \fBctrl\fP، \fBcmd\fP، \fBalt\fP یا \fBshift\fP تنظیم کنید (\fBCtrl\fP، \fBSuper\fP (در macOS معادل \fBCmd\fP)، \fBShift\fP). در صورت فشرده شدن چند کلید تبدیل‌کننده، تا زمانی که کلید پیکربندی‌شده در میان آن‌ها باشد URL نمایش داده می‌شود. برای نمایش همیشگی روی \fBalways\fP یا برای عدم نمایش روی \fBnever\fP تنظیم کنید. .INDENT 0.0 .TP .B underline_hyperlinks .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX underline_hyperlinks hover .EE .UNINDENT .UNINDENT .sp کنترل نحوه کشیدن خط زیر ابرپیوندها. ابرپیوندها می‌توانند با قرار گرفتن موشواره (\fBhover\fP)، به طور دائمی (\fBalways\fP) یا هرگز (\fBnever\fP، به این معنی که kitty هیچ سبکی از خط زیرین را به ابرپیوندها اعمال نمی‌کند) خط زیرین داشته باشند. توجه داشته باشید مقدار \fBalways\fP تنها برای ابرپیوندهای واقعی (OSC 8) اعمال می‌شود، نه متنی که با قرار گرفتن موشواره به عنوان URL تشخیص داده می‌شود. برای سبک خط زیرین از تنظیمات \fBurl_style\fP و \fBurl_color\fP استفاده می‌کند. توجه داشته باشید بارگذاری مجدد پیکربندی و تغییر این مقدار به یا از \fBalways\fP، تنها بر متنی اثر می‌گذارد که پس از آن توسط kitty دریافت می‌شود. .INDENT 0.0 .TP .B copy_on_select .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX copy_on_select no .EE .UNINDENT .UNINDENT .sp رونوشت به تخته‌گیره یا بافر اختصاصی هنگام گزینش. با تنظیم این گزینه روی \fBclipboard\fP، گزینش متن با موشواره باعث رونوشت آن به تخته‌گیره می‌شود. در بسترهایی چون macOS که مفهوم گزینش اولیه (primary selection) را ندارند مفید است. همچنین می‌توانید نامی مانند \fBa1\fP را برای رونوشت به یک بافر اختصاصی kitty مشخص کنید. یک میانبر را با کنش \fBpaste_from_buffer\fP نگاشت کنید تا از این بافر اختصاصی جای‌گذاری شود. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX copy_on_select a1 map shift+cmd+v paste_from_buffer a1 .EE .UNINDENT .UNINDENT .sp توجه داشته باشید رونوشت به تخته‌گیره یک ریسک امنیتی است، زیرا همه برنامه‌ها، از جمله وبگاه‌های باز در مرورگر، می‌توانند محتوای تخته‌گیره سامانه را بخوانند. .INDENT 0.0 .TP .B clear_selection_on_clipboard_loss .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX clear_selection_on_clipboard_loss no .EE .UNINDENT .UNINDENT .sp هنگامی که محتوای تخته‌گیره دیگر بازتاب‌دهنده گزینش فعلی نیست، آن را پاک کن. این مورد اساساً روی بسترهایی چون Linux مفید است که گزینش متن به طور خودکار آن را در یک تخته‌گیره ویژه «گزینش اولیه» رونوشت می‌کند، یا زمانی که \fBcopy_on_select\fP روی \fBclipboard\fP تنظیم شده باشد. .sp توجه داشته باشید در macOS سامانه هنگام تغییر مالک تخته‌گیره اعلانی ارائه نمی‌دهد، بنابراین در آنجا، رونوشت به تخته‌گیره در برنامه‌ای غیر از kitty حتی اگر \fBcopy_on_select\fP فعال باشد، گزینش‌ها را پاک نخواهد کرد. .INDENT 0.0 .TP .B paste_actions .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX paste_actions quote\-urls\-at\-prompt,confirm .EE .UNINDENT .UNINDENT .sp فهرستی جداشده با کاما از کنش‌هایی که باید هنگام جای‌گذاری یا رها کردن متن درون ترمینال انجام شوند. کنش‌های جای‌گذاری پشتیبانی‌شده عبارتند از: .INDENT 0.0 .TP .B \fBquote\-urls\-at\-prompt\fP: اگر متن در حال جای‌گذاری یک URL باشد و مکان‌نما در اعلان پوسته قرار داشته باشد، URL به طور خودکار درون نقل‌قول قرار می‌گیرد (نیازمند \fBshell_integration\fP). .TP .B \fBreplace\-dangerous\-control\-codes\fP جایگزینی کدهای کنترلی خطرناک از متن جای‌گذاری‌شده، بدون تأیید. .TP .B \fBreplace\-newline\fP جایگزینی نویسه خط جدید از متن جای‌گذاری‌شده، بدون تأیید. .TP .B \fBconfirm\fP: تأیید جای‌گذاری در صورتی که متن جای‌گذاری شامل کدهای کنترلی ترمینال باشد؛ چرا که اگر پوسته/برنامه در حال اجرا درون ترمینال آن‌ها را به درستی مدیریت نکند، می‌تواند خطرناک بوده و منجر به اجرای کد شود. .TP .B \fBconfirm\-if\-large\fP تأیید جای‌گذاری در صورتی که بسیار بزرگ باشد (بزرگ‌تر از 16KB)، زیرا جای‌گذاری حجم بالایی از متن در پوسته‌ها می‌تواند بسیار کند باشد. .TP .B \fBfilter\fP: اجرای تابع filter_paste() از پرونده \fBpaste\-actions.py\fP در شاخه پیکربندی kitty روی متن جای‌گذاری‌شده. متنی که توسط تابع بازگردانده شود در عمل جای‌گذاری خواهد شد. .TP .B \fBno\-op\fP: هیچ اثری ندارد. .UNINDENT .INDENT 0.0 .TP .B strip_trailing_spaces .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX strip_trailing_spaces never .EE .UNINDENT .UNINDENT .sp حذف فاصله‌های انتهای خطوط هنگام رونوشت به تخته‌گیره. مقدار \fBsmart\fP این کار را هنگام استفاده از گزینش‌های عادی انجام می‌دهد، اما در گزینش‌های مستطیلی خیر. مقدار \fBalways\fP همواره این کار را انجام می‌دهد. .INDENT 0.0 .TP .B select_by_word_characters .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX select_by_word_characters @\-./_~?&=%+# .EE .UNINDENT .UNINDENT .sp نویسه‌هایی که هنگام دوبار کلیک، بخشی از کلمه در نظر گرفته می‌شوند. علاوه بر این نویسه‌ها، هر نویسه‌ای که در پایگاه داده یونیکد به عنوان نویسه الفبایی\-عددی علامت‌گذاری شده باشد نیز تطبیق داده می‌شود. .INDENT 0.0 .TP .B select_by_word_characters_forward .UNINDENT .sp نویسه‌هایی که هنگام گسترش گزینش به جلو با دوبار کلیک، بخشی از کلمه در نظر گرفته می‌شوند. علاوه بر این نویسه‌ها، هر نویسه‌ای که در پایگاه داده یونیکد به عنوان نویسه الفبایی\-عددی علامت‌گذاری شده باشد نیز تطبیق داده خواهد شد. .sp در صورت خالی بودن (پیش‌فرض)، \fBselect_by_word_characters\fP برای هر دو جهت استفاده خواهد شد. .INDENT 0.0 .TP .B click_interval .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX click_interval \-1.0 .EE .UNINDENT .UNINDENT .sp بازه زمانی میان کلیک‌های متوالی برای تشخیص کلیک‌های دوگانه/سه‌گانه (به ثانیه). اعداد منفی در صورت وجود از پیش‌فرض سامانه استفاده می‌کنند، یا به عنوان جایگزین به 0.5 برمی‌گردند. .INDENT 0.0 .TP .B focus_follows_mouse .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX focus_follows_mouse no .EE .UNINDENT .UNINDENT .sp تنظیم پنجره فعال به پنجره زیر موشواره هنگامی که موشواره وارد پنجره دیگری می‌شود. تا زمانی که موشواره درون یک پنجره تکی حرکت می‌کند، پنجره فعال تغییر نمی‌یابد؛ بنابراین تکان خوردن تصادفی موشواره تعویض پنجره مبتنی بر صفحه‌کلید را باطل نمی‌کند. تنظیم آن روی \fBdrop\fP به این معنی است که تمرکز تنها هنگام کشیدن و رها کردن (drag and drop) در یک پنجره تغییر خواهد کرد. در macOS، این کار همچنین باعث می‌شود تا زمانی که برنامه kitty برنامه فعال است، پنجره سامانه زیر موشواره با ورود موشواره به آن، به صورت خودکار متمرکز شود. .INDENT 0.0 .TP .B pointer_shape_when_grabbed .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX pointer_shape_when_grabbed arrow .EE .UNINDENT .UNINDENT .sp شکل نشانگر موشواره هنگامی که برنامه در حال اجرا درون ترمینال، موشواره را به دست می‌گیرد (grab). .INDENT 0.0 .TP .B default_pointer_shape .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX default_pointer_shape beam .EE .UNINDENT .UNINDENT .sp شکل پیش‌فرض نشانگر موشواره. .INDENT 0.0 .TP .B pointer_shape_when_dragging .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX pointer_shape_when_dragging beam crosshair .EE .UNINDENT .UNINDENT .sp شکل پیش‌فرض نشانگر موشواره هنگام کشیدن روی متن. مقدار اختیاری دوم، شکل نشانگر را هنگام کشیدن در حالت گزینش مستطیلی تعیین می‌کند. .INDENT 0.0 .TP .B drag_threshold .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX drag_threshold 5 .EE .UNINDENT .UNINDENT .sp فاصله آستانه‌ای که موشواره برای شروع کشیدن و رها کردن (drag and drop) باید حرکت کند. کشیدن برای زبانه‌ها و پنجره‌ها کار می‌کند. می‌توانید زبانه‌ها را برای مرتب‌سازی مجدد، جدا کردن به پنجره‌های سامانه‌ای جدید یا انتقال آن‌ها به پنجره سامانه‌ای دیگر بکشید. به طور مشابه، با کشیدن نوار عنوان پنجره (به \fBtoggle_window_title_bars\fP \%<#\:action-toggle_window_title_bars> نگاه کنید) می‌توانید آن را در چیدمانش بازآرایی کنید، جدا سازید یا به زبانه دیگری انتقال دهید. مقدار صفر تمام قابلیت‌های کشیدن را غیرفعال می‌کند. .sp توجه داشته باشید در Wayland به دلیل طراحی ضعیف \% لغو یک کشش باعث جدا شدن زبانه می‌شود. این مشکل برای ترکیب‌کننده‌هایی که از xdg\-toplevel\-drag \% پشتیبانی می‌کنند برطرف شده است\&. .SS کنش‌های موشواره (Mouse actions) .sp دکمه‌های موشواره را می‌توان برای انجام کنش‌های دلخواه نگاشت کرد. ساختار بدین‌گونه است: .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map button\-name event\-type modes action .EE .UNINDENT .UNINDENT .sp که در آن \fBbutton\-name\fP یکی از مقادیر \fBleft\fP، \fBmiddle\fP، \fBright\fP، \fBb1\fP ... \fBb8\fP به همراه کلیدهای تبدیل صفحه‌کلید است. برای نمونه: \fBctrl+shift+left\fP به نگه داشتن کلیدهای \fBCtrl\fP+\fBShift\fP هنگام کلیک با دکمه چپ موشواره اشاره دارد. مقادیر \fBb1\fP ... \fBb8\fP را می‌توان برای ارجاع به حداکثر هشت دکمه روی موشواره به کار برد. .sp \fBevent\-type\fP یکی از مقادیر \fBpress\fP، \fBrelease\fP، \fBdoublepress\fP، \fBtriplepress\fP، \fBclick\fP، \fBdoubleclick\fP است. \fBmodes\fP مشخص می‌کند که آیا کنش هنگام به دام افتادن موشواره توسط برنامهٔ در حال اجرا در ترمینال (grabbed) انجام شود یا خیر. مقادیر آن \fBgrabbed\fP یا \fBungrabbed\fP یا ترکیبی از آن‌ها با کاما هستند. \fBgrabbed\fP به زمانی اشاره دارد که برنامهٔ در حال اجرا در ترمینال رویدادهای موشواره را درخواست کرده باشد. توجه داشته باشید که رویدادهای کلیک و دوبارکلیک دارای تأخیری به میزان \fBclick_interval\fP هستند تا از فشردن‌های دوبار و سه‌بار متمایز شوند. .sp می‌توانید kitty را با گزینه خط فرمان \fBkitty \-\-debug\-input\fP \%<#\:cmdoption-kitty-debug-input> اجرا کنید تا رویدادهای موشواره را ببینید. کنش‌های توکار زیر را بررسی کنید تا با امکانات آن آشنا شوید. .sp اگر می‌خواهید نگاشت یک دکمه را حذف کنید، آن را به هیچ‌چیز نگاشت کنید. برای نمونه، برای غیرفعال کردن باز کردن URLها با یک کلیک ساده: .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map left click ungrabbed .EE .UNINDENT .UNINDENT .sp همه کنش‌های قابل نگاشت شامل کنش‌های موشواره را اینجا ببینید \%<>\&. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 به محض شروع یک گزینش، رها کردن دکمه‌ای که آن را آغاز کرده به طور خودکار به آن پایان می‌دهد و هیچ رویداد رها کردنی (release) ارسال نخواهد شد. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B clear_all_mouse_actions .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX clear_all_mouse_actions no .EE .UNINDENT .UNINDENT .sp حذف همه تعاریف کنش‌های موشواره تا این نقطه. برای مثال، برای حذف کنش‌های پیش‌گزیده موشواره کاربرد دارد. .INDENT 0.0 .TP .B کلیک روی پیوند زیر موشواره یا جابجایی مکان‌نما .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map left click ungrabbed mouse_handle_click selection link prompt .EE .UNINDENT .UNINDENT .sp ابتدا وجود یک گزینش را بررسی می‌کند و در صورت وجود، کاری انجام نمی‌دهد. سپس وجود پیوند زیر مکان‌نمای موشواره را بررسی کرده و در صورت وجود روی آن کلیک می‌کند. در نهایت بررسی می‌کند آیا کلیک در اعلان پوسته (shell prompt) فعلی رخ داده است یا خیر، و در این صورت مکان‌نما را به محل کلیک منتقل می‌کند. توجه داشته باشید که این مورد برای کارکرد به یکپارچه‌سازی با پوسته \%<#\:shell-integration> نیاز دارد. .INDENT 0.0 .TP .B کلیک روی پیوند زیر موشواره یا جابجایی مکان‌نما حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+left click grabbed,ungrabbed mouse_handle_click selection link prompt .EE .UNINDENT .UNINDENT .sp مشابه بالا، با این تفاوت که کنش حتی در زمانی که موشواره توسط برنامهٔ در حال اجرا در ترمینال ضبط (grabbed) شده باشد نیز انجام می‌شود. .INDENT 0.0 .TP .B کلیک روی پیوند زیر مکان‌نمای موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map ctrl+shift+left release grabbed,ungrabbed mouse_handle_click link .EE .UNINDENT .UNINDENT .sp نسخهٔ همراه با \fBCtrl\fP+\fBShift\fP به این دلیل وجود دارد که نسخهٔ ساده مبتنی بر کلیک دارای تأخیر ناگزیر \fBclick_interval\fP است تا کلیک‌های تکی را از دوبارکلیک متمایز کند. .INDENT 0.0 .TP .B صرف‌نظر از رویداد فشردن برای کلیک پیوند .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map ctrl+shift+left press grabbed discard_event .EE .UNINDENT .UNINDENT .sp جلوگیری از ارسال این رویداد فشردن (press) به برنامه‌ای که موشواره را ضبط کرده است، زیرا رویداد رها کردن (release) متناظر برای باز کردن URL استفاده می‌شود. .INDENT 0.0 .TP .B جای‌گذاری از گزینش نخستین .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map middle release ungrabbed paste_from_selection .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B آغاز گزینش متن .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map left press ungrabbed mouse_selection normal .EE .UNINDENT .UNINDENT .sp اگر می‌خواهید پیوندها یا URLهای شناسایی‌شده را بکشید و رها کنید، به جای \fBnormal\fP از \fBdrag_or_normal_select\fP استفاده کنید؛ در این صورت اگر پیوندی زیر موشواره باشد بر اساس \fBdrag_threshold\fP کشیده می‌شود، در غیر این صورت یک گزینش معمولی انجام خواهد شد. .INDENT 0.0 .TP .B آغاز گزینش متن در یک مستطیل .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map ctrl+alt+left press ungrabbed mouse_selection rectangle .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش یک واژه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map left doublepress ungrabbed mouse_selection word .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش یک خط .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map left triplepress ungrabbed mouse_selection line .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش خط از اولین خانه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map alt+left triplepress ungrabbed mouse_selection line_from_begin .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش خط از نقطه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map ctrl+alt+left triplepress ungrabbed mouse_selection line_from_point .EE .UNINDENT .UNINDENT .sp گزینش از نقطهٔ کلیک‌شده تا پایان خط. اگر می‌خواهید واژهٔ موجود در آن نقطه گزینش شود و سپس تا انتهای خط گسترش یابد، \fIline_from_point\fP را به \fIword_and_line_from_point\fP تغییر دهید. .INDENT 0.0 .TP .B گسترش گزینش فعلی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map right press ungrabbed mouse_selection extend .EE .UNINDENT .UNINDENT .sp اگر می‌خواهید به جای نزدیک‌ترین مرز، تنها انتهای گزینش جابجا شود، به جای \fBextend\fP از \fBmove\-end\fP استفاده کنید. .INDENT 0.0 .TP .B گسترش گزینش فعلی با shift .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+left press ungrabbed mouse_selection extend .EE .UNINDENT .UNINDENT .sp اگر می‌خواهید به جای نزدیک‌ترین مرز، تنها انتهای گزینش جابجا شود، به جای \fBextend\fP از \fBmove\-end\fP استفاده کنید. .INDENT 0.0 .TP .B جای‌گذاری از گزینش نخستین حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+middle release ungrabbed,grabbed paste_selection mouse_map shift+middle press grabbed discard_event .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B آغاز گزینش متن حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+left press grabbed mouse_selection normal .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B آغاز گزینش متن در یک مستطیل حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map ctrl+shift+alt+left press ungrabbed,grabbed mouse_selection rectangle .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش یک واژه حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+left doublepress ungrabbed,grabbed mouse_selection word .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش یک خط حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+left triplepress ungrabbed,grabbed mouse_selection line .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش خط از اولین خانه حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+alt+left triplepress ungrabbed,grabbed mouse_selection line_from_begin .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B گزینش خط از نقطه حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map ctrl+shift+alt+left triplepress ungrabbed,grabbed mouse_selection line_from_point .EE .UNINDENT .UNINDENT .sp گزینش از نقطهٔ کلیک‌شده تا پایان خط حتی در حالت ضبط موشواره. اگر می‌خواهید واژهٔ موجود در آن نقطه گزینش شود و سپس تا انتهای خط گسترش یابد، \fIline_from_point\fP را به \fIword_and_line_from_point\fP تغییر دهید. .INDENT 0.0 .TP .B گسترش گزینش فعلی حتی در حالت ضبط موشواره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map shift+right press ungrabbed,grabbed mouse_selection extend .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B نمایش خروجی دستور کلیک‌شده در صفحه‌بند .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mouse_map ctrl+shift+right press ungrabbed mouse_show_command_output .EE .UNINDENT .UNINDENT .sp برای کارکرد به یکپارچه‌سازی با پوسته \%<#\:shell-integration> نیاز دارد. .SH "تنظیم کارایی (PERFORMANCE TUNING)" .INDENT 0.0 .TP .B repaint_delay .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX repaint_delay 10 .EE .UNINDENT .UNINDENT .sp تأخیر بین به‌روزرسانی‌های صفحه (به میلی‌ثانیه). کاهش آن باعث افزایش فریم بر ثانیه (FPS) به بهای مصرف بیشتر CPU می‌شود. مقدار پیش‌گزیده حدود ۱۰۰ فریم بر ثانیه تولید می‌کند که برای بیشتر کاربردها بیش از حد کافی است. توجه داشته باشید که برای دستیابی واقعی به ۱۰۰ FPS، باید یا \fBsync_to_monitor\fP را روی \fBno\fP تنظیم کنید یا از نمایشگری با نرخ نوسازی بالا استفاده کنید. همچنین، برای کمینه کردن تاخیر زمانی که ورودی در انتظار پردازش وجود دارد، این گزینه نادیده گرفته می‌شود. .INDENT 0.0 .TP .B input_delay .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX input_delay 3 .EE .UNINDENT .UNINDENT .sp تأخیر پیش از پردازش ورودی دریافت شده از برنامه در حال اجرا در ترمینال (به میلی‌ثانیه). توجه داشته باشید که کاهش آن پاسخ‌دهی را افزایش می‌دهد، اما همچنین مصرف CPU را افزایش داده و ممکن است باعث پرش تصویر در برنامه‌های تمام‌صفحه‌ای شود که کل صفحه را در هر حلقه بازطراحی می‌کنند، زیرا kitty آنچنان سریع است که به‌روزرسانی‌های جزئی صفحه رسم خواهند شد. این تنظیم زمانی که بافر ورودی تقریباً پر باشد نادیده گرفته می‌شود. .INDENT 0.0 .TP .B sync_to_monitor .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX sync_to_monitor yes .EE .UNINDENT .UNINDENT .sp همگام‌سازی به‌روزرسانی‌های صفحه با نرخ نوسازی نمایشگر. این کار از بریدگی تصویر \% هنگام پیمایش جلوگیری می‌کند. با این حال، سرعت رندر را به نرخ نوسازی نمایشگر شما محدود می‌سازد. با یک موشواره بسیار پرسرعت یا نرخ تکرار بالای صفحه‌کلید، ممکن است متوجه اندکی تأخیر در ورودی شوید. در این صورت، این گزینه را روی \fBno\fP تنظیم کنید. .SH "زنگ ترمینال (TERMINAL BELL)" .INDENT 0.0 .TP .B enable_audio_bell .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX enable_audio_bell yes .EE .UNINDENT .UNINDENT .sp زنگ صوتی. برای غیرفعال کردن در محیط‌هایی که نیاز به سکوت دارند کاربردی است. .INDENT 0.0 .TP .B visual_bell_duration .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX visual_bell_duration 0.0 .EE .UNINDENT .UNINDENT .sp مدت زمان زنگ دیداری (به ثانیه). هنگام وقوع زنگ، صفحه برای مدت ثانیه‌های مشخص شده چشمک می‌زند. برای غیرفعال‌سازی روی صفر تنظیم کنید. چشمک‌زدن متحرک است و در طول مدت مشخص شده محو و ظاهر می‌شود. تابع تغییر سرعت \%<#\:term-easing-function> مورد استفاده برای محو شدن قابل کنترل است. برای نمونه، \fB2.0 linear\fP باعث می‌شود چشمک‌زدن به صورت خطی محو و پدیدار شود. پیش‌گزیده در صورت عدم تعیین استفاده از \fBease\-in\-out\fP است که در ابتدا، میانه و پایان به آرامی محو می‌شود. می‌توانید توابع تغییر سرعت متفاوتی را برای بخش‌های پدیدار شدن و محو شدن مشخص کنید، مانند این: \fB2.0 ease\-in linear\fP. kitty از تمام توابع تغییر سرعت CSS \% پشتیبانی می‌کند. .INDENT 0.0 .TP .B visual_bell_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX visual_bell_color none .EE .UNINDENT .UNINDENT .sp رنگ مورد استفاده در زنگ دیداری. تنظیم روی \fBnone\fP به رنگ پس‌زمینهٔ گزینش بازمی‌گردد. اگر احساس می‌کنید زنگ دیداری بیش از حد روشن است، می‌توانید آن را روی رنگی تیره‌تر تنظیم کنید. .INDENT 0.0 .TP .B window_alert_on_bell .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_alert_on_bell yes .EE .UNINDENT .UNINDENT .sp درخواست جلب توجه پنجره هنگام زنگ. باعث جهش آیکون dock در macOS یا چشمک زدن نوار وظیفه در لینوکس می‌شود. .INDENT 0.0 .TP .B bell_on_tab .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX bell_on_tab \(dq🔔 \(dq .EE .UNINDENT .UNINDENT .sp مقداری متن یا یک نماد یونیکد برای نمایش روی زبانه در صورتی که پنجره‌ای در آن زبانه که فوکوس ندارد دچار زنگ شود. اگر می‌خواهید از فاصله‌های ابتدایی یا انتهایی استفاده کنید، متن را درون علامت نقل‌قول قرار دهید. برای نحوه رندر شدن این مورد به \fBtab_title_template\fP مراجعه کنید. .sp برای سازگاری با نسخه‌های پیشین، مقادیر \fByes\fP، \fBy\fP و \fBtrue\fP به نماد پیش‌گزیدهٔ زنگ تبدیل می‌شوند و مقادیر \fBno\fP، \fBn\fP، \fBfalse\fP و \fBnone\fP به رشتهٔ خالی تبدیل می‌شوند. .INDENT 0.0 .TP .B command_on_bell .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX command_on_bell none .EE .UNINDENT .UNINDENT .sp برنامه‌ای که هنگام وقوع زنگ اجرا می‌شود. از متغیر محیطی \fBKITTY_CHILD_CMDLINE\fP \%<#\:envvar-KITTY_CHILD_CMDLINE> می‌توان برای دریافت برنامه در حال اجرا در پنجره‌ای که زنگ در آن رخ داده است استفاده کرد. .INDENT 0.0 .TP .B macos_dock_badge_on_bell .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_dock_badge_on_bell yes .EE .UNINDENT .UNINDENT .sp نمایش یک نشان روی آیکون dock نرم‌افزار kitty هنگام وقوع زنگ در زمانی که kitty برنامهٔ فعال نیست (فقط در macOS). این نشان به طور خودکار با بازگشت فوکوس به kitty پاک می‌شود. .INDENT 0.0 .TP .B bell_path .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX bell_path none .EE .UNINDENT .UNINDENT .sp مسیر پرونده صوتی برای پخش به عنوان صدای زنگ. اگر روی \fBnone\fP تنظیم شود، از صدای زنگ پیش‌فرض سیستم استفاده می‌شود. باید در قالبی باشد که توسط API صوتی سیستم‌عامل پشتیبانی می‌شود، مانند WAV یا OGA در لینوکس (libcanberra) یا AIFF، MP3 یا WAV در macOS (NSSound). مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty سنجیده می‌شوند. .INDENT 0.0 .TP .B linux_bell_theme .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX linux_bell_theme __custom .EE .UNINDENT .UNINDENT .sp پوسته صوتی XDG که kitty برای پخش صدای زنگ استفاده خواهد کرد. در Wayland، زمانی که کامپوزیتور از آن پشتیبانی کند، درخواست پخش صدای زنگ پیش‌فرض سیستم به آن ارسال می‌شود و این تنظیم تأثیری ندارد. توجه داشته باشید که Hyprland ادعای پشتیبانی از این پروتکل را دارد، اما در عمل صدایی پخش نمی‌کند \%\&. این تنظیم به صورت پیش‌فرض روی نام پوسته سفارشی مشخص‌شده در مشخصات پوسته صوتی XDG \% با محتوای زیر تنظیم شده است: .INDENT 0.0 .INDENT 3.5 [Sound Theme] .sp Inherits=name\-of\-the\-sound\-theme\-you\-want\-to\-use .UNINDENT .UNINDENT .sp عبارت \fBname\-of\-the\-sound\-theme\-you\-want\-to\-use\fP را با نام واقعی پوسته جایگزین کنید. اکنون تمام برنامه‌های سازگار باید از صداهای این پوسته استفاده کنند. .SH "چیدمان پنجره (WINDOW LAYOUT)" .INDENT 0.0 .TP .B remember_window_size, initial_window_width, initial_window_height .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX remember_window_size yes initial_window_width 640 initial_window_height 400 .EE .UNINDENT .UNINDENT .sp در صورت فعال بودن، اندازه پنجره سیستم‌عامل (OS Window) \%<#\:term-os_window> به خاطر سپرده می‌شود تا نمونه‌های جدید kitty همان اندازه نمونه قبلی را داشته باشند. در صورت غیرفعال بودن، پنجره سیستم‌عامل در ابتدا اندازه‌ای خواهد داشت که توسط initial_window_width/height بر حسب پیکسل پیکربندی شده است. می‌توانید از پسوند \(dqc\(dq در مقادیر عرض/ارتفاع استفاده کنید تا به جای پیکسل به عنوان تعداد سلول‌ها تفسیر شوند. توجه داشته باشید که در Wayland، کارکرد اندازه‌های اولیه پنجره مشخص‌شده بر حسب سلول هنگام استفاده از مقیاس‌بندی کسری به کامپوزیتور بستگی دارد. .INDENT 0.0 .TP .B remember_window_position .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX remember_window_position no .EE .UNINDENT .UNINDENT .sp در صورت فعال بودن، موقعیت پنجره سیستم‌عامل (OS Window) \%<#\:term-os_window> به خاطر سپرده می‌شود تا نمونه‌های جدید kitty همان موقعیت نمونه قبلی را داشته باشند. در صورت غیرفعال بودن، موقعیت پنجره سیستم‌عامل توسط مدیر پنجره تعیین می‌شود. توجه داشته باشید که به خاطر سپردن موقعیت تنها در صورتی کار می‌کند که محیط رومیزی/مدیر پنجره زیرین از آن پشتیبانی کند. این ویژگی هرگز در Wayland کار نمی‌کند. همچنین برای تعیین موقعیت هنگام راه‌اندازی kitty، به \fBkitty \-\-position\fP \%<#\:cmdoption-kitty-position> مراجعه کنید. .INDENT 0.0 .TP .B enabled_layouts .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX enabled_layouts * .EE .UNINDENT .UNINDENT .sp چیدمان‌های فعال پنجره. فهرستی از نام‌های چیدمان که با کاما از هم جدا شده‌اند. مقدار ویژه \fBall\fP به معنای تمام چیدمان‌ها است. اولین چیدمان فهرست‌شده به عنوان چیدمان راه‌اندازی استفاده خواهد شد. پیکربندی پیش‌فرض شامل تمام چیدمان‌ها به ترتیب الفبایی است. برای فهرستی از چیدمان‌های موجود، به Layouts \%<#\:layouts>\& مراجعه کنید. .INDENT 0.0 .TP .B window_resize_step_cells, window_resize_step_lines .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_resize_step_cells 2 window_resize_step_lines 2 .EE .UNINDENT .UNINDENT .sp اندازه گام (بر حسب واحدهای عرض سلول/ارتفاع سلول) برای تغییر اندازه پنجره‌های kitty در یک چیدمان با میانبر \fBctrl+shift+r\fP\&. مقدار cells برای تغییر اندازه افقی و مقدار lines برای تغییر اندازه عمودی استفاده می‌شود. .INDENT 0.0 .TP .B window_border_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_border_width 0.5pt .EE .UNINDENT .UNINDENT .sp عرض حاشیه‌های پنجره. می‌تواند بر حسب پیکسل (px) یا پوینت (pt) باشد. مقادیر بر حسب pt بر اساس وضوح صفحه نمایش به نزدیک‌ترین تعداد پیکسل گرد می‌شوند. در صورت عدم تعیین، واحد به صورت pt فرض می‌شود. توجه داشته باشید که حاشیه‌ها تنها زمانی نمایش داده می‌شوند که بیش از یک پنجره قابل مشاهده باشد. هدف آن‌ها جداسازی چندین پنجره از یکدیگر است. .INDENT 0.0 .TP .B draw_minimal_borders .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX draw_minimal_borders yes .EE .UNINDENT .UNINDENT .sp رسم حداقل حاشیه‌های مورد نیاز. این بدان معناست که تنها حاشیه‌هایی رسم می‌شوند که پنجره را از پنجره مجاور جدا می‌کنند. توجه داشته باشید که تنظیم مقدار غیرصفر برای \fBwindow_margin_width\fP این گزینه را لغو کرده و باعث می‌شود همه حاشیه‌ها رسم شوند. .INDENT 0.0 .TP .B draw_window_borders_for_single_window .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX draw_window_borders_for_single_window no .EE .UNINDENT .UNINDENT .sp رسم حاشیه در اطراف پنجره حتی زمانی که تنها یک پنجره قابل مشاهده است. در صورت فعال بودن و وجود تنها یک پنجره، حاشیه‌های کامل در اطراف آن رسم می‌شود (گویی \fBdraw_minimal_borders\fP برابر با false است). هنگام فوکوس بودن پنجره و داشتن فوکوس پنجره سیستم‌عامل، حاشیه با رنگ فعال نمایش داده می‌شود و با از دست رفتن فوکوس پنجره سیستم‌عامل، با رنگ غیرفعال نشان داده می‌شود. این ویژگی یک نشانگر بصری واضح برای وضعیت فوکوس بودن پنجره kitty فراهم می‌کند. وقتی چندین پنجره قابل مشاهده باشند، این گزینه تأثیری ندارد و قوانین معمول رسم حاشیه اعمال می‌شوند. .INDENT 0.0 .TP .B window_margin_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_margin_width 0 .EE .UNINDENT .UNINDENT .sp حاشیه بیرونی پنجره (بر حسب pt) (ناحیه خالی بیرون حاشیه). یک مقدار واحد، هر چهار طرف را تنظیم می‌کند. دو مقدار، جهت‌های عمودی و افقی را تنظیم می‌کنند. سه مقدار، بالا، افقی و پایین را تنظیم می‌کنند. چهار مقدار، بالا، راست، پایین و چپ را تنظیم می‌کنند. .INDENT 0.0 .TP .B single_window_margin_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX single_window_margin_width \-1 .EE .UNINDENT .UNINDENT .sp حاشیه بیرونی پنجره برای زمانی که تنها یک پنجره قابل مشاهده است (بر حسب pt). مقادیر منفی باعث می‌شوند مقدار \fBwindow_margin_width\fP به جای آن استفاده شود. یک مقدار واحد، هر چهار طرف را تنظیم می‌کند. دو مقدار، جهت‌های عمودی و افقی را تنظیم می‌کنند. سه مقدار، بالا، افقی و پایین را تنظیم می‌کنند. چهار مقدار، بالا، راست، پایین و چپ را تنظیم می‌کنند. .INDENT 0.0 .TP .B window_padding_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_padding_width 0 .EE .UNINDENT .UNINDENT .sp فاصله‌گذاری درونی پنجره (بر حسب pt) (ناحیه خالی بین متن و حاشیه پنجره). یک مقدار واحد، هر چهار طرف را تنظیم می‌کند. دو مقدار، جهت‌های عمودی و افقی را تنظیم می‌کنند. سه مقدار، بالا، افقی و پایین را تنظیم می‌کنند. چهار مقدار، بالا، راست، پایین و چپ را تنظیم می‌کنند. .INDENT 0.0 .TP .B single_window_padding_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX single_window_padding_width \-1 .EE .UNINDENT .UNINDENT .sp فاصله‌گذاری درونی پنجره برای زمانی که تنها یک پنجره قابل مشاهده است (بر حسب pt). مقادیر منفی باعث می‌شوند مقدار \fBwindow_padding_width\fP به جای آن استفاده شود. یک مقدار واحد، هر چهار طرف را تنظیم می‌کند. دو مقدار، جهت‌های عمودی و افقی را تنظیم می‌کنند. سه مقدار، بالا، افقی و پایین را تنظیم می‌کنند. چهار مقدار، بالا، راست، پایین و چپ را تنظیم می‌کنند. .INDENT 0.0 .TP .B placement_strategy .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX placement_strategy center .EE .UNINDENT .UNINDENT .sp هنگامی که اندازه پنجره مضرب دقیقی از اندازه سلول نباشد، ناحیه سلولی پنجره ترمینال دارای مقداری فاصله‌گذاری اضافی در لبه‌ها خواهد بود. می‌توانید نحوه توزیع این فاصله‌گذاری را با این گزینه کنترل کنید. استفاده از مقدار \fBcenter\fP بدین معنی است که ناحیه سلولی در مرکز قرار می‌گیرد. مقدار \fBtop\-left\fP به این معنی است که فاصله‌گذاری فقط در لبه‌های پایینی و راست قرار می‌گیرد. مقدار می‌تواند یکی از این موارد باشد: \fBtop\-left\fP، \fBtop\fP، \fBtop\-right\fP، \fBleft\fP، \fBcenter\fP، \fBright\fP، \fBbottom\-left\fP، \fBbottom\fP، \fBbottom\-right\fP\&. .INDENT 0.0 .TP .B active_border_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX active_border_color #00ff00 .EE .UNINDENT .UNINDENT .sp رنگ حاشیه پنجره فعال. این مقدار را روی \fBnone\fP تنظیم کنید تا حاشیه‌ای در اطراف پنجره فعال رسم نشود. .INDENT 0.0 .TP .B inactive_border_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX inactive_border_color #cccccc .EE .UNINDENT .UNINDENT .sp رنگ حاشیه پنجره‌های غیرفعال. .INDENT 0.0 .TP .B bell_border_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX bell_border_color #ff5a00 .EE .UNINDENT .UNINDENT .sp رنگ حاشیه پنجره‌های غیرفعالی که در آن‌ها زنگ رخ داده است. .INDENT 0.0 .TP .B inactive_text_alpha .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX inactive_text_alpha 1.0 .EE .UNINDENT .UNINDENT .sp محو کردن متن در پنجره‌های غیرفعال به میزان مشخص‌شده. این مقدار باید عددی بین \-1 و 1 باشد. مقدار مطلق، میزان شفافیت واقعی را کنترل می‌کند که صفر به معنای محو کامل و یک به معنای کاملاً کدر است. هنگامی که یک عدد مثبت استفاده می‌شود، متن حتی در صورتی که تنها یک پنجره قابل مشاهده باشد ولی پنجره سیستم‌عامل فوکوس نداشته باشد، محو می‌شود. اعداد منفی به این معنی است که متن تنها زمانی محو می‌شود که بیش از یک پنجره kitty در یک پنجره سیستم‌عامل قابل مشاهده باشد. محو شدن در تمام پنجره‌ها به جز پنجره فعال اتفاق می‌افتد، حتی اگر پنجره سیستم‌عامل فوکوس نداشته باشد. بنابراین اگر بخواهید به مدیر پنجره برای نشان دادن فوکوس پنجره سیستم‌عامل تکیه کنید و از این ویژگی برای مشخص کردن پنجره فعال kitty در داخل پنجره سیستم‌عامل بهره ببرید، این گزینه کاربردی است. .INDENT 0.0 .TP .B hide_window_decorations .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX hide_window_decorations no .EE .UNINDENT .UNINDENT .sp مخفی کردن تزئینات پنجره (نوار عنوان و حاشیه‌های پنجره) با مقدار \fByes\fP\&. در macOS، مقادیر \fBtitlebar\-only\fP و \fBtitlebar\-and\-corners\fP می‌توانند برای مخفی کردن صرف نوار عنوان و گوشه‌های گرد استفاده شوند. .sp در Wayland، مقدار \fBtitlebar\-only\fP می‌تواند برای مخفی کردن نوار عنوان ضمن حفظ سایه پنجره برای تغییر اندازه استفاده شود. در کامپوزیتورهایی که دارای تزئینات سمت سرور هستند (مانند هر محیطی جز GNOME)، هر دو مقدار \fByes\fP و \fBtitlebar\-only\fP حالت تزئینات سمت کلاینت را تحمیل می‌کنند. .sp اینکه این قابلیت کار کند و دقیقاً چه تأثیری داشته باشد به مدیر پنجره/سیستم‌عامل بستگی دارد. توجه داشته باشید که تأثیرات تغییر این گزینه هنگام بارگذاری مجدد پیکربندی تعریف‌نشده است. هنگام استفاده از \fBtitlebar\-only\fP در macOS، تنظیم \fBwindow_margin_width\fP و \fBplacement_strategy\fP نیز برای جلوگیری از بریده شدن متن توسط گوشه‌های گرد مفید است؛ یا می‌توانید از \fBtitlebar\-and\-corners\fP استفاده کنید. .INDENT 0.0 .TP .B window_logo_path .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_logo_path none .EE .UNINDENT .UNINDENT .sp مسیر پرونده تصویر نشان‌واره (لوگو). باید در قالب PNG/JPEG/WEBP/GIF/TIFF/BMP باشد. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty تفسیر می‌شوند. لوگو در گوشه‌ای از هر پنجره kitty نمایش داده می‌شود. موقعیت آن با \fBwindow_logo_position\fP کنترل می‌شود. پنجره‌های جداگانه را می‌توان طوری پیکربندی کرد که یا با استفاده از کنش \fBlaunch\fP \%<#\:action-launch> یا قابلیت کنترل از راه دور \%<> لوگوهای متفاوتی داشته باشند. .INDENT 0.0 .TP .B window_logo_position .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_logo_position bottom\-right .EE .UNINDENT .UNINDENT .sp محل قرارگیری لوگوی پنجره در داخل پنجره. مقدار می‌تواند یکی از موارد زیر باشد: \fBtop\-left\fP، \fBtop\fP، \fBtop\-right\fP، \fBleft\fP، \fBcenter\fP، \fBright\fP، \fBbottom\-left\fP، \fBbottom\fP، \fBbottom\-right\fP\&. .INDENT 0.0 .TP .B window_logo_alpha .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_logo_alpha 0.5 .EE .UNINDENT .UNINDENT .sp میزان محو شدن لوگو در پس‌زمینه. صفر به معنای محو کامل و یک به معنای کاملاً کدر است. .INDENT 0.0 .TP .B window_logo_scale .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_logo_scale 0 .EE .UNINDENT .UNINDENT .sp درصد (0\-100] اندازه پنجره که لوگو باید بر اساس آن مقیاس‌بندی شود. استفاده از یک عدد واحد بدین معنی است که لوگو با حفظ نسبت ابعاد تصویر، به همان درصد از کوتاه‌ترین بعد پنجره مقیاس‌بندی می‌شود. .sp استفاده از دو عدد بدین معنی است که عرض و ارتفاع لوگو به درصد متناظر از عرض و ارتفاع پنجره مقیاس‌بندی می‌شوند. .sp استفاده از صفر به عنوان درصد، مقیاس‌بندی در آن بعد را غیرفعال می‌کند. یک عدد صفر تکی (پیش‌فرض) تمام مقیاس‌بندی‌های لوگوی پنجره را غیرفعال می‌کند. .INDENT 0.0 .TP .B resize_debounce_time .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX resize_debounce_time 0.1 0.5 .EE .UNINDENT .UNINDENT .sp زمان انتظار (بر حسب ثانیه) پیش از درخواست از برنامه در حال اجرا در kitty برای تغییر اندازه و بازرسم صفحه حین تغییر اندازه زنده پنجره سیستم‌عامل، هنگامی که هیچ رویداد تغییر اندازه جدیدی دریافت نشده است، یعنی زمانی که تغییر اندازه یا متوقف شده یا پایان یافته است. در پلتفرم‌هایی مانند macOS، که سیستم‌عامل رویدادهای مربوط به شروع و پایان تغییر اندازه زنده را ارسال می‌کند، عدد دوم برای بازرسم پس از مکث استفاده می‌شود زیرا kitty می‌تواند بین مکث و پایان تغییر اندازه تمایز قائل شود. در چنین سیستم‌هایی عدد اول نادیده گرفته می‌شود و بازرسم بلافاصله پس از پایان تغییر اندازه انجام می‌شود. در سایر سیستم‌ها فقط عدد اول استفاده می‌شود تا kitty به سرعت پس از پایان تغییر اندازه \(dqآماده\(dq شود، ضمن اینکه برای صرفه‌جویی در مصرف انرژی مدام بازرسم انجام ندهد. .INDENT 0.0 .TP .B resize_in_steps .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX resize_in_steps no .EE .UNINDENT .UNINDENT .sp تغییر اندازه پنجره سیستم‌عامل در گام‌هایی به بزرگی سلول‌ها، به جای دقت معمول پیکسلی. در ترکیب با \fBinitial_window_width\fP و \fBinitial_window_height\fP بر حسب تعداد سلول‌ها، این گزینه می‌تواند برای حفظ حداقل حاشیه‌ها هنگام تغییر اندازه پنجره سیستم‌عامل استفاده شود. توجه داشته باشید که این گزینه در حال حاضر در Wayland کار نمی‌کند. .INDENT 0.0 .TP .B visual_window_select_characters .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX visual_window_select_characters 1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ .EE .UNINDENT .UNINDENT .sp فهرست نویسه‌ها برای انتخاب بصری پنجره. به عنوان مثال، برای انتخاب پنجره‌ای جهت فوکوس با \fBctrl+shift+f7\fP\&. مقدار باید رشته‌ای از اعداد یا حروف یکتا و بدون حساسیت به حروف بزرگ و کوچک، از مجموعه \fB0\-9A\-Z\(ga\-=[];\(aq,./\e\fP باشد. ترجیح خود را به عنوان رشته‌ای از نویسه‌ها مشخص کنید. .INDENT 0.0 .TP .B confirm_os_window_close .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX confirm_os_window_close \-1 .EE .UNINDENT .UNINDENT .sp درخواست تأیید هنگام بستن پنجره سیستم‌عامل یا زبانه‌ای که حداقل شامل این تعداد پنجره kitty باشد توسط مدیر پنجره (مانند کلیک روی دکمه بستن پنجره یا فشردن میانبر سیستم‌عامل برای بستن پنجره‌ها) یا توسط کنش \fBclose_tab\fP \%<#\:action-close_tab>. مقدار صفر تأیید را غیرفعال می‌کند. این تأیید همچنین برای درخواست‌های خروج از کل برنامه (همه پنجره‌های سیستم‌عامل، از طریق کنش \fBquit\fP \%<#\:action-quit>) اعمال می‌شود. مقادیر منفی به مقادیر مثبت تبدیل می‌شوند، اما با فعال بودن \fBshell_integration\fP، استفاده از مقادیر منفی به این معنی است که پنجره‌های منتظر در اعلان شل شمرده نمی‌شوند و تنها پنجره‌هایی که فرمانی در آن‌ها در حال اجراست به حساب می‌آیند. همچنین می‌توانید با افزودن \fBcount\-background\fP به تنظیم، از بسته شدن هنگام اجرای کارهای پس‌زمینه جلوگیری کنید؛ به عنوان مثال: \fB\-1 count\-background\fP\&. توجه داشته باشید که اگر می‌خواهید هنگام بستن پنجره‌های تکی تأییدیه دریافت کنید، می‌توانید کنش \fBclose_window_with_confirmation\fP \%<#\:action-close_window_with_confirmation> را نگاشت کنید. .INDENT 0.0 .TP .B window_drag_tolerance .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_drag_tolerance 2 .EE .UNINDENT .UNINDENT .sp کنترل کشیدن حاشیه‌های پنجره برای تغییر اندازه پنجره‌های kitty. این میزان تلورانس بر حسب pt برای ناحیه اطراف حاشیه‌های پنجره است که در آن فشردن کلید چپ موشواره باعث شروع کشیدن حاشیه‌های پنجره می‌شود. برای غیرفعال کردن کشیدن حاشیه‌ها از یک مقدار منفی بزرگ مانند \-200 استفاده کنید. توجه داشته باشید از آنجا که kitty از چیدمان‌ها استفاده می‌کند، کشیدن حاشیه‌ها در واقع خود پنجره را تغییر اندازه نمی‌دهد، بلکه سطر/ستون/شکاف چیدمان را تغییر اندازه می‌دهد که می‌تواند منجر به تغییر اندازه چندین پنجره شود. .INDENT 0.0 .TP .B window_title_bar .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_bar top .EE .UNINDENT .UNINDENT .sp کنترل موقعیت نوار عنوان پنجره نسبت به محتوای پنجره. از \fBwindow_title_bar_min_windows\fP برای کنترل زمان نمایش نوارهای عنوان استفاده کنید. از \fBwindow_title_template\fP برای قالب‌بندی عنوان نمایشی پنجره استفاده کنید. .INDENT 0.0 .TP .B window_title_bar_min_windows .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_bar_min_windows 0 .EE .UNINDENT .UNINDENT .sp حداقل تعداد پنجره‌های نمایان در یک تب پیش از نمایش نوار عنوان پنجره. مقدار \fB0\fP یعنی هرگز نمایش داده نشود. \fB1\fP یعنی همیشه نمایش داده شود. \fB2\fP یا بیشتر یعنی تنها زمانی که حداقل به همین تعداد پنجره نمایان باشد، نمایش داده شود. مشابه \fBtab_bar_min_tabs\fP برای نوار تب. .INDENT 0.0 .TP .B window_title_template .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_template \(dq{fmt.fg.red}{bell_symbol}{activity_symbol}{fmt.fg.window}{progress_percent}{title}\(dq .EE .UNINDENT .UNINDENT .sp الگویی برای رندر متن نوار عنوان پنجره. از همان ساختار الگوی \fBtab_title_template\fP استفاده می‌کند. متغیرهای در دسترس عبارتند از: \fB{title}\fP، \fB{bell_symbol}\fP، \fB{activity_symbol}\fP، \fB{progress_percent}\fP، \fB{custom}\fP، \fB{fmt}\fP، \fB{is_active}\fP\&. همچنین می‌توانید تابع سفارشی \fBdraw_window_title(data)\fP را در پروندهٔ \fBwindow_title_bar.py\fP در شاخه پیکربندی kitty تعریف کنید که با \fB{custom}\fP در دسترس خواهد بود. .INDENT 0.0 .TP .B active_window_title_template .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX active_window_title_template none .EE .UNINDENT .UNINDENT .sp الگوی مورد استفاده برای نوار عنوان پنجره فعال. در صورت تنظیم نشدن (مقدار \fBnone\fP)، از \fBwindow_title_template\fP استفاده می‌شود. .INDENT 0.0 .TP .B window_title_bar_active_foreground .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_bar_active_foreground none .EE .UNINDENT .UNINDENT .sp رنگ متن (پیش‌زمینه) برای نوار عنوان پنجره فعال. در صورت تنظیم روی \fBnone\fP، پیش‌فرض آن رنگ متناظر در نوار تب (\fBactive_tab_foreground\fP) است. .INDENT 0.0 .TP .B window_title_bar_active_background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_bar_active_background none .EE .UNINDENT .UNINDENT .sp رنگ پس‌زمینه برای نوار عنوان پنجره فعال. در صورت تنظیم روی \fBnone\fP، پیش‌فرض آن رنگ متناظر در نوار تب (\fBactive_tab_background\fP) است. .INDENT 0.0 .TP .B window_title_bar_inactive_foreground .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_bar_inactive_foreground none .EE .UNINDENT .UNINDENT .sp رنگ متن (پیش‌زمینه) برای نوار عنوان پنجره‌های غیرفعال. در صورت تنظیم روی \fBnone\fP، پیش‌فرض آن رنگ متناظر در نوار تب (\fBinactive_tab_foreground\fP) است. .INDENT 0.0 .TP .B window_title_bar_inactive_background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_bar_inactive_background none .EE .UNINDENT .UNINDENT .sp رنگ پس‌زمینه برای نوار عنوان پنجره‌های غیرفعال. در صورت تنظیم روی \fBnone\fP، پیش‌فرض آن رنگ متناظر در نوار تب (\fBinactive_tab_background\fP) است. .INDENT 0.0 .TP .B window_title_bar_align .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX window_title_bar_align center .EE .UNINDENT .UNINDENT .sp تراز افقی متن در نوارهای عنوان پنجره. .SH "نوار تب (TAB BAR)" .INDENT 0.0 .TP .B tab_bar_edge .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_edge bottom .EE .UNINDENT .UNINDENT .sp لبه‌ای که نوار تب در آن نمایش داده می‌شود: \fBtop\fP، \fBbottom\fP، \fBleft\fP یا \fBright\fP\&. .INDENT 0.0 .TP .B tab_bar_margin_width .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_margin_width 0.0 .EE .UNINDENT .UNINDENT .sp حاشیه عمود بر لبه نوار تب (بر حسب pt). برای نوارهای تب در بالا یا پایین، این مقدار حاشیه چپ و راست است. برای نوارهای تب در چپ یا راست، این مقدار حاشیه بالا و پایین است. .INDENT 0.0 .TP .B tab_bar_margin_height .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_margin_height 0.0 0.0 .EE .UNINDENT .UNINDENT .sp حاشیه در امتداد لبه نوار تب (بر حسب pt). عدد نخست، حاشیه میان لبه پنجره سیستم‌عامل و نوار تب است. عدد دوم، حاشیه میان نوار تب و محتویات تب کنونی است. .INDENT 0.0 .TP .B tab_bar_style .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_style fade .EE .UNINDENT .UNINDENT .sp سبک نوار تب، می‌تواند یکی از موارد زیر باشد: .INDENT 0.0 .TP .B \fBfade\fP لبه‌های هر تب در رنگ پس‌زمینه محو می‌شوند. (همچنین \fBtab_fade\fP را ببینید) .TP .B \fBslant\fP تب‌ها شبیه برگه‌های یک پوشه فیزیکی به نظر می‌رسند. .TP .B \fBseparator\fP تب‌ها با یک جداکننده قابل پیکربندی از هم جدا می‌شوند. (همچنین \fBtab_separator\fP را ببینید) .TP .B \fBpowerline\fP تب‌ها به صورت یک خط پیوسته با جداکننده‌های شکیل نمایش داده می‌شوند. (همچنین \fBtab_powerline_style\fP را ببینید) .TP .B \fBcustom\fP تابع پایتون سفارشی کاربر به نام draw_tab از پروندهٔ \fBtab_bar.py\fP در شاخه پیکربندی kitty بارگذاری می‌شود. برای نمونه‌هایی از نحوه نوشتن چنین تابعی، توابع با نام \fBdraw_tab_with_*\fP در کد منبع kitty را ببینید: \fBkitty/tab_bar.py\fP\&. همچنین این گفتگو \% را برای نمونه‌هایی از کاربران kitty ببینید. .TP .B \fBhidden\fP نوار تب پنهان است. در صورت استفاده از این گزینه، ممکن است بخواهید کلید میانبری برای اقدام \fBselect_tab\fP \%<#\:action-select_tab> تعریف کنید که فهرستی از تب‌ها را نمایش داده و جابه‌جایی آسان بین تب‌ها را ممکن می‌سازد. .UNINDENT .INDENT 0.0 .TP .B tab_bar_filter .UNINDENT .sp یک عبارت جستجو \%<#\:search-syntax>\&. تنها تب‌هایی که با این عبارت مطابقت داشته باشند در نوار تب نشان داده می‌شوند. تب فعال کنونی همواره، بدون توجه به مطابقت یا عدم مطابقت، نمایش داده می‌شود. هنگام استفاده از این گزینه، ممکن است نوار تب با تعداد تب کمتری نسبت به مقدار تعیین‌شده در \fBtab_bar_min_tabs\fP نمایش یابد، زیرا ارزیابی فیلتر سنگین است و تنها هنگام نمایش انجام می‌شود. این ویژگی هنگام استفاده از نشست‌ها \%<#\:sessions> بیشترین کاربرد را دارد. عبارت \fBsession:~ or session:^$\fP تنها تب‌هایی را نشان می‌دهد که متعلق به نشست فعلی هستند یا به هیچ نشستی تعلق ندارند. کنش‌های گوناگون ناوبری تب مانند \fBgoto_tab\fP \%<#\:action-goto_tab>، \fBnext_tab\fP \%<#\:action-next_tab>، \fBprevious_tab\fP \%<#\:action-previous_tab> و غیره، به طور خودکار محدود به کار تنها روی تب‌های منطبق می‌شوند. .INDENT 0.0 .TP .B tab_bar_align .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_align start .EE .UNINDENT .UNINDENT .sp تراز نوار تب، می‌تواند یکی از این موارد باشد: \fBstart\fP، \fBcenter\fP، \fBend\fP، \fBleft\fP، \fBright\fP\&. مقادیر \fBleft\fP و \fBright\fP به ترتیب نام‌های مستعار برای \fBstart\fP و \fBend\fP هستند. .INDENT 0.0 .TP .B tab_bar_show_new_tab_button .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_show_new_tab_button no .EE .UNINDENT .UNINDENT .sp اگر روی \fByes\fP تنظیم شود، دکمه \fB+\fP همیشه در انتهای نوار تب به عنوان میانبر قابل کلیک برای باز کردن تب جدید نمایش می‌یابد. هنگام تنظیم روی \fBno\fP (پیش‌فرض)، دکمه در حالت عادی پنهان است اما هنگام کشیدن (drag) یک پنجره موقتاً ظاهر می‌شود تا بتوان از آن به عنوان مقصد رهاسازی برای باز کردن پنجره در یک تب جدید استفاده کرد. .INDENT 0.0 .TP .B tab_bar_min_tabs .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_min_tabs 2 .EE .UNINDENT .UNINDENT .sp حداقل تعداد تب‌هایی که باید وجود داشته باشند تا نوار تب نمایش داده شود. .INDENT 0.0 .TP .B tab_switch_strategy .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_switch_strategy previous .EE .UNINDENT .UNINDENT .sp الگوریتم تعویض تب هنگام بسته شدن تب فعلی. مقدار پیش‌فرض \fBprevious\fP به آخرین تب استفاده‌شده منتقل می‌شود. مقدار \fBleft\fP به تب سمت چپِ تب بسته‌شده می‌رود. مقدار \fBright\fP به تب سمت راستِ تب بسته‌شده می‌رود. مقدار \fBlast\fP به راست‌ترین تب منتقل می‌شود. .INDENT 0.0 .TP .B tab_fade .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_fade 0.25 0.5 0.75 1 .EE .UNINDENT .UNINDENT .sp کنترل نحوه محو شدن هر تب در پس‌زمینه هنگام استفاده از \fBfade\fP در \fBtab_bar_style\fP\&. هر عدد یک مقدار آلفا (بین صفر و یک) است که میزان محو شدن خانهٔ متناظر در پس‌زمینه را کنترل می‌کند؛ صفر یعنی بدون محو شدن و یک یعنی محو کامل. با افزودن/حذف مقادیر از این فهرست می‌توانید تعداد خانه‌های استفاده‌شده را تغییر دهید. .INDENT 0.0 .TP .B tab_separator .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_separator \(dq ┇\(dq .EE .UNINDENT .UNINDENT .sp جداکننده میان تب‌ها در نوار تب هنگام استفاده از \fBseparator\fP در \fBtab_bar_style\fP\&. .INDENT 0.0 .TP .B tab_powerline_style .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_powerline_style angled .EE .UNINDENT .UNINDENT .sp سبک جداکننده powerline میان تب‌ها در نوار تب هنگام استفاده از \fBpowerline\fP در \fBtab_bar_style\fP؛ می‌تواند یکی از این موارد باشد: \fBangled\fP، \fBslanted\fP، \fBround\fP\&. .INDENT 0.0 .TP .B tab_activity_symbol .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_activity_symbol none .EE .UNINDENT .UNINDENT .sp متن یا نماد یونیکد برای نمایش روی تب، در صورتی که پنجره‌ای بدون تمرکز در آن تب دارای فعالیتی باشد. برای استفاده از فاصله‌های ابتدایی یا انتهایی، متن را در نقل‌قول قرار دهید. برای نحوه رندر شدن آن \fBtab_title_template\fP را ببینید. .INDENT 0.0 .TP .B tab_title_max_length .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_title_max_length 0 .EE .UNINDENT .UNINDENT .sp حداکثر تعداد خانه‌هایی که می‌توان برای رندر متن در یک تب استفاده کرد. مقدار صفر یعنی محدودیتی اعمال نمی‌شود. برای نوارهای تب عمودی، در صورت تنظیم نشدن این گزینه، kitty از پهنای پیش‌فرض نوار کناری با گنجایش حدود بیست خانه عنوان استفاده می‌کند. .INDENT 0.0 .TP .B tab_title_template .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_title_template \(dq{fmt.fg.red}{bell_symbol}{activity_symbol}{secure_input_symbol}{fmt.fg.tab}{tab.last_focused_progress_percent}{title}\(dq .EE .UNINDENT .UNINDENT .sp الگویی برای رندر عنوان تب. حالت پیش‌فرض تنها عنوان را با نمادهای اختیاری زنگ و فعالیت رندر می‌کند. اگر مایل به گنجاندن نمایه (index) تب نیز هستید، از ساختاری مانند \fB{index}:{title}\fP استفاده کنید. در صورت داشتن میانبرهایی برای \fBgoto_tab N\fP کاربردی است. اگر ترجیح می‌دهید نمایه به صورت بالانویس نمایش یابد، از \fB{sup.index}\fP استفاده کنید. همه داده‌های موجود عبارتند از: .INDENT 0.0 .TP .B \fBtitle\fP عنوان تب کنونی. .TP .B \fBindex\fP نمایه تب قابل استفاده با میانبرهای \fBgoto_tab N\fP \%<#\:action-goto_tab>\&. .TP .B \fBlayout_name\fP نام چیدمان فعلی. .TP .B \fBsession_name\fP نام پرونده نشست kitty که این تب از آن ایجاد شده است (در صورت وجود). .TP .B \fBactive_session_name\fP نام پرونده نشست kitty که پنجره فعال در این تب از آن ایجاد شده است (در صورت وجود). .TP .B \fBnum_windows\fP تعداد پنجره‌های موجود در تب. .TP .B \fBnum_window_groups\fP تعداد گروه‌های پنجره (یک گروه پنجره شامل یک پنجره و تمام پنجره‌های هم‌پوشان آن است) در تب. .TP .B \fBsecure_input_symbol\fP نماد یک کلید هنگام فعال بودن secure input در macOS و فعال بودن تب؛ در غیر این صورت خالی است. .TP .B \fBtab.active_wd\fP شاخه کاری پنجره در حال حاضر فعال در تب (سنگین، نیازمند فراخوان سیستم). از \fBtab.active_oldest_wd\fP برای دریافت شاخه قدیمی‌ترین فرایند پیش‌زمینه به جای جدیدترین استفاده کنید. .TP .B \fBtab.active_exe\fP نام فایل اجرایی در حال اجرا در پیش‌زمینه پنجره فعال فعلی در تب (سنگین، نیازمند فراخوان سیستم). برای قدیمی‌ترین فرایند پیش‌زمینه از \fBtab.active_oldest_exe\fP استفاده کنید. .TP .B \fBmax_title_length\fP حداکثر طول عنوان موجود. .TP .B \fBkeyboard_mode\fP نام حالت صفحه‌کلید فعلی \%<#\:modal-mappings> یا یک رشته خالی اگر هیچ حالت صفحه‌کلیدی فعال نباشد. .TP .B \fBtab.last_focused_progress_percent\fP اگر دستوری در پنجره پیشرفت کاری را گزارش کند، این پیشرفت را به صورت درصدی از آخرین پنجره فوکوس‌شده در تب نشان می‌دهد. در صورت عدم گزارش پیشرفت، رشته خالی است. .TP .B \fBtab.progress_percent\fP اگر دستوری در پنجره پیشرفت کاری را گزارش کند، این پیشرفت را به عنوان میانگین درصد همه پنجره‌های تب نشان می‌دهد. در صورت عدم گزارش پیشرفت، رشته خالی است. .TP .B \fBtab.children_mem_usage\fP میزان مصرف حافظه فعلی تمام فرایندهای فرزند تب و نوادگان آن‌ها. .TP .B \fBcustom\fP این مورد تابعی به نام \fBdraw_title(data)\fP را از پرونده \fBtab_bar.py\fP واقع در شاخه پیکربندی kitty فراخوانی می‌کند. یک دیکشنری از داده‌ها به تابع ارسال می‌شود، همان داده‌هایی که می‌توان در این الگو به کار برد. سپس تابع می‌تواند پردازش‌های دلخواه را انجام داده و یک رشته برگرداند. برای نمونه: \fBtab_title_template \(dq{custom}\(dq\fP خروجی تابع را به عنوان عنوان تب به کار می‌برد. هر دستور چاپ در \fBdraw_title()\fP روی STDOUT فرایند kitty چاپ می‌شود که برای رفع اشکال سودمند است. .UNINDENT .sp توجه داشته باشید قالب‌بندی توسط سازوکار قالب‌بندی رشته پایتون انجام می‌شود، بنابراین می‌توانید به عنوان مثال از \fB{layout_name[:2].upper()}\fP برای نمایش تنها دو حرف اول نام چیدمان با حروف بزرگ استفاده کنید. برای استایل دادن به متن، می‌توانید دستورالعمل‌های استایل را به کار ببرید، مثلاً: \fB{fmt.fg.red}red{fmt.fg.tab}normal{fmt.bg._00FF00}greenbg{fmt.bg.tab}\fP\&. به همین ترتیب برای ضخیم و کج: \fB{fmt.bold}bold{fmt.nobold}normal{fmt.italic}italic{fmt.noitalic}\fP\&. رنگ‌های ۲۵۶‌گانه ترمینال به صورت \fBfmt.fg.color0\fP تا \fBfmt.fg.color255\fP قابل استفاده هستند. توجه داشته باشید برای سازگاری با نسخه‌های پیشین، اگر \fB{bell_symbol}\fP یا \fB{activity_symbol}\fP در الگو موجود نباشند، به ابتدای آن افزوده می‌شوند. .INDENT 0.0 .TP .B active_tab_title_template .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX active_tab_title_template none .EE .UNINDENT .UNINDENT .sp الگوی مورد استفاده برای تب‌های فعال. در صورت تعیین نشدن، از \fBtab_title_template\fP استفاده می‌شود. .INDENT 0.0 .TP .B active_tab_foreground, active_tab_background, active_tab_font_style, inactive_tab_foreground, inactive_tab_background, inactive_tab_font_style .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX active_tab_foreground #000 active_tab_background #eee active_tab_font_style bold\-italic inactive_tab_foreground #444 inactive_tab_background #999 inactive_tab_font_style normal .EE .UNINDENT .UNINDENT .sp رنگ‌ها و سبک‌های نوار تب. .INDENT 0.0 .TP .B tab_bar_background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_background none .EE .UNINDENT .UNINDENT .sp رنگ پس‌زمینه برای نوار تب. پیش‌فرض آن رنگ پس‌زمینه ترمینال است. .INDENT 0.0 .TP .B tab_bar_margin_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX tab_bar_margin_color none .EE .UNINDENT .UNINDENT .sp رنگ ناحیه حاشیه نوار تب. پیش‌فرض برای حاشیه‌های بالا و پایین نوار تب، رنگ پس‌زمینه ترمینال است. برای حاشیه‌های کناری، رنگ پیش‌فرض متناسب با رنگ پس‌زمینه تب مجاور انتخاب می‌شود، مگر اینکه پنجره نیمه‌شفاف باشد که در این صورت پس‌زمینه پیش‌فرض استفاده می‌شود چون جلوه بهتری دارد. .SH "طرح رنگ (COLOR SCHEME)" .INDENT 0.0 .TP .B foreground, background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX foreground #dddddd background #000000 .EE .UNINDENT .UNINDENT .sp رنگ‌های پیش‌زمینه و پس‌زمینه. .INDENT 0.0 .TP .B background_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_opacity 1.0 .EE .UNINDENT .UNINDENT .sp میزان کدر بودن (opacity) رنگ پس‌زمینه ترمینال. عددی بین صفر و یک، که یک کاملاً کدر و صفر کاملاً شفاف است. این ویژگی تنها در صورت پشتیبانی سیستم‌عامل کار می‌کند (برای نمونه، هنگام استفاده از کامپوزیتور تحت X11). توجه داشته باشید که این گزینه فقط شفافیت پس‌زمینه خانه‌هایی (cells) را تنظیم می‌کند که رنگ پس‌زمینه یکسانی با پس‌زمینه پیش‌فرض ترمینال دارند؛ تا مواردی مانند نوار وضعیت در vim، خط اعلان‌های powerline و غیره همچنان درست دیده شوند. اما بدین معناست که اگر در ویرایشگر متنی خود از یک تم رنگی با رنگ پس‌زمینه مشخص استفاده کنید، آن بخش شفاف رندر نخواهد شد. در عوض باید رنگ پس‌زمینه پیش‌فرض را در پیکربندی kitty تغییر داده و در طرح رنگ ویرایشگر از رنگ پس‌زمینه استفاده نکنید. یا اینکه با کدهای گریز (escape codes) در اسکریپت شل راه‌اندازی ویرایشگر، رنگ‌های پیش‌فرض ترمینال را تنظیم کنید. همچنین گزینه \fBtransparent_background_colors\fP را ببینید\&. توجه داشته باشید که استفاده از مقداری کمتر از 1.0 ممکن است افت عملکرد (احتمالاً قابل توجهی) به همراه داشته باشد. هنگام استفاده از مقادیر کم برای این تنظیم، بهتر است رنگ \fBbackground\fP را روی رنگی نزدیک به رنگ کلی پس‌زمینه دسکتاپ قرار دهید تا بهترین کیفیت رندر متن حاصل شود. همچنین توجه کنید این تنظیم روی \fBbackground_image\fP (در صورت وجود) اعمال نمی‌شود. تصویر پس‌زمینه می‌تواند از طریق کانال آلفا خودش شفافیت داشته باشد که رعایت خواهد شد. .sp اگر می‌خواهید شفافیت پنجره‌ها را به‌طور پویا تغییر دهید، گزینه \fBdynamic_background_opacity\fP را روی \fByes\fP بگذارید (این گزینه به‌دلیل هزینه عملکردی به‌طور پیش‌فرض غیرفعال است). تغییر این گزینه هنگام بارگذاری مجدد پیکربندی تنها زمانی کار می‌کند که \fBdynamic_background_opacity\fP در پیکربندی اولیه فعال بوده باشد. .INDENT 0.0 .TP .B background_blur .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_blur 0 .EE .UNINDENT .UNINDENT .sp یک مقدار مثبت برای فعال‌سازی محوشدگی پس‌زمینه (blur شدن عناصر بصری پشت پنجره شفاف) در پلتفرم‌های پشتیبانی‌شده تعیین کنید. تنها زمانی اثر می‌گذارد که مقدار \fBbackground_opacity\fP کمتر از یک باشد. در macOS، این مقدار شعاع محوشدگی (میزان بلور) را نیز کنترل می‌کند. تنظیم آن روی مقادیر بیش از حد بالا باعث افت شدید عملکرد و/یا اختلالات گرافیکی در رندر می‌شود. معمولاً مقادیر تا 64 خوب کار می‌کنند. توجه داشته باشید که بسته به نحوه پیاده‌سازی در پلتفرم، ممکن است مشکلات عملکردی ایجاد کند؛ بنابراین با احتیاط استفاده شود. در حال حاضر در macOS و Wayland (هنگامی که کامپوزیتور از افزونه background blur پشتیبانی کند) پشتیبانی می‌شود. .INDENT 0.0 .TP .B transparent_background_colors .UNINDENT .sp فهرستی جداشده با فاصله از حداکثر ۷ رنگ همراه با میزان کدر بودن (opacity). هرگاه رنگ پس‌زمینه یک خانه با یکی از این رنگ‌ها مطابقت داشته باشد، با میزان شفافیت تعیین‌شده رندر می‌شود. .sp در رابط‌های کاربری پیچیده‌تر مانند ویرایشگرها که ممکن است بخواهید بیش از یک رنگ پس‌زمینه به‌صورت شفاف رندر شود (برای نمونه برای پس‌زمینه خط برجسته‌شده مکان‌نما یا یک بلوک مشخص‌شده) کاربرد دارد. برنامه‌های ترمینال می‌توانند این رنگ را با استفاده از کد گریز The kitty color control \%<#\:id1> تنظیم کنند. .sp نحو تعیین رنگ‌ها به‌صورت \fBcolor@opacity\fP است که بخش \fB@opacity\fP اختیاری می‌باشد. در صورت عدم تعیین، مقدار \fBbackground_opacity\fP استفاده می‌شود. برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX transparent_background_colors red@0.5 #00ff00@0.3 .EE .UNINDENT .UNINDENT .sp توجه داشته باشید که برای عملکرد صحیح این تنظیم، باید \fBbackground_opacity\fP را نیز روی مقداری کمتر از ۱ تنظیم کنید. .INDENT 0.0 .TP .B dynamic_background_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX dynamic_background_opacity no .EE .UNINDENT .UNINDENT .sp امکان تغییر پویای \fBbackground_opacity\fP با استفاده از کلیدهای میانبر صفحه کلید (\fBctrl+shift+a>m\fP و \fBctrl+shift+a>l\fP) یا قابلیت کنترل از راه دور. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. .INDENT 0.0 .TP .B background_image .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_image none .EE .UNINDENT .UNINDENT .sp الگوی گلب (glob) منطبق بر یک یا چند تصویر پس‌زمینه. باید در قالب‌های PNG/JPEG/WEBP/TIFF/GIF/BMP باشد. تصویر اول به‌عنوان تصویر پیش‌فرض استفاده می‌شود. تصاویر چندگانه (در صورت نیاز) در حافظه VRAM پردازنده گرافیکی ذخیره می‌شوند تا جابه‌جایی میان آن‌ها آنی باشد. برای حرکت بین تصاویر در فهرست تصاویر پس‌زمینه، از دستور کنترل از راه دور \fBset\-background\-image\fP استفاده کنید؛ برای جزئیات به \fIkitten set\-background\-image \-\-help\fP مراجعه کنید. می‌توانید دستور را بدین شکل به یک کلید نگاشت کنید: \fBmap f1 remote_control set\-background\-image +1\fP\&. توجه داشته باشید که هنگام استفاده از Change color themes automatically when the OS switches between light and dark \%<#\:auto-color-scheme>، این گزینه توسط پرونده طرح رنگ بازنویسی می‌شود و باید درون آن تنظیم شود تا اعمال گردد. .INDENT 0.0 .TP .B background_image_layout .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_image_layout tiled .EE .UNINDENT .UNINDENT .sp تعیین کاشی‌کاری (tile)، مقیاس‌بندی (scale) یا برش تصویر پس‌زمینه. مقدار می‌تواند یکی از \fBtiled\fP، \fBmirror\-tiled\fP، \fBscaled\fP، \fBclamped\fP، \fBcentered\fP یا \fBcscaled\fP باشد\&. مقادیر \fBscaled\fP و \fBcscaled\fP تصویر را به اندازه پنجره تغییر مقیاس می‌دهند، که \fBcscaled\fP نسبت ابعاد تصویر را حفظ می‌کند. توجه داشته باشید که هنگام استفاده از Change color themes automatically when the OS switches between light and dark \%<#\:auto-color-scheme>، این گزینه توسط پرونده طرح رنگ بازنویسی می‌شود و برای اعمال باید داخل آن تنظیم گردد. .INDENT 0.0 .TP .B background_image_linear .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_image_linear no .EE .UNINDENT .UNINDENT .sp هنگام مقیاس‌بندی تصویر پس‌زمینه، مشخص می‌کند که آیا درونیابی خطی (linear interpolation) باید استفاده شود یا خیر. توجه داشته باشید که هنگام استفاده از Change color themes automatically when the OS switches between light and dark \%<#\:auto-color-scheme>، این گزینه توسط پرونده طرح رنگ بازنویسی می‌شود و برای اعمال باید در آن تنظیم شود. .INDENT 0.0 .TP .B background_tint .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_tint 0.0 .EE .UNINDENT .UNINDENT .sp میزان اعمال ته‌رنگ (tint) رنگ پس‌زمینه روی تصویر پس‌زمینه. این گزینه خوانایی متن را آسان‌تر می‌کند. ته‌رنگ با استفاده از رنگ پس‌زمینه فعلی هر پنجره اعمال می‌شود. این گزینه تنها زمانی اعمال می‌شود که \fBbackground_image\fP تنظیم شده باشد. توجه داشته باشید که هنگام استفاده از Change color themes automatically when the OS switches between light and dark \%<#\:auto-color-scheme>، این گزینه توسط پرونده طرح رنگ بازنویسی می‌شود و برای اعمال باید در آن تنظیم گردد. .INDENT 0.0 .TP .B background_tint_gaps .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX background_tint_gaps 1.0 .EE .UNINDENT .UNINDENT .sp میزان اعمال ته‌رنگ رنگ پس‌زمینه روی تصویر پس‌زمینه در شکاف‌های بین پنجره‌ها (gaps)، پس از اعمال \fBbackground_tint\fP\&. از آنجا که این مقدار با \fBbackground_tint\fP ضرب می‌شود، می‌تواند برای کم‌رنگ‌تر کردن ته‌رنگ روی شکاف‌های پنجره جهت ایجاد ظاهری \fIجداگانه (separated)\fP استفاده شود. توجه داشته باشید که هنگام استفاده از Change color themes automatically when the OS switches between light and dark \%<#\:auto-color-scheme>، این گزینه توسط پرونده طرح رنگ بازنویسی می‌شود و برای اعمال باید در آن تنظیم گردد. .INDENT 0.0 .TP .B dim_opacity .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX dim_opacity 0.4 .EE .UNINDENT .UNINDENT .sp میزان محوشدگی متنی که صفت DIM/FAINT روی آن تنظیم شده است. مقدار یک یعنی بدون کم‌نور شدن و صفر یعنی کاملاً محو (نامرئی). .INDENT 0.0 .TP .B selection_foreground, selection_background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX selection_foreground #000000 selection_background #fffacd .EE .UNINDENT .UNINDENT .sp رنگ‌های پیش‌زمینه و پس‌زمینه برای متن انتخاب‌شده با موشواره. تنظیم هر دوی آن‌ها روی \fBnone\fP باعث ایجاد اثر \(dqتصویر معکوس (reverse video)\(dq برای انتخاب‌ها می‌شود که در آن رنگ انتخاب برابر با رنگ متن خانه و رنگ متن برابر با رنگ پس‌زمینه خانه خواهد شد. تنظیم فقط selection_foreground روی \fBnone\fP باعث استفاده بدون تغییر از رنگ پیش‌زمینه می‌شود. توجه داشته باشید که این رنگ‌ها ممکن است توسط برنامه در حال اجرا در ترمینال بازنویسی شوند. .INDENT 0.0 .TP .B palette_generate .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX palette_generate fixed .EE .UNINDENT .UNINDENT .sp نحوه پر کردن رنگ‌هایی که در پالت ۲۵۶ رنگ تنظیم نشده‌اند (روی \fBnone\fP تنظیم شده‌اند). به‌طور پیش‌فرض، برای سازگاری قدیمی (legacy)، این رنگ‌ها روی مقادیر ثابتی که در ترمینال‌های سنتی استفاده می‌شدند تنظیم می‌شوند. .sp در عوض، می‌توانید به kitty اجازه دهید آن‌ها را بر اساس ۱۶ رنگ اول تولید کند \%\&. .sp مقدار \fBsemantic\fP به معنای استفاده از الگوریتمی است که خوانایی خوبی در تم‌های روشن ایجاد می‌کند، اما معنای برخی رنگ‌ها را در مقایسه با کدگذاری رنگ‌های ثابت تغییر می‌دهد. مقدار \fBlegacy\fP خوانایی ضعیف‌تری در تم‌های روشن دارد، اما انحراف کمتری از کدگذاری رنگ‌های ثابت خواهد داشت. .SS "جدول رنگ (THE COLOR TABLE)" .sp ۲۵۶ رنگ ترمینال. برای ۱۶ رنگ اول، ۸ رنگ اصلی وجود دارد که هر رنگ دارای یک نسخه مات و یک نسخه روشن است. می‌توانید ۲۴۰ رنگ باقی‌مانده را از color16 تا color255 تنظیم کنید. .INDENT 0.0 .TP .B color0, color8 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color0 #000000 color8 #767676 .EE .UNINDENT .UNINDENT .sp سیاه .INDENT 0.0 .TP .B color1, color9 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color1 #cc0403 color9 #f2201f .EE .UNINDENT .UNINDENT .sp قرمز .INDENT 0.0 .TP .B color2, color10 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color2 #19cb00 color10 #23fd00 .EE .UNINDENT .UNINDENT .sp سبز .INDENT 0.0 .TP .B color3, color11 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color3 #cecb00 color11 #fffd00 .EE .UNINDENT .UNINDENT .sp زرد .INDENT 0.0 .TP .B color4, color12 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color4 #0d73cc color12 #1a8fff .EE .UNINDENT .UNINDENT .sp آبی .INDENT 0.0 .TP .B color5, color13 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color5 #cb1ed1 color13 #fd28ff .EE .UNINDENT .UNINDENT .sp ارغوانی .INDENT 0.0 .TP .B color6, color14 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color6 #0dcdcd color14 #14ffff .EE .UNINDENT .UNINDENT .sp فیروزه‌ای .INDENT 0.0 .TP .B color7, color15 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX color7 #dddddd color15 #ffffff .EE .UNINDENT .UNINDENT .sp سفید .INDENT 0.0 .TP .B mark1_foreground .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mark1_foreground black .EE .UNINDENT .UNINDENT .sp رنگ برای نشانه‌های (marks) نوع ۱ .INDENT 0.0 .TP .B mark1_background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mark1_background #98d3cb .EE .UNINDENT .UNINDENT .sp رنگ برای نشانه‌های نوع ۱ (آبی فولادی روشن) .INDENT 0.0 .TP .B mark2_foreground .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mark2_foreground black .EE .UNINDENT .UNINDENT .sp رنگ برای نشانه‌های نوع ۲ .INDENT 0.0 .TP .B mark2_background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mark2_background #f2dcd3 .EE .UNINDENT .UNINDENT .sp رنگ برای نشانه‌های نوع ۲ (بژ) .INDENT 0.0 .TP .B mark3_foreground .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mark3_foreground black .EE .UNINDENT .UNINDENT .sp رنگ برای نشانه‌های نوع ۳ .INDENT 0.0 .TP .B mark3_background .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX mark3_background #f274bc .EE .UNINDENT .UNINDENT .sp رنگ برای نشانه‌های نوع ۳ (بنفش) .SS قالب‌های رنگی با گستره رنگی وسیع (Wide gamut color formats) .sp kitty از قالب‌های رنگی مدرن با گستره رنگی وسیع از جمله OKLCH و CIE LAB برای تعیین دقیق رنگ پشتیبانی می‌کند. از این قالب‌ها می‌توان در هر جایی که مقدار رنگ پذیرفته می‌شود (foreground، background، color0\-color255 و غیره) استفاده کرد. .sp برای مستندات تفصیلی درباره قالب‌های رنگی گستره وسیع، ساختار نحو و مثال‌ها، Wide gamut color formats \%<>\& را ببینید. .SH "پیشرفته (ADVANCED)" .INDENT 0.0 .TP .B shell .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX shell . .EE .UNINDENT .UNINDENT .sp برنامه شلی که باید اجرا شود. مقدار پیش‌فرض \fB\&.\fP به معنی استفاده از مقدار متغیر محیطی \fBSHELL\fP \%<#\:envvar-SHELL> است یا در صورت تنظیم نبودن، هر شلی که به عنوان شل پیش‌فرض کاربر فعلی تنظیم شده باشد. توجه داشته باشید که در macOS اگر این را تغییر دهید، ممکن است نیاز باشد \fB\-\-login\fP و \fB\-\-interactive\fP را اضافه کنید تا مطمئن شوید شل در حالت تعاملی آغاز شده و پرونده‌های rc راه‌اندازی خود را می‌خواند. متغیرهای محیطی در این تنظیم بسط داده می‌شوند. .INDENT 0.0 .TP .B editor .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX editor . .EE .UNINDENT .UNINDENT .sp ویرایشگر متن مبتنی بر ترمینال (مانند \fBvim\fP یا \fBnano\fP) برای استفاده هنگام ویرایش پرونده پیکربندی kitty یا وظایف مشابه. .sp مقدار پیش‌فرض \fB\&.\fP به معنی استفاده از متغیرهای محیطی \fBVISUAL\fP \%<#\:envvar-VISUAL> و سپس \fBEDITOR\fP \%<#\:envvar-EDITOR> به ترتیب است. اگر این متغیرها تنظیم نشده باشند، kitty اقدام به اجرای \fBshell\fP شما (\fB$SHELL \-l \-i \-c env\fP) می‌کند تا ببیند آیا پرونده‌های rc راه‌اندازی شل \fBVISUAL\fP \%<#\:envvar-VISUAL> یا \fBEDITOR\fP \%<#\:envvar-EDITOR>\& را تنظیم کرده‌اند یا خیر. اگر آن هم کار نکرد، kitty در میان ویرایشگرهای شناخته‌شده مختلف (\fBvim\fP، \fBemacs\fP و غیره) جستجو کرده و اولین ویرایشگر موجود روی سیستم شما را انتخاب می‌کند. .INDENT 0.0 .TP .B close_on_child_death .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX close_on_child_death no .EE .UNINDENT .UNINDENT .sp بستن پنجره هنگام خروج فرایند فرزند (معمولاً شل). با مقدار پیش‌فرض \fBno\fP، مادامی که فرایندهای دیگری در حال خروجی دادن به ترمینال باشند (مثلاً فرایندهای disown شده یا پس‌زمینه)، ترمینال پس از خروج فرزند باز خواهد ماند. هنگام فعال‌سازی با \fByes\fP، پنجره به محض خروج فرایند فرزند بسته می‌شود. توجه داشته باشید که تنظیم آن روی \fByes\fP بدین معنی است که هر فرایند پس‌زمینه‌ای که همچنان از ترمینال استفاده می‌کند ممکن است به صورت خاموش شکست بخورد زیرا stdout/stderr/stdin آن‌ها دیگر کار نخواهد کرد. .INDENT 0.0 .TP .B remote_control_password .UNINDENT .sp اجازه دادن به برنامه‌های دیگر برای کنترل kitty با استفاده از گذرواژه‌ها. این گزینه را می‌توان چندین بار برای افزودن چندین گذرواژه مشخص کرد. اگر گذرواژه‌ای وجود نداشته باشد و برنامه‌ای تلاش کند با گذرواژه از کنترل از راه دور استفاده کند، kitty از کاربر اجازه خواهد گرفت. همچنین می‌توان یک گذرواژه را \fIبه صورت اختیاری\fP به مجموعه‌ای از کنش‌های مجاز کنترل از راه دور مرتبط کرد. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX remote_control_password \(dqmy passphrase\(dq get\-colors set\-colors focus\-window focus\-tab .EE .UNINDENT .UNINDENT .sp هنگام استفاده از این گذرواژه تنها کنش‌های مشخص‌شده مجاز خواهند بود. از الگوهای گلوب نیز می‌توان استفاده کرد، برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX remote_control_password \(dqmy passphrase\(dq set\-tab\-* resize\-* .EE .UNINDENT .UNINDENT .sp برای دریافت فهرستی از کنش‌های موجود، اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten @ \-\-help .EE .UNINDENT .UNINDENT .sp مجموعه‌ای از کنش‌ها را که در صورت ارسال نشدن هیچ گذرواژه‌ای مجاز هستند، می‌توان با استفاده از یک گذرواژه خالی مشخص کرد. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX remote_control_password \(dq\(dq *\-colors .EE .UNINDENT .UNINDENT .sp در نهایت، می‌توان مسیر یک پودمان python را مشخص کرد که تابعی به نام \fBis_cmd_allowed\fP ارائه می‌دهد که برای بررسی هر فرمان کنترل از راه دور استفاده می‌شود. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX remote_control_password \(dqmy passphrase\(dq my_rc_command_checker.py .EE .UNINDENT .UNINDENT .sp مسیرهای نسبی نسبت به شاخه پیکربندی kitty حل می‌شوند. برای جزئیات به Customizing authorization with your own program \%<#\:rc-custom-auth> مراجعه کنید. .INDENT 0.0 .TP .B allow_remote_control .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX allow_remote_control no .EE .UNINDENT .UNINDENT .sp اجازه به برنامه‌های دیگر برای کنترل kitty. در صورت فعال کردن این گزینه، برنامه‌های دیگر می‌توانند تمام جنبه‌های kitty را کنترل کنند، از جمله ارسال متن به پنجره‌های kitty، باز کردن پنجره‌های جدید، بستن پنجره‌ها، خواندن محتوای پنجره‌ها و غیره. توجه داشته باشید که این حتی روی اتصالات SSH نیز کار می‌کند. تنظیم پیش‌فرض \fBno\fP از هر گونه کنترل از راه دور جلوگیری می‌کند. معنی مقادیر مختلف به شرح زیر است: .INDENT 0.0 .TP .B \fBpassword\fP درخواست‌های کنترل از راه دور دریافت‌شده از طریق هر دو دستگاه TTY و سوکت بر اساس گذرواژه‌ها تأیید می‌شوند، \fBremote_control_password\fP را ببینید. .TP .B \fBsocket\-only\fP درخواست‌های کنترل از راه دور دریافت‌شده روی سوکت بدون قید و شرط پذیرفته می‌شوند. درخواست‌های دریافت‌شده روی TTY رد می‌شوند. \fBlisten_on\fP را ببینید. .TP .B \fBsocket\fP درخواست‌های کنترل از راه دور دریافت‌شده روی سوکت بدون قید و شرط پذیرفته می‌شوند. درخواست‌های دریافت‌شده روی TTY بر اساس گذرواژه تأیید می‌شوند. .TP .B \fBno\fP کنترل از راه دور کاملاً غیرفعال است. .TP .B \fByes\fP درخواست‌های کنترل از راه دور همواره پذیرفته می‌شوند. .UNINDENT .INDENT 0.0 .TP .B listen_on .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX listen_on none .EE .UNINDENT .UNINDENT .sp گوش دادن به سوکت مشخص‌شده برای اتصالات کنترل از راه دور. توجه داشته باشید که این برای تمام نمونه‌های kitty اعمال خواهد شد. این مقدار می‌تواند توسط گزینه خط فرمان \fBkitty \-\-listen\-on\fP \%<#\:cmdoption-kitty-listen-on> بازنویسی شود. برای سوکت‌های UNIX مانند \fBunix:${TEMP}/mykitty\fP یا \fBunix:@mykitty\fP (در Linux). متغیرهای محیطی بسط داده شده و مسیرهای نسبی نسبت به شاخه موقت حل می‌شوند. اگر \fB{kitty_pid}\fP وجود داشته باشد، با PID فرایند kitty جایگزین می‌شود، در غیر این صورت PID فرایند kitty با یک خط تیره به انتهای مقدار اضافه می‌شود. برای سوکت‌های TCP مانند \fBtcp:localhost:0\fP، همیشه یک پورت تصادفی استفاده می‌شود حتی اگر شماره پورت غیرصفر مشخص شده باشد. برای جزئیات بیشتر راهنمای \fBkitty \-\-listen\-on\fP \%<#\:cmdoption-kitty-listen-on> را ببینید. توجه داشته باشید که این مقدار نادیده گرفته خواهد شد مگر اینکه \fBallow_remote_control\fP روی یکی از مقادیر \fByes\fP، \fBsocket\fP یا \fBsocket\-only\fP تنظیم شده باشد. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. .INDENT 0.0 .TP .B env .UNINDENT .sp مشخص کردن متغیرهای محیطی برای تنظیم در تمامی فرایندهای فرزند. استفاده از نام همراه با علامت مساوی (مانند \fBenv VAR=\fP) آن را روی یک رشته خالی تنظیم می‌کند. مشخص کردن صرفاً نام (مانند \fBenv VAR\fP) متغیر را از محیط فرایند فرزند حذف می‌کند. توجه داشته باشید که متغیرهای محیطی به صورت بازگشتی بسط می‌یابند، برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX env VAR1=a env VAR2=${HOME}/${VAR1}/b .EE .UNINDENT .UNINDENT .sp مقدار \fBVAR2\fP برابر با \fB/a/b\fP خواهد بود. .sp از مقدار ویژه \fBread_from_shell\fP استفاده کنید تا kitty متغیرهای مشخص‌شده را از پیکربندی \fBlogin shell\fP شما بخواند. کاربردی است اگر پرونده‌های راه‌اندازی شل شما مجموعه‌ای از متغیرهای محیطی را تنظیم می‌کنند که می‌خواهید برای kitty و در پرونده‌های نشست kitty در دسترس باشند. هر نام متغیر به عنوان یک الگوی گلوب برای تطبیق در نظر گرفته می‌شود. برای نمونه: \fBenv read_from_shell=PATH LANG LC_* XDG_* EDITOR VISUAL\fP\&. توجه داشته باشید که این متغیرها تنها پس از پردازش کامل پیکربندی خوانده می‌شوند، بنابراین برای بسط بازگشتی در دسترس نیستند و بر هر متغیر تنظیم‌شده توسط دستورات دیگر \fBenv\fP برتری خواهند داشت. .INDENT 0.0 .TP .B filter_notification .UNINDENT .sp مشخص کردن قواعد برای فیلتر کردن اعلان‌های ارسال‌شده توسط برنامه‌های در حال اجرا در kitty. می‌توان چندین بار برای ایجاد چندین قاعده فیلتر مشخص کرد. مشخصات یک قاعده به شکل \fBfield:regexp\fP است. یک قاعده فیلتر می‌تواند روی هر یک از فیلدهای \fBtitle\fP، \fBbody\fP، \fBapp\fP، \fBtype\fP تطبیق یابد. مقدار ویژه \fBall\fP تمامی اعلان‌ها را فیلتر می‌کند. قواعد را می‌توان با استفاده از عملگرهای بولی ترکیب کرد. چند نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX filter_notification title:hello or body:\(dqabc.*def\(dq # فیلتر کردن اعلان‌ها از vim به جز مواردی که درباره به‌روزرسانی هستند، (?i) # تطبیق را به حروف کوچک و بزرگ حساس نمی‌کند. filter_notification app:\(dq[ng]?vim\(dq and not body:\(dq(?i)update\(dq # فیلتر کردن تمام اعلان‌ها filter_notification all .EE .UNINDENT .UNINDENT .sp فیلد \fBapp\fP نام برنامه ارسال‌کننده اعلان و \fBtype\fP نوع اعلان است. همه برنامه‌ها این فیلدها را ارسال نمی‌کنند، بنابراین می‌توانید روی عنوان و متن اعلان نیز تطبیق دهید. فیلترهای برنامه‌نویسی‌شده پیشرفته‌تر و کنش‌های سفارشی روی اعلان‌ها را می‌توان با ایجاد یک پرونده notifications.py در شاخه پیکربندی kitty (\fB~/.config/kitty\fP) انجام داد. یک نمونه حاشیه‌نویسی‌شده در \%\& در دسترس است. .INDENT 0.0 .TP .B watcher .UNINDENT .sp مسیر پرونده python که برای Watching launched windows \%<#\:watchers>\& بارگذاری خواهد شد. می‌توان بیش از یک بار برای بارگذاری چندین ناظر مشخص کرد. ناظرها به هر پنجره kitty اضافه خواهند شد. مسیرهای نسبی نسبت به شاخه پیکربندی kitty حل می‌شوند. توجه داشته باشید که بارگذاری مجدد پیکربندی فقط روی پنجره‌های ایجادشده پس از بارگذاری مجدد تأثیر می‌گذارد. .INDENT 0.0 .TP .B exe_search_path .UNINDENT .sp کنترل محلی که kitty برنامه‌ها را برای اجرا پیدا می‌کند. ترتیب جستجوی پیش‌فرض عبارت است از: ابتدا جستجو در \fBPATH\fP سراسری سیستم، سپس \fB~/.local/bin\fP و \fB~/bin\fP\&. اگر همچنان یافت نشد، \fBPATH\fP تعریف‌شده در login shell پس از سورس کردن تمام پرونده‌های راه‌اندازی آن امتحان می‌شود. در نهایت در صورت وجود، \fBPATH\fP مشخص‌شده توسط گزینه \fBenv\fP امتحان می‌شود. .sp این گزینه به شما امکان می‌دهد مسیرها را به این ترتیب جستجو پیشوند، پسوند یا از آن حذف کنید. می‌توان چندین بار برای چندین مسیر مشخص کرد. یک مسیر ساده به ابتدای ترتیب جستجو اضافه می‌شود. مسیری که با علامت \fB+\fP شروع شود به انتهای ترتیب جستجو، پس از \fB~/bin\fP در بالا، اضافه خواهد شد. مسیری که با علامت \fB\-\fP شروع شود از کل ترتیب جستجو حذف خواهد شد. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX exe_search_path /some/prepended/path exe_search_path +/some/appended/path exe_search_path \-/some/excluded/path .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B update_check_interval .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX update_check_interval 24 .EE .UNINDENT .UNINDENT .sp بازه زمانی بررسی دوره‌ای برای در دسترس بودن به‌روزرسانی kitty (به ساعت). اگر به‌روزرسانی پیدا شود، یک اعلان سیستمی نمایش داده می‌شود که شما را از به‌روزرسانی موجود مطلع می‌کند. پیش‌فرض بررسی هر ۲۴ ساعت یک‌بار است، برای غیرفعال‌سازی روی صفر تنظیم کنید. بررسی به‌روزرسانی فقط توسط بیلدهای دودویی رسمی انجام می‌شود. بسته‌های توزیع یا بیلدهای منبع، بررسی به‌روزرسانی انجام نمی‌دهند. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. .INDENT 0.0 .TP .B auto_reload_config .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX auto_reload_config 0.1 .EE .UNINDENT .UNINDENT .sp بارگذاری مجدد خودکار پرونده‌های پیکربندی هنگام تغییر آن‌ها. این تنظیم تعداد ثانیه‌های انتظار پیش از بارگذاری مجدد پرونده‌های پیکربندی است. این امکان تثبیت و تجمیع تغییرات متعدد (debounce) را فراهم می‌کند. از یک مقدار منفی برای غیرفعال کردن بارگذاری مجدد خودکار استفاده کنید. می‌توانید به صورت دستی با \fBctrl+shift+f5\fP بارگذاری مجدد کنید. توجه داشته باشید که بارگذاری مجدد خودکار تنها در صورتی کار می‌کند که هنگام راه‌اندازی kitty پرونده \fBkitty.conf\fP از قبل وجود داشته باشد. تغییرات این تنظیم با بارگذاری مجدد پیکربندی نادیده گرفته می‌شوند. .INDENT 0.0 .TP .B startup_session .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX startup_session none .EE .UNINDENT .UNINDENT .sp مسیر پرونده نشست برای استفاده در تمامی نمونه‌های kitty. می‌تواند با استفاده از گزینه خط فرمان \fBkitty \-\-session\fP \%<#\:cmdoption-kitty-session> \fB=none\fP برای نمونه‌های مجزا لغو شود. برای جزئیات، Sessions \%<#\:sessions> را در مستندات kitty ببینید. توجه داشته باشید که مسیرهای نسبی نسبت به شاخه پیکربندی kitty تفسیر می‌شوند. متغیرهای محیطی درون مسیر بسط داده می‌شوند. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. توجه داشته باشید که اگر kitty با آرگومان‌های خط فرمان مشخص‌کننده یک فرمان برای اجرا فراخوانی شود، این گزینه نادیده گرفته می‌شود. .INDENT 0.0 .TP .B clipboard_control .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX clipboard_control write\-clipboard write\-primary read\-clipboard\-ask read\-primary\-ask .EE .UNINDENT .UNINDENT .sp اجازه به برنامه‌های در حال اجرا در kitty برای خواندن و نوشتن از کلیپ‌بورد. می‌توانید دقیقاً کنترل کنید که کدام کنش‌ها مجاز هستند. کنش‌های ممکن عبارتند از: \fBwrite\-clipboard\fP، \fBread\-clipboard\fP، \fBwrite\-primary\fP، \fBread\-primary\fP، \fBread\-clipboard\-ask\fP، \fBread\-primary\-ask\fP\&. پیش‌فرض اجازه نوشتن در کلیپ‌بورد و انتخاب اصلی و درخواست اجازه هنگام تلاش یک برنامه برای خواندن از کلیپ‌بورد است. توجه داشته باشید که غیرفعال کردن تأیید خواندن یک خطر امنیتی است زیرا بدین معنی است که هر برنامه‌ای، حتی برنامه‌های در حال اجرا روی یک سرور دوردست از طریق SSH، می‌توانند کلیپ‌بورد شما را بخوانند. همچنین \fBclipboard_max_size\fP را ببینید. .INDENT 0.0 .TP .B clipboard_max_size .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX clipboard_max_size 512 .EE .UNINDENT .UNINDENT .sp حداکثر اندازه (به مگابایت) داده‌های برنامه‌های در حال اجرا در kitty که برای نوشتن در کلیپ‌بورد سیستم ذخیره خواهد شد. مقدار صفر به معنی عدم اعمال محدودیت اندازه است. همچنین \fBclipboard_control\fP را ببینید. .INDENT 0.0 .TP .B file_transfer_confirmation_bypass .UNINDENT .sp گذرواژه‌ای که می‌تواند به file transfer kitten \%<> داده شود تا اعلان تایید انتقال نادیده گرفته شود. این گزینه فقط باید هنگام آغاز انتقال از رایانه‌های مورد اعتماد، بر روی شبکه‌های مورد اعتماد یا بسترهای رمزگذاری‌شده استفاده شود، زیرا به هر برنامه‌ای که روی ماشین دوردست اجرا می‌شود اجازه می‌دهد بدون اجازه روی فایل‌سیستم محلی بخواند/بنویسد. .INDENT 0.0 .TP .B allow_hyperlinks .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX allow_hyperlinks yes .EE .UNINDENT .UNINDENT .sp پردازش توالی‌های گریز پیوند (hyperlink \%<#\:term-hyperlinks>) (کد OSC 8). در صورت غیرفعال بودن، توالی‌های گریز OSC 8 نادیده گرفته می‌شوند. در غیر این صورت آن‌ها به پیوندهای قابل کلیک تبدیل می‌شوند که می‌توانید با موشواره یا با استفاده از hints kitten \%<>\& روی آن‌ها کلیک کنید. مقدار ویژه \fBask\fP به این معنی است که kitty قبل از باز کردن پیوند هنگام کلیک، سوال خواهد کرد. .INDENT 0.0 .TP .B shell_integration .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX shell_integration enabled .EE .UNINDENT .UNINDENT .sp فعال‌سازی یکپارچه‌سازی شل در شل‌های پشتیبانی‌شده. این کار قابلیت‌هایی مانند پرش به اعلان‌های قبلی، مرور خروجی فرمان قبلی در یک صفحه‌بند و غیره را در شل‌های پشتیبانی‌شده فعال می‌کند. برای غیرفعال کردن کامل یکپارچه‌سازی شل، روی \fBdisabled\fP تنظیم کنید. همچنین می‌توان ویژگی‌های مجزا را غیرفعال کرد، با تنظیم روی فهرستی از این مقادیر جدا شده با فاصله: \fBno\-rc\fP، \fBno\-cursor\fP، \fBno\-title\fP، \fBno\-cwd\fP، \fBno\-prompt\-mark\fP، \fBno\-complete\fP، \fBno\-sudo\fP\&. برای جزئیات به Shell integration \%<#\:shell-integration> مراجعه کنید. .INDENT 0.0 .TP .B allow_cloning .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX allow_cloning ask .EE .UNINDENT .UNINDENT .sp کنترل اینکه آیا برنامه‌های در حال اجرا در ترمینال می‌توانند درخواست ایجاد پنجره‌های جدید را بدهند یا خیر. نمونه بارز آن clone\-in\-kitty \%<#\:clone-shell>\& است. به صورت پیش‌فرض، kitty برای هر درخواست کلون اجازه خواهد گرفت. اجازه دادن به کلون بدون قید و شرط، به برنامه‌های در حال اجرا در ترمینال (از جمله از طریق SSH) اجازه می‌دهد تا کدهای دلخواه را به عنوان کاربری که ترمینال را اجرا می‌کند، روی رایانه‌ای که ترمینال روی آن اجرا می‌شود، اجرا کنند. .INDENT 0.0 .TP .B clone_source_strategies .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX clone_source_strategies venv,conda,env_var,path .EE .UNINDENT .UNINDENT .sp کنترل اینکه هنگام اجرای \fBclone\-in\-kitty\fP در پنجره تازه کلون‌شده، چه کد شلی سورس شود. راهبردهای پشتیبانی‌شده عبارتند از: .INDENT 0.0 .TP .B \fBvenv\fP سورس کردن پرونده \fB$VIRTUAL_ENV/bin/activate\fP\&. این توسط پودمان venv در کتابخانه استاندارد Python استفاده می‌شود و امکان کلون خودکار venvها را فراهم می‌کند. .TP .B \fBconda\fP اجرای \fBconda activate $CONDA_DEFAULT_ENV\fP\&. این از محیط‌های مجازی ایجادشده توسط \fBconda\fP پشتیبانی می‌کند. .TP .B \fBenv_var\fP اجرای محتوای متغیر محیطی \fBKITTY_CLONE_SOURCE_CODE\fP \%<#\:envvar-KITTY_CLONE_SOURCE_CODE> با \fBeval\fP\&. .TP .B \fBpath\fP سورس کردن پرونده‌ای که متغیر محیطی \fBKITTY_CLONE_SOURCE_PATH\fP \%<#\:envvar-KITTY_CLONE_SOURCE_PATH> به آن اشاره می‌کند. .UNINDENT .sp این گزینه باید فهرستی جداشده با کاما از مقادیر بالا باشد. فقط اولین تطابق معتبر، به ترتیبی که مشخص شده است، سورس می‌شود. .INDENT 0.0 .TP .B notify_on_cmd_finish .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX notify_on_cmd_finish never .EE .UNINDENT .UNINDENT .sp نمایش اعلان دسکتاپ هنگام پایان یافتن یک فرمان طولانی‌مدت (نیازمند \fBshell_integration\fP). مقادیر ممکن عبارتند از: .INDENT 0.0 .TP .B \fBnever\fP هرگز اعلان ارسال نشود. .TP .B \fBunfocused\fP تنها زمانی اعلان ارسال شود که پنجره فوکوس صفحه‌کلید را ندارد. .TP .B \fBinvisible\fP تنها زمانی اعلان ارسال شود که پنجره هم بدون فوکوس بوده و هم برای کاربر قابل مشاهده نباشد؛ به عنوان مثال به دلیل قرار داشتن در یک برگه غیرفعال یا اینکه پنجره سیستم‌عامل در حال حاضر قابل مشاهده نباشد (در پلتفرم‌هایی که از پرس‌وجوی وضعیت دید پنجره سیستم‌عامل پشتیبانی می‌کنند، یک پنجره سیستم‌عامل تنها در صورتی مرئی در نظر گرفته می‌شود که فعال باشد). .TP .B \fBalways\fP همیشه اعلان ارسال شود، صرف‌نظر از وضعیت پنجره. .UNINDENT .sp دو آرگومان اختیاری وجود دارد: .sp نخست، حداقل مدت زمان برای اینکه فرمانی طولانی‌مدت در نظر گرفته شود. مقدار پیش‌فرض ۵ ثانیه است. یک آرگومان دوم برای تنظیم مدت زمان مشخص کنید. برای نمونه: \fBinvisible 15\fP\&. این مقدار را خیلی کم تنظیم نکنید، در غیر این صورت فرمانی که پنجره سیستم‌عامل جدیدی باز کرده و خارج می‌شود باعث هرز ارسال شدن اعلان خواهد شد. .sp دوم، کنشی که باید انجام شود. پیش‌فرض \fBnotify\fP است. مقادیر ممکن عبارتند از: .INDENT 0.0 .TP .B \fBnotify\fP ارسال یک اعلان دسکتاپ. آرگومان‌های بعدی اختیاری هستند و مشخص می‌کنند چه زمانی اعلان به صورت خودکار پاک شود. مجموعه رویدادهای ممکن برای پاک شدن اعلان عبارتند از: \fBfocus\fP و \fBnext\fP\&. مقدار \fBfocus\fP بدین معنی است که وقتی سیاست اعلان \fBunfocused\fP یا \fBinvisible\fP باشد، با بازگشت فوکوس به پنجره اعلان به صورت خودکار پاک می‌شود. مقدار \fBnext\fP به این معنی است که با نمایش اعلان بعدی، اعلان قبلی پاک می‌شود. پیش‌فرض در صورت مشخص نشدن آرگومان‌ها عبارت است از: \fBfocus next\fP\&. .TP .B \fBbell\fP به صدا درآوردن زنگ ترمینال. .TP .B \fBnotify\-bell\fP ارسال اعلان میزکار و به صدا درآوردن زنگ ترمینال. آرگومان‌ها مشابه \fInotify\fP هستند\&. .TP .B \fBcommand\fP اجرای یک دستور سفارشی. تمام آرگومان‌های بعدی خط فرمانی هستند که باید اجرا شود. .UNINDENT .sp چند مثال دیگر: .INDENT 0.0 .INDENT 3.5 .sp .EX # ارسال اعلان زمانی که یک دستور بیش از ۵ ثانیه در پنجره غیرفعال طول بکشد notify_on_cmd_finish unfocused # ارسال اعلان زمانی که یک دستور بیش از ۱۰ ثانیه در یک پنجره نامرئی طول بکشد notify_on_cmd_finish invisible 10.0 # به صدا درآوردن زنگ زمانی که یک دستور بیش از ۱۰ ثانیه در یک پنجره نامرئی طول بکشد notify_on_cmd_finish invisible 10.0 bell # اجرای \(aqnotify\-send\(aq وقتی دستوری بیش از ۱۰ ثانیه در پنجره نامرئی طول بکشد # در اینجا %c با خط فرمان فعلی و %s با کد خروج جایگزین می‌شود notify_on_cmd_finish invisible 10.0 command notify\-send \(dqjob finished with status: %s\(dq %c # پاک نکردن اعلان قبلی هنگام پایان دستور بعدی یا فوکوس مجدد روی پنجره notify_on_cmd_finish invisible 5.0 notify .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B term .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX term xterm\-kitty .EE .UNINDENT .UNINDENT .sp مقدار متغیر محیطی \fBTERM\fP \%<#\:envvar-TERM> برای تنظیم. تغییر این مقدار می‌تواند عملکرد بسیاری از برنامه‌های ترمینال را مختل کند؛ تنها در صورتی آن را تغییر دهید که دقیقاً می‌دانید چه می‌کنید، نه به این دلیل که در «Stack Overflow» توصیه‌ای برای تغییر آن خوانده‌اید. متغیر \fBTERM\fP \%<#\:envvar-TERM> توسط برنامه‌های مختلف برای کسب اطلاعات درباره قابلیت‌ها و رفتار ترمینال استفاده می‌شود. اگر آن را تغییر دهید، بسته به برنامه‌هایی که اجرا می‌کنید و میزان تفاوت ترمینال انتخابی، موارد گوناگونی از فشردن کلیدها گرفته تا رنگ‌ها و ویژگی‌های پیشرفته مختلف ممکن است کار نکنند. تغییر این گزینه با بارگذاری مجدد پیکربندی تنها روی پنجره‌های تازه‌ساخته‌شده تأثیر خواهد گذاشت. .INDENT 0.0 .TP .B terminfo_type .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX terminfo_type path .EE .UNINDENT .UNINDENT .sp مقدار متغیر محیطی \fBTERMINFO\fP \%<#\:envvar-TERMINFO> برای تنظیم. این متغیر توسط برنامه‌های در حال اجرا در ترمینال برای جستجوی پایگاه‌داده‌های terminfo استفاده می‌شود. مقدار پیش‌فرض \fBpath\fP باعث می‌شود kitty آن را روی مسیری در سیستم فایل که شامل پایگاه‌داده terminfo مربوط به kitty است تنظیم کند. مقدار \fBdirect\fP به معنای قرار دادن مستقیم کل پایگاه‌داده درون متغیر محیطی است. این مورد برای مثال هنگام اتصال به کانتینرها می‌تواند مفید باشد. اما توجه داشته باشید که همه نرم‌افزارها از این قابلیت پشتیبانی نمی‌کنند. مقدار \fBnone\fP به معنای دست نزدن به متغیر است. .INDENT 0.0 .TP .B forward_stdio .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX forward_stdio no .EE .UNINDENT .UNINDENT .sp هدایت STDOUT و STDERR فرایند kitty به فرایندهای فرزند. این قابلیت برای اشکال‌زدایی مفید است زیرا به فرایندهای فرزند اجازه می‌دهد مستقیماً در STDOUT مربوط به kitty چاپ کنند. برای مثال، \fBecho hello world >&$KITTY_STDIO_FORWARDED\fP در یک پوسته، در STDOUT والد kitty چاپ خواهد شد. این گزینه متغیر محیطی \fBKITTY_STDIO_FORWARDED=fdnum\fP را تنظیم می‌کند تا فرایندهای فرزند از این هدایت مطلع شوند. توجه داشته باشید که در macOS این امر از اجرای پوسته از طریق ابزار login جلوگیری می‌کند، بنابراین getlogin() در برنامه‌های اجراشده در این نشست کار نخواهد کرد. .INDENT 0.0 .TP .B menu_map .UNINDENT .sp مشخص کردن مدخل‌ها برای منوهای مختلف در kitty. در حال حاضر تنها نوار منوی سراسری در macOS پشتیبانی می‌شود. برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX menu_map global \(dqActions::Launch something special\(dq launch \-\-hold \-\-type=os\-window sh \-c \(dqecho hello world\(dq .EE .UNINDENT .UNINDENT .sp این کار یک مدخل منو به نام «Launch something special» در منوی «Actions» در نوار منوی سراسری macOS ایجاد می‌کند. زیرمنوها را می‌توان با افزودن سطوح بیشتر که با نویسه‌های \fB::\fP جدا شده‌اند ایجاد کرد. .SH "تنظیمات ویژه سیستم‌عامل (OS SPECIFIC TWEAKS)" .INDENT 0.0 .TP .B wayland_titlebar_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX wayland_titlebar_color system .EE .UNINDENT .UNINDENT .sp رنگ نوار عنوان پنجره kitty در سیستم‌های Wayland با تزئینات پنجره سمت کلاینت مانند GNOME. مقدار \fBsystem\fP به معنای استفاده از رنگ‌های پیش‌فرض سیستم است، مقدار \fBbackground\fP به معنای استفاده از رنگ پس‌زمینه پنجره فعال فعلی kitty است و در نهایت می‌توانید از یک رنگ دلخواه مانند \fB#12af59\fP یا \fBred\fP استفاده کنید\&. .INDENT 0.0 .TP .B macos_titlebar_color .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_titlebar_color system .EE .UNINDENT .UNINDENT .sp رنگ نوار عنوان پنجره kitty در macOS. مقدار \fBsystem\fP به معنای استفاده از رنگ پیش‌فرض سیستم است، \fBlight\fP یا \fBdark\fP نیز می‌تواند برای تنظیم صریح استفاده شود. مقدار \fBbackground\fP به معنای استفاده از رنگ پس‌زمینه پنجره فعال فعلی است و در نهایت می‌توانید از یک رنگ دلخواه مانند \fB#12af59\fP یا \fBred\fP استفاده کنید\&. .sp توجه داشته باشید که هنگام استفاده از تغییر خودکار تم رنگی بر اساس تغییر حالت روشن/تاریک سیستم‌عامل \%<#\:auto-color-scheme>، این گزینه توسط پرونده طرح رنگ بازنویسی می‌شود و برای اعمال باید داخل آن تنظیم گردد. .INDENT 0.0 .TP .B macos_option_as_alt .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_option_as_alt no .EE .UNINDENT .UNINDENT .sp استفاده از کلید \fBOption\fP به عنوان کلید \fBAlt\fP در macOS. با تنظیم این گزینه روی \fBno\fP، kitty از رفتار بومی macOS برای فشردن \fBOption\fP+\fBKey\fP جهت درج نویسه‌های یونیکد استفاده خواهد کرد. این کار تمام میانبرهای صفحه‌کلید \fBAlt\fP+\fBKey\fP را در برنامه‌های ترمینال شما از کار می‌اندازد، اما می‌توانید از روش ورودی یونیکد macOS بهره ببرید. می‌توانید از مقادیر: \fBleft\fP، \fBright\fP یا \fBboth\fP استفاده کنید تا به جای آن فقط کلیدهای چپ، راست یا هر دو کلید \fBOption\fP به عنوان \fBAlt\fP عمل کنند. توجه داشته باشید که خود kitty همیشه با \fBOption\fP همانند \fBAlt\fP رفتار می‌کند\&. این بدان معناست که نمی‌توانید از این گزینه برای پیکربندی میانبرهای متفاوت kitty برای \fBOption\fP+\fBKey\fP در مقابل \fBAlt\fP+\fBKey\fP استفاده کنید\&. همچنین، هر میانبر kitty که از \fBOption/Alt\fP+\fBKey\fP استفاده کند اولویت خواهد داشت، به طوری که چنین فشردن کلیدهایی به برنامه‌های ترمینال در حال اجرا داخل kitty ارسال نخواهند شد. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. .INDENT 0.0 .TP .B macos_hide_from_tasks .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_hide_from_tasks no .EE .UNINDENT .UNINDENT .sp پنهان کردن پنجره kitty از لیست وظایف در حال اجرا در macOS (\fB⌘\fP+\fBTab\fP و داک). تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. .INDENT 0.0 .TP .B macos_quit_when_last_window_closed .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_quit_when_last_window_closed no .EE .UNINDENT .UNINDENT .sp خروج از kitty هنگامی که تمام پنجره‌های سطح بالا (top-level) در macOS بسته می‌شوند. به‌طور پیش‌فرض، kitty حتی بدون پنجره‌های باز در حال اجرا باقی می‌ماند، همان‌طور که رفتار مورد انتظار در macOS است. .INDENT 0.0 .TP .B macos_window_resizable .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_window_resizable yes .EE .UNINDENT .UNINDENT .sp اگر می‌خواهید پنجره‌های سطح بالای سیستم‌عامل kitty در macOS غیرقابل تغییر اندازه باشند، این گزینه را غیرفعال کنید. .INDENT 0.0 .TP .B macos_thicken_font .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_thicken_font 0 .EE .UNINDENT .UNINDENT .sp ترسیم یک حاشیه اضافی در اطراف قلم با عرض مشخص‌شده، برای افزایش خوانایی در اندازه‌های کوچک قلم در macOS. برای مثال، مقدار \fB0.75\fP منجر به رندری می‌شود که در اندازه‌های معمول قلم شبیه به sub\-pixel antialiasing به نظر می‌رسد. توجه داشته باشید که در نگارش‌های مدرن kitty، این گزینه منسوخ شده است (اگرچه هنوز پشتیبانی می‌شود). به جای آن استفاده از \fBtext_composition_strategy\fP را در نظر داشته باشید. .INDENT 0.0 .TP .B macos_traditional_fullscreen .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_traditional_fullscreen no .EE .UNINDENT .UNINDENT .sp استفاده از حالت تمام‌صفحه سنتی macOS که سریع‌تر اما از نظر بصری ساده‌تر است. .INDENT 0.0 .TP .B macos_fullscreen_ignore_safe_area_insets .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_fullscreen_ignore_safe_area_insets no .EE .UNINDENT .UNINDENT .sp هنگام استفاده از \fBmacos_traditional_fullscreen\fP، فاصله‌های حاشیه امن (safe area insets) در نمایشگرهایی مانند صفحه‌نمایش مک‌بوک‌های دارای ناچ نادیده گرفته می‌شود. این به kitty اجازه می‌دهد تا به جای خالی گذاشتن فضا برای ناحیه ناچ، از تمام کادر نمایشگر استفاده کند. .INDENT 0.0 .TP .B macos_use_physical_screen_frame .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_use_physical_screen_frame no .EE .UNINDENT .UNINDENT .sp استفاده از کادر فیزیکی صفحه به جای کادر مرئی هنگام قرار دادن پنل‌های میزکار macOS مانند پنل‌های ایجادشده توسط \fBkitty +kitten panel\fP\&. این به پنل‌ها اجازه می‌دهد در نواحی‌ای که معمولاً برای نوار منوی بومی یا داک رزرو شده‌اند ترسیم شوند. همچنین \fBmacos_ns_window_layer\fP را ببینید\&. .INDENT 0.0 .TP .B macos_ns_window_layer .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_ns_window_layer unset .EE .UNINDENT .UNINDENT .sp تنظیم سطح NSWindow در macOS برای پنجره‌های پنل تازه‌ساخته‌شده سیستم‌عامل مانند موارد ساخته‌شده با panel kitten \%<>\&. مقدار پیش‌فرض \fBunset\fP مدیریت سطح عادی را بدون تغییر باقی می‌گذارد. مقادیر می‌توانند سطوح عددی صحیح پنجره، نام ثابت‌های سطح پنجره در AppKit/CoreGraphics، یا عبارت‌های محاسباتی ساده ترکیبی از آن‌ها با اعداد صحیح باشند. برای مثال: \fBNSFloatingWindowLevel\fP، \fBkCGBackstopMenuLevel\fP، \fBNSPopUpMenuWindowLevel \- 1\fP\&. همچنین :macos_use_physical_screen_frame\(ga را ببینید. .INDENT 0.0 .TP .B macos_show_window_title_in .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_show_window_title_in all .EE .UNINDENT .UNINDENT .sp کنترل محل نمایش عنوان پنجره در macOS. مقدار \fBwindow\fP عنوان پنجره فعال فعلی را در بالای پنجره macOS نشان می‌دهد. مقدار \fBmenubar\fP عنوان پنجره فعال فعلی را در نوار منوی سراسری macOS نشان می‌دهد و از فضای بی‌استفاده بهره می‌برد. مقدار \fBall\fP عنوان را در هر دو مکان نشان می‌دهد و \fBnone\fP عنوان را پنهان می‌کند. برای نحوه کنترل طول عنوان در نوار منو، \fBmacos_menubar_title_max_length\fP را ببینید. .INDENT 0.0 .TP .B macos_menubar_title_max_length .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_menubar_title_max_length 0 .EE .UNINDENT .UNINDENT .sp حداکثر تعداد نویسه‌های عنوان پنجره برای نمایش در نوار منوی سراسری macOS. مقادیر کمتر از یک به این معنی است که هیچ محدودیتی وجود ندارد. .INDENT 0.0 .TP .B macos_custom_beam_cursor .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_custom_beam_cursor no .EE .UNINDENT .UNINDENT .sp استفاده از مکان‌نمای موشواره سفارشی برای macOS که دیدن آن در هر دو پس‌زمینه روشن و تاریک آسان‌تر است. امروزه، مکان‌نمای پیش‌فرض macOS از قبل با یک حاشیه سفید ارائه می‌شود. هشدار: این گزینه ممکن است مکان‌نمای موشواره شما را در دستگاه‌های دارای دو پردازنده گرافیکی (dual GPU) نامرئی کند. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. .INDENT 0.0 .TP .B macos_colorspace .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX macos_colorspace srgb .EE .UNINDENT .UNINDENT .sp فضای رنگی که رنگ‌های ترمینال در آن تفسیر می‌شوند. مقدار پیش‌فرض \fBsrgb\fP باعث می‌شود رنگ‌ها با رنگ‌های مشاهده‌شده در مرورگرهای وب مطابقت داشته باشند. مقدار \fBdefault\fP از هر آنچه که فضای رنگی بومی نمایشگر است استفاده می‌کند. مقدار \fBdisplayp3\fP از فضای رنگی ویژه Display P3 اپل استفاده خواهد کرد که منجر به رنگ‌های اشباع‌شده‌تر (روشن‌تر) همراه با مقداری تغییر رنگ می‌شود. بارگذاری مجدد پیکربندی این مقدار را فقط برای پنجره‌های تازه ایجاد شده سیستم‌عامل تغییر می‌دهد. .INDENT 0.0 .TP .B linux_display_server .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX linux_display_server auto .EE .UNINDENT .UNINDENT .sp انتخاب بین زیرسیستم‌های گرافیکی Wayland و X11. به‌طور پیش‌فرض، بک‌اند مناسب بر اساس وضعیت سیستم به‌طور خودکار انتخاب می‌شود. برای اجبار در انتخاب، آن را روی \fBx11\fP یا \fBwayland\fP تنظیم کنید. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود. .INDENT 0.0 .TP .B wayland_enable_ime .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX wayland_enable_ime yes .EE .UNINDENT .UNINDENT .sp فعال‌سازی افزونه روش ورودی (IME) در Wayland. این مورد معمولاً برای وارد کردن متن در زبان‌های شرق آسیا استفاده می‌شود. با این حال، پیاده‌سازی آن در Wayland اغلب دارای باگ است و باعث ایجاد تاخیر در حلقه ورودی می‌شود؛ بنابراین اگر می‌دانید به آن نیازی ندارید آن را غیرفعال کنید. تغییر این گزینه با بارگذاری مجدد پیکربندی پشتیبانی نمی‌شود و هیچ تأثیری نخواهد داشت. .SH "میانبرهای صفحه‌کلید (KEYBOARD SHORTCUTS)" .sp کلیدها به سادگی با نویسه‌های یونیکد کوچک خود مشخص می‌شوند. برای مثال: \fBa\fP برای کلید \fBA\fP، \fB[\fP برای کلید براکت چپ، و غیره. برای کلیدهای کاربردی، مانند \fBEnter\fP یا \fBEscape\fP، نام‌ها در تعاریف کلیدهای کاربردی \%<#\:functional>\& موجود است. برای کلیدهای تبدیل‌کننده (modifier)، نام‌ها عبارتند از: \fBctrl\fP (\fBcontrol\fP، \fB⌃\fP)، \fBshift\fP (\fB⇧\fP)، \fBalt\fP (\fBopt\fP، \fBoption\fP، \fB⌥\fP)، \fBsuper\fP (\fBcmd\fP، \fBcommand\fP، \fB⌘\fP). .sp نگاشت ساده میانبرها با دستور \fBmap\fP انجام می‌شود. برای جزئیات کامل درباره نگاشت‌های پیشرفته از جمله نگاشت‌های حالتی (modal) و مختص هر برنامه، به Making your keyboard dance \%<>\& مراجعه کنید. چند مثال سریع برای نشان دادن وظایف معمول: .INDENT 0.0 .INDENT 3.5 .sp .EX # لغو نگاشت میانبر صفحه‌کلید و ارسال آن به برنامه در حال اجرا در kitty map kitty_mod+space # نادیده گرفتن کامل یک رویداد صفحه‌کلید map ctrl+alt+f1 discard_event # ترکیب چند عمل map kitty_mod+e combine : new_window : next_layout # میانبرهای چندکلیدی map ctrl+x>ctrl+y>z action .EE .UNINDENT .UNINDENT .sp برای چیدمان‌های صفحه‌کلید غیرلاتین (روسی، عربی و غیره)، گزینه \fB\-\-allow\-fallback\fP رفتار کلید جایگزین فیزیکی را کنترل می‌کند. مقادیر: \fBshifted\fP (پیش‌فرض — کلید جایگزین با کلید shift)، \fBascii\fP (کلید جایگزین / موقعیت فیزیکی کلید، فقط برای کلیدهای غیر ASCII)، \fBnone\fP (غیرفعال کردن تمام حالت‌های جایگزین)، یا ترکیبی از آن‌ها که با کاما جدا شده باشد. تمام میانبرهای پیش‌فرض از \fB\-\-allow\-fallback=shifted,ascii\fP استفاده می‌کنند: .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii kitty_mod+c copy_to_clipboard .EE .UNINDENT .UNINDENT .sp می‌توانید با فشردن \fBctrl+shift+f3\fP برای اجرای پالت دستورات، این عمل‌ها را مرور و فراخوانی کنید. فهرست کامل عمل‌هایی که می‌توان به فشردن کلیدها نگاشت کرد در اینجا \%<>\& در دسترس است. .INDENT 0.0 .TP .B kitty_mod .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX kitty_mod ctrl+shift .EE .UNINDENT .UNINDENT .sp نام مستعار ویژه کلید تبدیل‌کننده (modifier) برای میانبرهای پیش‌فرض. می‌توانید مقدار این گزینه را تغییر دهید تا تمام میانبرهای پیش‌فرضی که از \fBkitty_mod\fP استفاده می‌کنند تغییر یابند\&. .INDENT 0.0 .TP .B clear_all_shortcuts .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX clear_all_shortcuts no .EE .UNINDENT .UNINDENT .sp حذف تمام تعاریف میانبرها تا این نقطه از پرونده. برای مثال، جهت حذف میانبرهای پیش‌فرض کاربرد دارد. .INDENT 0.0 .TP .B map_timeout .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map_timeout 0.0 .EE .UNINDENT .UNINDENT .sp مهلت زمانی پیش‌فرض (به ثانیه) برای نگاشت‌های چندکلیدی و حالت‌های modal صفحه‌کلید. اگر کلید(های) اول یک نگاشت چندکلیدی را فشار دهید و کلید بعدی را درون این مهلت زمانی فشار ندهید، نگاشت لغو شده و از آن حالت خارج می‌شود. مقدار صفر مهلت زمانی را غیرفعال می‌کند. این مورد را می‌توان برای حالت‌های خاص با استفاده از گزینه \fB\-\-timeout\fP هنگام ایجاد حالت صفحه‌کلید با \fB\-\-new\-mode\fP بازنویسی کرد\&. برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX # مهلت زمانی ۲ ثانیه‌ای برای تمام نگاشت‌ها map_timeout 2.0 # این حالت دارای مهلت زمانی ۵ ثانیه‌ای خواهد بود (مهلت زمانی سراسری ۲ ثانیه‌ای را بازنویسی می‌کند) map \-\-new\-mode resize \-\-timeout 5.0 kitty_mod+r .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B action_alias .UNINDENT .sp هیچ مقدار پیش‌فرضی ندارد. مقادیر نمونه در زیر نشان داده شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX action_alias launch_tab launch \-\-type=tab \-\-cwd=current .EE .UNINDENT .UNINDENT .sp تعریف نام‌های مستعار برای عمل‌ها جهت جلوگیری از تکرار گزینه‌های یکسان در نگاشت‌های مختلف. نام‌های مستعار را می‌توان برای هر عملی تعریف کرد و به صورت بازگشتی گسترش می‌یابند. برای مثال، نام مستعار بالا به شما امکان می‌دهد نگاشت‌هایی برای باز کردن یک برگه جدید در دایرکتوری کاری فعلی بدون تکرار کد ایجاد کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 launch_tab vim map f2 launch_tab emacs .EE .UNINDENT .UNINDENT .sp به طور مشابه، برای نام مستعار فراخوانی kitten: .INDENT 0.0 .INDENT 3.5 .sp .EX action_alias hints kitten hints \-\-hints\-offset=0 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B kitten_alias .UNINDENT .sp مقدار پیش‌فرضی ندارد. مقادیر نمونه در زیر نشان داده شده است: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten_alias hints hints \-\-hints\-offset=0 .EE .UNINDENT .UNINDENT .sp مانند \fBaction_alias\fP در بالا، ولی به‌طور خاص برای kittenها. به‌طور کلی، استفاده از \fBaction_alias\fP ترجیح داده می‌شود\&. این گزینه یک نسخه قدیمی است که برای سازگاری با نسخه‌های پیشین وجود دارد. این گزینه باعث می‌شود تمام فراخوانی‌های kitten نام‌مستعار جایگزین شوند. بنابراین مثال بالا باعث می‌شود همه فراخوانی‌های kitten مربوط به hints با گزینه \fB\-\-hints\-offset=0\fP \%<#\:cmdoption-kitty-kitten-hints-hints-offset> اعمال شوند. .SS بریده‌دان (Clipboard) .INDENT 0.0 .TP .B کپی به بریده‌دان .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+c copy_to_clipboard .EE .UNINDENT .UNINDENT .sp همچنین کنش \fBcopy_or_interrupt\fP \%<#\:action-copy_or_interrupt> وجود دارد که می‌تواند به‌صورت اختیاری روی \fBCtrl\fP+\fBC\fP نگاشت شود\&. این کنش تنها در صورت وجود متن انتخاب‌شده کپی می‌کند و در غیر این صورت سیگنال وقفه (interrupt) می‌فرستد. به‌طور مشابه، \fBcopy_and_clear_or_interrupt\fP \%<#\:action-copy_and_clear_or_interrupt> متن انتخاب‌شده را کپی و پاک می‌کند یا در صورت عدم انتخاب، وقفه می‌فرستد. کنش \fBcopy_or_noop\fP \%<#\:action-copy_or_noop> در صورت وجود انتخاب کپی کرده و در صورت نبودن آن، کلید را بدون تغییر به برنامه در حال اجرا در ترمینال ارسال می‌کند. .INDENT 0.0 .TP .B کپی به بریده‌دان یا ارسال مستقیم کلید .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii cmd+c copy_or_noop 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B جای‌گذاری از بریده‌دان .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+v paste_from_clipboard map \-\-allow\-fallback=shifted,ascii cmd+v paste_from_clipboard 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B جای‌گذاری از متن انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+s paste_from_selection map shift+insert paste_from_selection .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B ارسال متن انتخاب‌شده به برنامه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+o pass_selection_to_program .EE .UNINDENT .UNINDENT .sp همچنین می‌توانید محتوای متن انتخاب‌شده فعلی را با \fBpass_selection_to_program\fP \%<#\:action-pass_selection_to_program> به هر برنامه‌ای ارسال کنید\&. به‌طور پیش‌فرض، برنامه open سیستم استفاده می‌شود، اما می‌توانید برنامه خود را مشخص کنید؛ متن انتخاب‌شده به‌عنوان یک آرگومان خط فرمان به برنامه فرستاده خواهد شد. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+o pass_selection_to_program firefox .EE .UNINDENT .UNINDENT .sp می‌توانید متن انتخاب‌شده فعلی را با استفاده از نگه‌دارنده مکان \fB@selection\fP به یک برنامه ترمینال در حال اجرا در یک پنجره جدید kitty بفرستید: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+y new_window less @selection .EE .UNINDENT .UNINDENT .SS پیمایش (Scrolling) .INDENT 0.0 .TP .B پیمایش یک خط به بالا .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+up scroll_line_up smooth map \-\-allow\-fallback=shifted,ascii ctrl+shift+k scroll_line_up smooth map opt+cmd+page_up scroll_line_up smooth 🍎 map cmd+up scroll_line_up smooth 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش یک خط به پایین .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+down scroll_line_down smooth map \-\-allow\-fallback=shifted,ascii ctrl+shift+j scroll_line_down smooth map opt+cmd+page_down scroll_line_down smooth 🍎 map cmd+down scroll_line_down smooth 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش یک صفحه به بالا .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+page_up scroll_page_up map cmd+page_up scroll_page_up 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش یک صفحه به پایین .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+page_down scroll_page_down map cmd+page_down scroll_page_down 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش به بالای صفحه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+home scroll_home map cmd+home scroll_home 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش به پایین صفحه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+end scroll_end map cmd+end scroll_end 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش به اعلان خط فرمان قبلی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+z scroll_to_prompt \-1 .EE .UNINDENT .UNINDENT .sp از پارامتر \fB0\fP برای \fBscroll_to_prompt\fP \%<#\:action-scroll_to_prompt> استفاده کنید تا به آخرین موقعیت پرش یا آخرین موقعیت کلیک‌شده پیمایش شود. برای کارکرد نیاز به shell integration \%<#\:shell-integration> دارد. .INDENT 0.0 .TP .B پیمایش به اعلان خط فرمان بعدی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+x scroll_to_prompt 1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B مرور بافر پیشینه پیمایش در صفحه‌بند .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+h show_scrollback .EE .UNINDENT .UNINDENT .sp می‌توانید محتوای صفحه فعلی و بافر تاریخچه را به‌عنوان \fBSTDIN\fP با استفاده از \fBlaunch \-\-stdin\-source\fP \%<#\:cmdoption-launch-stdin-source> به یک برنامه دلخواه هدایت (pipe) کنید\&. برای نمونه، دستور زیر بافر پیشینه پیمایش را در less و در یک پنجره overlay \%<#\:term-overlay> باز می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 launch \-\-stdin\-source=@screen_scrollback \-\-stdin\-add\-formatting \-\-type=overlay less +G \-R .EE .UNINDENT .UNINDENT .sp برای جزئیات بیشتر درباره هدایت محتوای صفحه و بافر به برنامه‌های خارجی، دستور launch \%<> را ببینید\&. .INDENT 0.0 .TP .B مرور خروجی آخرین دستور پوسته در صفحه‌بند .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+g show_last_command_output .EE .UNINDENT .UNINDENT .sp همچنین می‌توانید کلیدهای میانبر بیشتری برای دریافت خروجی دستور تعریف کنید. برای نمونه، جهت دریافت خروجی اولین دستور روی صفحه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 show_first_command_output_on_screen .EE .UNINDENT .UNINDENT .sp برای دریافت خروجی دستوری که آخرین بار توسط یک کنش صفحه‌کلید یا موشواره مورد دسترسی قرار گرفته است: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 show_last_visited_command_output .EE .UNINDENT .UNINDENT .sp می‌توانید خروجی آخرین دستور اجرا شده در پوسته را با استفاده از کنش \fBlaunch\fP \%<#\:action-launch> هدایت کنید. برای نمونه، دستور زیر خروجی را در less و در یک پنجره overlay \%<#\:term-overlay> باز می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 launch \-\-stdin\-source=@last_cmd_output \-\-stdin\-add\-formatting \-\-type=overlay less +G \-R .EE .UNINDENT .UNINDENT .sp برای دریافت خروجی اولین دستور روی صفحه، از \fB@first_cmd_output_on_screen\fP استفاده کنید\&. برای دریافت خروجی آخرین دستوری که به آن پریده‌اید، از \fB@last_visited_cmd_output\fP استفاده کنید\&. .sp برای کارکرد نیاز به shell integration \%<#\:shell-integration> دارد. .INDENT 0.0 .TP .B جستجو در پیشینه پیمایش در یک صفحه‌بند .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+/ search_scrollback map \-\-allow\-fallback=shifted,ascii cmd+f search_scrollback 🍎 .EE .UNINDENT .UNINDENT .sp جستجو برای متن انتخاب‌شده فعلی در پیشینه پیمایش با استفاده از \fBscrollback_pager\fP پیکربندی‌شده\&. فرض بر این است که فشردن کلید \fB/\fP حالت جستجو را در صفحه‌بند فعال می‌کند. اگر می‌خواهید یک نگاشت دستی با یک صفحه‌بند ویژه برای این کار ایجاد کنید، می‌توانید از موردی شبیه به این استفاده نمایید: .INDENT 0.0 .INDENT 3.5 map f1 combine : launch \%<--stdin-source=@\:screen_scrollback> \-\-stdin\-add\-formatting \-\-type=overlay mypager : send_key / .UNINDENT .UNINDENT .sp برای کنترل پیشرفته‌تر، مانند استفاده از انتخاب فعلی، از \fBremote_control_script\fP \%<#\:action-remote_control_script> استفاده کنید\&. .SS مدیریت پنجره (Window management) .INDENT 0.0 .TP .B پنجره جدید .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+enter new_window map cmd+enter new_window 🍎 .EE .UNINDENT .UNINDENT .sp می‌توانید یک پنجره جدید kitty \%<#\:term-window> باز کنید که برنامه دلخواهی را اجرا کند، برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+y launch mutt .EE .UNINDENT .UNINDENT .sp می‌توانید با استفاده از دستور زیر، یک پنجره جدید باز کنید که دایرکتوری کاری فعلی آن روی دایرکتوری کاری پنجره جاری تنظیم شده باشد: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+alt+enter launch \-\-cwd=current .EE .UNINDENT .UNINDENT .sp می‌توانید پنجره جدیدی باز کنید که مجاز به کنترل kitty از طریق امکان کنترل از راه دور kitty باشد با استفاده از \fBlaunch \-\-allow\-remote\-control\fP \%<#\:cmdoption-launch-allow-remote-control>\&. هر برنامه‌ای که در آن پنجره اجرا شود، اجازه کنترل kitty را خواهد داشت. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+enter launch \-\-allow\-remote\-control some_program .EE .UNINDENT .UNINDENT .sp می‌توانید یک پنجره جدید در کنار پنجره فعال فعلی یا به‌عنوان پنجره اول باز کنید، با: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+n launch \-\-location=neighbor map ctrl+f launch \-\-location=first .EE .UNINDENT .UNINDENT .sp برای جزئیات بیشتر، دستور launch \%<> را ببینید\&. .INDENT 0.0 .TP .B پنجره جدید سیستم‌عامل .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+n new_os_window map \-\-allow\-fallback=shifted,ascii cmd+n new_os_window 🍎 .EE .UNINDENT .UNINDENT .sp مانند \fBnew_window\fP \%<#\:action-new_window> در بالا عمل می‌کند، با این تفاوت که یک پنجره سطح بالای سیستم‌عامل \%<#\:term-os_window> باز می‌کند\&. به‌ویژه می‌توانید از \fBnew_os_window_with_cwd\fP \%<#\:action-new_os_window_with_cwd> برای باز کردن پنجره با دایرکتوری کاری فعلی استفاده کنید. .INDENT 0.0 .TP .B بستن پنجره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+w close_window map \-\-allow\-fallback=shifted,ascii shift+cmd+d close_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره بعدی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+] next_window .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره قبلی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+[ previous_window .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B انتقال پنجره به جلو .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+f move_window_forward .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B انتقال پنجره به عقب .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+b move_window_backward .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B انتقال پنجره به بالا .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+\(ga move_window_to_top .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B شروع تغییر اندازه پنجره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+r start_resizing_window map \-\-allow\-fallback=shifted,ascii cmd+r start_resizing_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره اول .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+1 first_window map cmd+1 first_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره دوم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+2 second_window map cmd+2 second_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره سوم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+3 third_window map cmd+3 third_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره چهارم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+4 fourth_window map cmd+4 fourth_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره پنجم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+5 fifth_window map cmd+5 fifth_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره ششم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+6 sixth_window map cmd+6 sixth_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره هفتم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+7 seventh_window map cmd+7 seventh_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره هشتم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+8 eighth_window map cmd+8 eighth_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره نهم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+9 ninth_window map cmd+9 ninth_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنجره دهم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+0 tenth_window .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B انتخاب دیداری و تمرکز روی پنجره .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f7 focus_visible_window .EE .UNINDENT .UNINDENT .sp نمایش اعداد و حروف هم‌پوشان روی پنجره، و تغییر تمرکز به پنجره با فشردن کلید مربوطه. هنگامی که فقط دو پنجره وجود دارد، تمرکز مستقیماً بدون نمایش لایه هم‌پوشان تغییر می‌یابد. می‌توانید نویسه‌های هم‌پوشان و ترتیب آن‌ها را با گزینه \fBvisual_window_select_characters\fP تغییر دهید. .INDENT 0.0 .TP .B جابه‌جایی دیداری پنجره با پنجره‌ای دیگر .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f8 swap_with_window .EE .UNINDENT .UNINDENT .sp مانند \fBfocus_visible_window\fP \%<#\:action-focus_visible_window> در بالا کار می‌کند، اما پنجره را جابه‌جا می‌کند. .SS مدیریت برگه‌ها (Tab management) .INDENT 0.0 .TP .B برگه بعدی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+right next_tab map shift+cmd+] next_tab 🍎 map ctrl+tab next_tab .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B برگه قبلی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+left previous_tab map shift+cmd+[ previous_tab 🍎 map ctrl+shift+tab previous_tab .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B برگه تازه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+t new_tab map \-\-allow\-fallback=shifted,ascii cmd+t new_tab 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B بستن برگه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+q close_tab map \-\-allow\-fallback=shifted,ascii cmd+w close_tab 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B بستن پنجره سیستم‌عامل .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii shift+cmd+w close_os_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B انتقال برگه به جلو .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+. move_tab_forward .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B انتقال برگه به عقب .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+, move_tab_backward .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تنظیم عنوان برگه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+alt+t set_tab_title map \-\-allow\-fallback=shifted,ascii shift+cmd+i set_tab_title 🍎 .EE .UNINDENT .UNINDENT .sp همچنین می‌توانید میان‌برهایی برای رفتن به برگه‌های مشخص \%<#\:term-tab> بسازید، که در آن \fB1\fP برگه نخست، \fB2\fP برگه دوم، \fB\-1\fP برگه فعال پیشین، \fB\-2\fP برگه فعال قبل از برگه فعال پیشین و به همین ترتیب است. هر عدد بزرگ‌تر از شمار برگه‌ها به آخرین برگه می‌رود و هر عدد کمتر از شمار برگه‌های استفاده‌شده پیشین در تاریخچه، به قدیمی‌ترین برگه استفاده‌شده در تاریخچه می‌رود: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+alt+1 goto_tab 1 map ctrl+alt+2 goto_tab 2 .EE .UNINDENT .UNINDENT .sp درست مانند \fBnew_window\fP \%<#\:action-new_window> در بالا، می‌توانید نام دستورهای دلخواه را نیز برای اجرا هنگام استفاده از \fBnew_tab\fP \%<#\:action-new_tab> و \fBnew_tab_with_cwd\fP \%<#\:action-new_tab_with_cwd> ارسال کنید. در نهایت، اگر می‌خواهید برگه تازه به جای انتهای فهرست برگه‌ها، در کنار برگه کنونی باز شود، استفاده کنید از: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+t new_tab !neighbor [optional cmd to run] .EE .UNINDENT .UNINDENT .SS مدیریت چیدمان (Layout management) .INDENT 0.0 .TP .B چیدمان بعدی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+l next_layout .EE .UNINDENT .UNINDENT .sp همچنین می‌توانید میان‌برهایی برای رفتن به چیدمان‌های مشخص \%<#\:term-layout> بسازید: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+alt+t goto_layout tall map ctrl+alt+s goto_layout stack .EE .UNINDENT .UNINDENT .sp به همین ترتیب، برای بازگشت به چیدمان پیشین: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+alt+p last_used_layout .EE .UNINDENT .UNINDENT .sp کنش \fBtoggle_layout\fP \%<#\:action-toggle_layout> نیز وجود دارد که به چیدمان تعیین‌شده سوئیچ می‌کند یا اگر در چیدمان تعیین‌شده باشد، به چیدمان پیشین بازمی‌گردد. برای بزرگ‌نمایی موقت پنجره فعال با تغییر چیدمان به stack کاربرد دارد: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+alt+z toggle_layout stack .EE .UNINDENT .UNINDENT .SS اندازه قلم‌ها (Font sizes) .sp می‌توانید اندازه قلم را برای تمام پنجره‌های سطح‌بالای سیستم‌عامل kitty به طور هم‌زمان یا تنها برای پنجره کنونی تغییر دهید. .INDENT 0.0 .TP .B افزایش اندازه قلم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+equal change_font_size all +2.0 map ctrl+shift+plus change_font_size all +2.0 map ctrl+shift+kp_add change_font_size all +2.0 map cmd+plus change_font_size all +2.0 🍎 map cmd+equal change_font_size all +2.0 🍎 map shift+cmd+equal change_font_size all +2.0 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B کاهش اندازه قلم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+minus change_font_size all \-2.0 map ctrl+shift+kp_subtract change_font_size all \-2.0 map cmd+minus change_font_size all \-2.0 🍎 map shift+cmd+minus change_font_size all \-2.0 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B بازنشانی اندازه قلم .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+backspace change_font_size all 0 map cmd+0 change_font_size all 0 🍎 .EE .UNINDENT .UNINDENT .sp برای تنظیم میان‌برها جهت اندازه‌های مشخص قلم: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+f6 change_font_size all 10.0 .EE .UNINDENT .UNINDENT .sp برای تنظیم میان‌برها جهت تغییر اندازه قلم تنها در پنجره کنونی سیستم‌عامل: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+f6 change_font_size current 10.0 .EE .UNINDENT .UNINDENT .sp برای تنظیم میان‌برها جهت ضرب/تقسیم اندازه قلم: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+f6 change_font_size all *2.0 map kitty_mod+f6 change_font_size all /2.0 .EE .UNINDENT .UNINDENT .SS انتخاب و اقدام روی متن نمایان (Select and act on visible text) .sp از hints kitten برای انتخاب متن و ارسال آن به برنامه‌ای خارجی، درج آن در ترمینال یا رونوشت در تخته‌گیره استفاده کنید. .INDENT 0.0 .TP .B باز کردن URL .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+e open_url_with_hints .EE .UNINDENT .UNINDENT .sp باز کردن یک URL نمایان با استفاده از صفحه‌کلید. برنامه مورد استفاده برای باز کردن URL در \fBopen_url_with\fP مشخص می‌شود. .INDENT 0.0 .TP .B درج مسیر انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>f kitten hints \-\-type path \-\-program \- .EE .UNINDENT .UNINDENT .sp انتخاب یک مسیر/نام پرونده و درج آن در ترمینال. برای نمونه، جهت اجرای دستورهای \fBgit\fP روی نام پرونده حاصل از خروجی دستور پیشین \fBgit\fP کاربرد دارد. .INDENT 0.0 .TP .B باز کردن مسیر انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>shift+f kitten hints \-\-type path .EE .UNINDENT .UNINDENT .sp انتخاب یک مسیر/نام پرونده و باز کردن آن با برنامه پیش‌فرض سیستم. .INDENT 0.0 .TP .B درج پرونده برگزیده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>c kitten choose\-files .EE .UNINDENT .UNINDENT .sp انتخاب یک پرونده با استفاده از ابزارک choose\-files \%<> و درج آن در ترمینال. .INDENT 0.0 .TP .B درج شاخه برگزیده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>d kitten choose\-files \-\-mode=dir .EE .UNINDENT .UNINDENT .sp انتخاب یک شاخه با استفاده از ابزارک choose\-files \%<> و درج آن در ترمینال. .INDENT 0.0 .TP .B درج خط انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>l kitten hints \-\-type line \-\-program \- .EE .UNINDENT .UNINDENT .sp انتخاب یک خط از متن و درج آن در ترمینال. برای خروجی مواردی مانند: \fBls \-1\fP کاربرد دارد. .INDENT 0.0 .TP .B درج واژه انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>w kitten hints \-\-type word \-\-program \- .EE .UNINDENT .UNINDENT .sp انتخاب واژه‌ها و درج آن‌ها در ترمینال. .INDENT 0.0 .TP .B درج هش انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>h kitten hints \-\-type hash \-\-program \- .EE .UNINDENT .UNINDENT .sp انتخاب رشته‌ای شبیه به هش و درج آن در ترمینال. در \fBgit\fP که از هش‌های SHA1 برای شناسایی کامیت‌ها بهره می‌برد کاربرد دارد. .INDENT 0.0 .TP .B باز کردن پرونده انتخاب‌شده در خط انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>n kitten hints \-\-type linenum .EE .UNINDENT .UNINDENT .sp انتخاب رشته‌ای شبیه به \fBfilename:linenum\fP و باز کردن آن در ویرایشگر پیش‌فرض شما در شماره خط تعیین‌شده. .INDENT 0.0 .TP .B باز کردن ابرپیوند انتخاب‌شده .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+p>y kitten hints \-\-type hyperlink .EE .UNINDENT .UNINDENT .sp انتخاب یک ابرپیوند \%<#\:term-hyperlinks> (یعنی یک URL که توسط برنامه ترمینال علامت‌گذاری شده است، مانند خروجی \fBls \-\-hyperlink=auto\fP). .sp ابزارک hints kitten حالت‌های عملکردی بسیار بیشتری دارد که می‌توانید آن‌ها را به میان‌برهای مختلف نگاشت کنید. برای توضیحات کامل به hints kitten \%<> مراجعه کنید. .SS موارد گوناگون (Miscellaneous) .INDENT 0.0 .TP .B نمایش مستندات .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f1 show_kitty_doc overview .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پالت فرمان .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f3 command_palette .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تغییر وضعیت تمام‌صفحه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f11 toggle_fullscreen map \-\-allow\-fallback=shifted,ascii ctrl+cmd+f toggle_fullscreen 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تغییر وضعیت بیشینه‌سازی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f10 toggle_maximized .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تغییر وضعیت ورود امن صفحه‌کلید در macOS .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii opt+cmd+s toggle_macos_secure_keyboard_entry 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش میان پنجره‌های سیستم‌عامل در macOS .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+\(ga macos_cycle_through_os_windows 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پیمایش معکوس میان پنجره‌های سیستم‌عامل در macOS .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+shift+\(ga macos_cycle_through_os_windows_backwards 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B ورودی یونیکد .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+u kitten unicode_input map ctrl+cmd+space kitten unicode_input 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B ویرایش پرونده پیکربندی .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f2 edit_config_file map cmd+, edit_config_file 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B باز کردن شل فرمان kitty .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+escape kitty_shell window .EE .UNINDENT .UNINDENT .sp باز کردن شل kitty در یک \fBwindow\fP / \fBtab\fP / \fBoverlay\fP / \fBos_window\fP جدید برای کنترل kitty با استفاده از دستورها. .INDENT 0.0 .TP .B افزایش کدر بودن پس‌زمینه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+a>m set_background_opacity +0.1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B کاهش کدر بودن پس‌زمینه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+a>l set_background_opacity \-0.1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B کاملاً کدر کردن پس‌زمینه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+a>1 set_background_opacity 1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B بازنشانی کدر بودن پس‌زمینه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+shift+a>d set_background_opacity default .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B بازنشانی ترمینال .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+delete clear_terminal reset active map opt+cmd+r clear_terminal reset active 🍎 .EE .UNINDENT .UNINDENT .sp می‌توانید میان‌برهایی برای پاک‌سازی/بازنشانی ترمینال ایجاد کنید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # بازنشانی ترمینال map f1 clear_terminal reset active # پاک‌سازی صفحه ترمینال با حذف همه محتوا map f1 clear_terminal clear active # پاک‌سازی پیمایش به عقب (scrollback) ترمینال با حذف آن map f1 clear_terminal scrollback active # پیمایش محتوای صفحه به داخل بافر scrollback map f1 clear_terminal scroll active # پاک‌سازی همه محتویات صفحه تا خط حاوی مکان‌نما یا ابتدای خط فرمان فعلی (نیازمند ادغام با شل) map f1 clear_terminal to_cursor active # مشابه بالا با این تفاوت که خطوط پاک‌شده به scrollback منتقل می‌شوند map f1 clear_terminal to_cursor_scroll active # حذف آخرین دستور و خروجی آن (برای کارکرد نیازمند ادغام با شل است) map f1 clear_terminal last_command active .EE .UNINDENT .UNINDENT .sp اگر می‌خواهید به جای فقط پنجره فعلی روی همه پنجره‌های kitty عمل کنید، به جای active از all استفاده کنید.\& .sp برخی توابع مفید که می‌توان در پرونده‌های rc شل تعریف کرد تا انواع مختلف پاک‌سازی پنجره فعلی را انجام دهند: .INDENT 0.0 .INDENT 3.5 .sp .EX clear\-only\-screen() { printf \(dq\ee[H\ee[2J\(dq } clear\-screen\-and\-scrollback() { printf \(dq\ee[H\ee[3J\(dq } clear\-screen\-saving\-contents\-in\-scrollback() { printf \(dq\ee[H\ee[22J\(dq } .EE .UNINDENT .UNINDENT .sp برای نمونه، با استفاده از این کدهای گریز، می‌توان به جای پاک کردن ساده صفحه، \fBCtrl\fP+\fBL\fP را طوری بازنگاشت کرد که هم محتوای صفحه فعلی را به بافر scrollback منتقل کند و هم صفحه را پاک نماید. برای ZSH، در \fB~/.zshrc\fP بیفزایید: .INDENT 0.0 .INDENT 3.5 .sp .EX ctrl_l() { builtin print \-rn \-\- $\(aq\er\ee[0J\ee[H\ee[22J\(aq >\(dq$TTY\(dq builtin zle .reset\-prompt builtin zle \-R } zle \-N ctrl_l bindkey \(aq^l\(aq ctrl_l .EE .UNINDENT .UNINDENT .sp روش دیگر این است که عبارت \fBmap ctrl+l clear_terminal to_cursor_scroll active\fP را به \fBkitty.conf\fP بیفزایید که بدون نیاز به تغییر در پرونده‌های rc شل کار می‌کند، اما تنها محتوا را تا خط فرمان پاک می‌کند و متنی را در خود خط فرمان پاک نمی‌کند. .INDENT 0.0 .TP .B پاک‌سازی تا ابتدا .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+k clear_terminal to_cursor active 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پاک‌سازی scrollback .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map option+cmd+k clear_terminal scrollback active 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پاک‌سازی آخرین دستور .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+l clear_terminal last_command active 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پاک‌سازی صفحه .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+ctrl+l clear_terminal to_cursor_scroll active 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B بارگذاری مجدد kitty.conf .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f5 load_config_file map ctrl+cmd+, load_config_file 🍎 .EE .UNINDENT .UNINDENT .sp بارگذاری مجدد \fBkitty.conf\fP، با اعمال هرگونه تغییرات از زمان آخرین باری که بارگذاری شده بود. توجه داشته باشید که تعداد اندکی از گزینه‌ها را نمی‌توان به صورت پویا تغییر داد و نیازمند راه‌اندازی مجدد کامل kitty هستند. به‌ویژه، هنگام تغییر میان‌برهای مربوط به عملیات موجود در نوار منوی سراسری macOS، راه‌اندازی مجدد کامل الزامی است. همچنین می‌توانید یک کلید میان‌بر را برای بارگذاری پرونده پیکربندی دیگری نگاشت کنید، برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f5 load_config /path/to/alternative/kitty.conf .EE .UNINDENT .UNINDENT .sp توجه داشته باشید که تمام گزینه‌های پرونده اصلی \fBkitty.conf\fP نادیده گرفته می‌شوند؛ به عبارت دیگر، پیکربندی جدید \fIجایگزین\fP پیکربندی قبلی می‌شود. .INDENT 0.0 .TP .B اشکال‌زدایی پیکربندی kitty .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+shift+f6 debug_config map opt+cmd+, debug_config 🍎 .EE .UNINDENT .UNINDENT .sp نمایش جزئیات دقیق درباره این که kitty با چه پیکربندی و در چه محیط میزبانی در حال اجراست. مناسب برای اشکال‌زدایی مشکلات. .INDENT 0.0 .TP .B ارسال متن دلخواه با فشردن کلیدها .UNINDENT .sp می‌توانید به kitty اعلام کنید که هنگام فشردن کلیدهای میان‌بر مشخص‌شده، متن دلخواه با کدگذاری (UTF\-8) را به برنامه کلاینت ارسال کند. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+alt+a send_text all Special text .EE .UNINDENT .UNINDENT .sp این تنظیم با فشردن ترکیب کلیدهای \fBCtrl\fP+\fBAlt\fP+\fBA\fP متن \(dqSpecial text\(dq را ارسال می‌کند. متن ارسالی توالی‌های گریز ANSI C را رمزگشایی می‌کند \% بنابراین می‌توانید از توالی‌هایی مانند \fB\ee\fP برای ارسال کدهای کنترلی یا \fB\eu21fb\fP برای ارسال نویسه‌های یونیکد استفاده کنید (یا می‌توانید مستقیماً نویسه‌های یونیکد را به صورت متن UTF\-8 وارد نمایید). می‌توانید از \fBkitten show\-key\fP برای دریافت کدهای گریز کلیدهایی که قصد شبیه‌سازی آن‌ها را دارید استفاده کنید. .sp آرگومان نخست برای \fBsend_text\fP حالت‌های صفحه‌کلید است که میان‌بر در آن‌ها فعال می‌شود. مقادیر ممکن عبارتند از \fBnormal\fP، \fBapplication\fP، \fBkitty\fP یا ترکیبی از آن‌ها که با کاما جدا شده باشند. حالت‌های \fBnormal\fP و \fBapplication\fP به حالت کلید مکان‌نمای DECCKM برای ترمینال‌ها اشاره دارند، و \fBkitty\fP به پروتکل صفحه‌کلید گسترش‌یافته kitty اشاره دارد. مقدار ویژه \fBall\fP به معنای همه آن‌ها است. .sp چند نمونه دیگر: .INDENT 0.0 .INDENT 3.5 .sp .EX # چاپ یک کلمه و انتقال مکان‌نما به ابتدای خط (مشابه تایپ کردن و فشردن Home) map ctrl+alt+a send_text normal Word\ee[H map ctrl+alt+a send_text application Word\eeOH # اجرای یک دستور در اعلان شل (مشابه تایپ دستور و فشردن Enter) map ctrl+alt+a send_text normal,application some command with arguments\er .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B باز کردن وبگاه kitty .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map shift+cmd+/ open_url https://sw.kovidgoyal.net/kitty 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنهان کردن برنامه kitty در macOS .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+h hide_macos_app 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پنهان کردن سایر برنامه‌ها در macOS .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map opt+cmd+h hide_macos_other_apps 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B کمینه‌سازی پنجره در macOS .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+m minimize_macos_window 🍎 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B خروج از kitty .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map cmd+q quit 🍎 .EE .UNINDENT .UNINDENT .SH "نمونه kitty.conf (SAMPLE KITTY.CONF)" .sp با فشردن میان‌بُر \fBctrl+shift+f2\fP در kitty می‌توانید یک پرونده نمونه کامنت‌گذاری‌شده از kitty.conf را ویرایش کنید. این کار یک پرونده پیکربندی با مستندات کامل و تمام تنظیمات کامنت‌شده تولید می‌کند. اگر پرونده \fBkitty.conf\fP از پیش موجود باشد، به جای آن استفاده می‌شود؛ برای دیدن پرونده نمونه آن را حذف کنید. .sp یک پرونده پیکربندی پیش‌فرض را می‌توان با اجرای دستور زیر نیز تولید کرد: .INDENT 0.0 .INDENT 3.5 .sp .EX kitty +runpy \(aqfrom kitty.config import *; print(commented_out_default_config())\(aq .EE .UNINDENT .UNINDENT .sp این دستور پرونده پیکربندی پیش‌فرض کامنت‌شده را در \fBSTDOUT\fP چاپ می‌کند. .SH "تمام کنش‌های قابل‌نگاشت (ALL MAPPABLE ACTIONS)" .sp فهرست تمامی کارهایی که می‌توانید با |kitty| انجام دهید را ببینید \%<>\&. .SS "کنش‌های قابل‌نگاشت (Mappable actions)" .sp کنش‌های شرح‌داده‌شده در زیر را می‌توان با استفاده از دستورالعمل‌های \fBmap\fP و \fBmouse_map\fP در \fBkitty.conf\fP به هر کلید یا کنش موشواره نگاشت کرد. برای نمونه‌های پیکربندی، پیوندهای میان‌بُر پیش‌فرض هر کنش را ببینید. برای مطالعه جزئیات بیشتر درباره نگاشت صفحه‌کلید، به Making your keyboard dance \%<> مراجعه کنید. .sp همچنین می‌توانید با فشردن \fBctrl+shift+f3\fP \%<#\:shortcut-kitty\:.Command-palette> جهت اجرای جعبه فرمان \%<> (Command palette)، این کنش‌ها را مرور و اجرا کنید. .SS "رونوشت/چسباندن (Copy/paste)" .INDENT 0.0 .TP .B clear_selection .UNINDENT .sp پاک کردن انتخاب فعلی .INDENT 0.0 .TP .B copy_and_clear_or_interrupt .UNINDENT .sp کپی متن انتخاب‌شده از پنجره فعال به بریده‌دان و پاک کردن انتخاب؛ در صورت نبود انتخاب، ارسال SIGINT (معادل \fBctrl\fP+\fBc\fP) .INDENT 0.0 .TP .B copy_ansi_to_clipboard .UNINDENT .sp کپی متن انتخاب‌شده از پنجره فعال به بریده‌دان همراه با کدهای قالب‌بندی ANSI .INDENT 0.0 .TP .B copy_last_command_output .UNINDENT .sp کپی آخرین خروجی غیرخالی دستور شل به بریده‌دان .sp برای کارکرد نیازمند یکپارچه‌سازی شل \%<#\:shell-integration> است .INDENT 0.0 .TP .B copy_or_interrupt .UNINDENT .sp کپی متن انتخاب‌شده از پنجره فعال به بریده‌دان؛ در صورت نبود انتخاب، ارسال SIGINT (معادل \fBctrl\fP+\fBc\fP) .INDENT 0.0 .TP .B copy_or_noop .UNINDENT .sp کپی متن انتخاب‌شده از پنجره فعال به بریده‌دان؛ در صورت نبود انتخاب، ارسال کلید به برنامه در حال اجرا در ترمینال. .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBcmd+c\fP \%<#\:shortcut-kitty\:.Copy-to-clipboard-or-pass-through> .INDENT 0.0 .TP .B copy_selection_or_last_command_output .UNINDENT .sp کپی متن انتخاب‌شده از پنجره فعال به بریده‌دان؛ در صورت نبود انتخاب، کپی خروجی آخرین دستور (برای کارکرد نیازمند یکپارچه‌سازی شل است) .INDENT 0.0 .TP .B copy_to_clipboard .UNINDENT .sp کپی متن انتخاب‌شده از پنجره فعال به بریده‌دان .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+c\fP \%<#\:shortcut-kitty\:.Copy-to-clipboard> .INDENT 0.0 .TP .B pass_selection_to_program .UNINDENT .sp ارسال متن انتخاب‌شده از پنجره فعال به برنامه مشخص‌شده .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+o\fP \%<#\:shortcut-kitty\:.Pass-selection-to-program> .INDENT 0.0 .TP .B paste .UNINDENT .sp چسباندن متن مشخص‌شده به پنجره فعلی. کدهای گریز ANSI C رمزگشایی می‌شوند. .INDENT 0.0 .TP .B copy_to_buffer .UNINDENT .sp کپی انتخاب از پنجره فعال به بافر مشخص‌شده .sp برای جزئیات Multiple copy/paste buffers \%<#\:cpbuf> را ببینید. .INDENT 0.0 .TP .B paste_from_buffer .UNINDENT .sp چسباندن از بافر مشخص‌شده به پنجره فعال .sp برای جزئیات Multiple copy/paste buffers \%<#\:cpbuf> را ببینید. .INDENT 0.0 .TP .B paste_from_clipboard .UNINDENT .sp چسباندن از بریده‌دان به پنجره فعال .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+v\fP \%<#\:shortcut-kitty\:.Paste-from-clipboard> .INDENT 0.0 .TP .B paste_from_selection .UNINDENT .sp چسباندن از انتخاب اولیه (primary selection) در صورت وجود، وگرنه از بریده‌دان به پنجره فعال .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+s\fP \%<#\:shortcut-kitty\:.Paste-from-selection> .SS "اشکال‌زدایی (Debugging)" .INDENT 0.0 .TP .B dump_lines_with_attrs .UNINDENT .sp نمایش خروجی خطوط فعلی در بافر پیمایش به عقب + صفحه به همراه ویژگی‌های خط .INDENT 0.0 .TP .B close_shared_ssh_connections .UNINDENT .sp بستن تمام اتصالات اشتراکی SSH .sp برای جزئیات به \fBshare_connections\fP \%<#\:opt-kitten-ssh\:.share_connections> مراجعه کنید. .INDENT 0.0 .TP .B debug_config .UNINDENT .sp نمایش پیکربندی مؤثری که kitty با آن اجرا می‌شود .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+f6\fP \%<#\:shortcut-kitty\:.Debug-kitty-configuration> .INDENT 0.0 .TP .B show_kitty_env_vars .UNINDENT .sp نمایش متغیرهای محیطی که فرآیند kitty مشاهده می‌کند .INDENT 0.0 .TP .B simulate_color_scheme_preference_change .UNINDENT .sp شبیه‌سازی تغییر در ترجیحات طرح رنگ سیستم‌عامل .INDENT 0.0 .TP .B test_dragging .UNINDENT .sp آغاز یک عملیات کشیدن آزمایشی، جهت استفاده با mouse_map .SS "اندازه قلم‌ها (Font sizes)" .INDENT 0.0 .TP .B change_font_size .UNINDENT .sp تغییر اندازه قلم برای پنجره فعلی یا تمام پنجره‌های سیستم‌عامل .sp برای جزئیات به Font sizes \%<#\:conf-kitty-shortcuts-fonts> مراجعه کنید. .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+minus\fP \%<#\:shortcut-kitty\:.Decrease-font-size>, \fBctrl+shift+equal\fP \%<#\:shortcut-kitty\:.Increase-font-size>, \fBctrl+shift+backspace\fP \%<#\:shortcut-kitty\:.Reset-font-size> .SS "طرح‌بندی‌ها (Layouts)" .INDENT 0.0 .TP .B goto_layout .UNINDENT .sp تغییر به طرح‌بندی نام‌برده شده .sp در صورتی که چندین طرح‌بندی با یک نام و گزینه‌های متفاوت وجود دارند، تعریف کامل طرح‌بندی یا پیشوند یکتایی از تعریف کامل را مشخص کنید. .sp به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 goto_layout tall map f2 goto_layout fat:bias=20 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B last_used_layout .UNINDENT .sp رفتن به آخرین طرح‌بندی استفاده‌شده .INDENT 0.0 .TP .B layout_action .UNINDENT .sp اجرای یک کنش ویژه طرح‌بندی. برای جزئیات به Arrange windows \%<> مراجعه کنید .INDENT 0.0 .TP .B next_layout .UNINDENT .sp رفتن به طرح‌بندی فعال بعدی. اختیاری است که یک عدد صحیح برای پرش به تعداد مشخص‌شده ارسال شود. .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+l\fP \%<#\:shortcut-kitty\:.Next-layout> .INDENT 0.0 .TP .B toggle_layout .UNINDENT .sp تغییر وضعیت طرح‌بندی نام‌برده شده .sp اگر طرح‌بندی دیگری جاری باشد، به طرح‌بندی نام‌برده سوئیچ می‌کند، در غیر این صورت به آخرین طرح‌بندی استفاده‌شده برمی‌گردد. برای \(dqبزرگ‌نمایی\(dq موقت یک پنجره با جابجایی به طرح‌بندی stack کاربرد دارد. همچنین اگر مایلید محتوا از بافر پیمایش به عقب به پنجره بزرگ‌شده سرریز کند، به \fBscrollback_fill_enlarged_window\fP \%<#\:opt-kitty\:.scrollback_fill_enlarged_window> مراجعه کنید. به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 toggle_layout stack .EE .UNINDENT .UNINDENT .SS "نشانه‌ها (Marks)" .INDENT 0.0 .TP .B remove_marker .UNINDENT .sp حذف نشانگر ایجاد‌شده پیشین .INDENT 0.0 .TP .B scroll_to_mark .UNINDENT .sp پیمایش به نشانه بعدی یا قبلی از نوع مشخص‌شده .INDENT 0.0 .TP .B toggle_marker .UNINDENT .sp تغییر وضعیت نشانگر فعلی روشن/خاموش .INDENT 0.0 .TP .B create_marker .UNINDENT .sp ایجاد یک نشانگر جدید .SS "متفرقه (Miscellaneous)" .INDENT 0.0 .TP .B send_key .UNINDENT .sp ارسال کلیدهای مشخص‌شده به پنجره فعال. .sp توجه داشته باشید که کلید تنها در صورتی ارسال خواهد شد که حالت صفحه‌کلید برنامه در حال اجرا در ترمینال از آن پشتیبانی کند. هم فشردن کلید و هم رها کردن آن ارسال می‌شود. ابتدا فشرده شدن تمام کلیدهای مشخص‌شده و سپس رها شدن آن‌ها به ترتیب معکوس ارسال می‌گردد. برای ارسال الگویی از فشردن و رها کردن برای چندین کلید، از کنش \fBcombine\fP استفاده کنید. به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 send_key ctrl+x alt+y map f1 combine : send_key ctrl+x : send_key alt+y .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B send_text .UNINDENT .sp ارسال متن مشخص‌شده به پنجره فعال .sp برای جزئیات به \fBsend_text\fP \%<#\:shortcut-kitty\:.Send-arbitrary-text-on-key-presses> مراجعه کنید. .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+alt+h\fP \%<#\:shortcut-kitty\:.Send-arbitrary-text-on-key-presses> .INDENT 0.0 .TP .B show_kitty_doc .UNINDENT .sp نمایش مستندات مشخص‌شده kitty، با اولویت نسخه محلی در صورت یافت شدن. .sp به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # نمایش مستندات پیکربندی map f1 show_kitty_doc conf # نمایش مستندات ssh kitten map f1 show_kitty_doc kittens/ssh .EE .UNINDENT .UNINDENT .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+f1\fP \%<#\:shortcut-kitty\:.Show-documentation> .INDENT 0.0 .TP .B signal_child .UNINDENT .sp ارسال SIGNAL مشخص‌شده به فرآیند پیش‌زمینه در پنجره فعال .sp به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 signal_child SIGTERM .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B clear_terminal .UNINDENT .sp پاک کردن ترمینال .sp برای جزئیات به \fBreset_terminal\fP \%<#\:shortcut-kitty\:.Reset-the-terminal> مراجعه کنید. به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # بازنشانی ترمینال map f1 clear_terminal reset active # پاک کردن صفحه ترمینال با حذف تمامی محتویات map f1 clear_terminal clear active # پاک کردن بافر پیمایش ترمینال با حذف آن map f1 clear_terminal scrollback active # پیمایش محتویات صفحه به درون بافر پیمایش map f1 clear_terminal scroll active # پاک کردن همه‌چیز در صفحه تا خط حاوی مکان‌نما یا ابتدای اعلان فعلی (نیازمند یکپارچه‌سازی شل) # برای پاک کردن صفحه تا اعلان شل و انتقال اعلان شل به بالای صفحه کاربرد دارد. map f1 clear_terminal to_cursor active # همانند بالا به جز اینکه خطوط پاک‌شده به بافر پیمایش منتقل می‌شوند map f1 clear_terminal to_cursor_scroll active # حذف آخرین دستور و خروجی آن (برای کارکرد نیازمند یکپارچه‌سازی شل است) map f1 clear_terminal last_command active .EE .UNINDENT .UNINDENT .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBcmd+l\fP \%<#\:shortcut-kitty\:.Clear-the-last-command>, \fBcmd+ctrl+l\fP \%<#\:shortcut-kitty\:.Clear-screen>, \fBoption+cmd+k\fP \%<#\:shortcut-kitty\:.Clear-scrollback>, \fBcmd+k\fP \%<#\:shortcut-kitty\:.Clear-to-start>, \fBctrl+shift+delete\fP \%<#\:shortcut-kitty\:.Reset-the-terminal> .INDENT 0.0 .TP .B combine .UNINDENT .sp ترکیب چند کنش و نگاشت به یک‌بار فشردن کلید .sp ساختار دستور به صورت زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX map key combine action1 action2 action3 ... .EE .UNINDENT .UNINDENT .sp به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+e combine : new_window : next_layout map kitty_mod+e combine | new_tab | goto_tab \-1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B command_palette .UNINDENT .sp مرور و راه‌اندازی میان‌بُرهای صفحه‌کلید و کنش‌ها در یک پوشش قابل‌جستجو (Command palette \%<>) .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+f3\fP \%<#\:shortcut-kitty\:.Command-palette> .INDENT 0.0 .TP .B disable_ligatures_in .UNINDENT .sp فعال/غیرفعال کردن حروف متصل (ligatures) در پنجره مشخص‌شده .sp برای جزئیات به \fBdisable_ligatures\fP \%<#\:opt-kitty\:.disable_ligatures> مراجعه کنید .INDENT 0.0 .TP .B discard_event .UNINDENT .sp نادیده گرفتن کامل این رویداد .INDENT 0.0 .TP .B edit_config_file .UNINDENT .sp ویرایش پرونده پیکربندی kitty.conf در ویرایشگر متن دلخواه شما .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+f2\fP \%<#\:shortcut-kitty\:.Edit-config-file> .INDENT 0.0 .TP .B grab_keyboard .UNINDENT .sp تصاحب صفحه‌کلید. به این معنی است که میان‌بُرهای سراسری تعریف‌شده در سیستم‌عامل به جای آن به kitty ارسال می‌شوند. کاربردی است اگر .sp بخواهید یک پنجره مُدال سیستم‌عامل ایجاد کنید. کیفیت کارکرد این قابلیت به سیستم‌عامل/مدیر پنجره/محیط رومیزی بستگی دارد. در Wayland تنها در صورتی کار می‌کند که کامپوزیتور پروتکل inhibit\-keyboard\-shortcuts \% را پیاده‌سازی کرده باشد. در macOS اپل بدون مجوزهای ویژه اجازه تصاحب صفحه‌کلید را به برنامه‌ها نمی‌دهد، بنابراین کار نمی‌کند. .INDENT 0.0 .TP .B hide_macos_app .UNINDENT .sp پنهان کردن برنامه kitty در macOS .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBcmd+h\fP \%<#\:shortcut-kitty\:.Hide-macOS-kitty-application> .INDENT 0.0 .TP .B hide_macos_other_apps .UNINDENT .sp پنهان کردن سایر برنامه‌ها در macOS .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBopt+cmd+h\fP \%<#\:shortcut-kitty\:.Hide-macOS-other-applications> .INDENT 0.0 .TP .B input_unicode_character .UNINDENT .sp ورود نویسه یونیکد دلخواه. برای جزئیات به Unicode input \%<> مراجعه کنید. .INDENT 0.0 .TP .B kitten .UNINDENT .sp اجرای kitten مشخص‌شده. برای جزئیات به Custom kittens \%<> مراجعه کنید .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: .INDENT 0.0 .IP \(bu 2 Selecting files, fast \%<> \- \fBctrl+shift+p>d\fP \%<#\:shortcut-kitty\:.Insert-chosen-directory> درج دایرکتوری انتخاب‌شده .IP \(bu 2 Selecting files, fast \%<> \- \fBctrl+shift+p>c\fP \%<#\:shortcut-kitty\:.Insert-chosen-file> درج پرونده انتخاب‌شده .IP \(bu 2 Hints \%<> \- \fBctrl+shift+p>h\fP \%<#\:shortcut-kitty\:.Insert-selected-hash> درج هش انتخاب‌شده .IP \(bu 2 Hints \%<> \- \fBctrl+shift+p>l\fP \%<#\:shortcut-kitty\:.Insert-selected-line> درج خط انتخاب‌شده .IP \(bu 2 Hints \%<> \- \fBctrl+shift+p>f\fP \%<#\:shortcut-kitty\:.Insert-selected-path> درج مسیر انتخاب‌شده .IP \(bu 2 Hints \%<> \- \fBctrl+shift+p>w\fP \%<#\:shortcut-kitty\:.Insert-selected-word> درج کلمه انتخاب‌شده .IP \(bu 2 Hints \%<> \- \fBctrl+shift+p>shift+f\fP \%<#\:shortcut-kitty\:.Open-selected-path> باز کردن مسیر انتخاب‌شده .IP \(bu 2 Hints \%<> \- \fBctrl+shift+p>n\fP \%<#\:shortcut-kitty\:.Open-the-selected-file-at-the-selected-line> باز کردن پرونده انتخاب‌شده در خط مشخص‌شده .IP \(bu 2 Hints \%<> \- \fBctrl+shift+p>y\fP \%<#\:shortcut-kitty\:.Open-the-selected-hyperlink> باز کردن فرارابط انتخاب‌شده .IP \(bu 2 Unicode input \%<> \- \fBctrl+shift+u\fP \%<#\:shortcut-kitty\:.Unicode-input> ورودی یونیکد .UNINDENT .INDENT 0.0 .TP .B kitty_shell .UNINDENT .sp اجرای شل kitty برای کنترل kitty با دستورات .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+escape\fP \%<#\:shortcut-kitty\:.Open-the-kitty-command-shell> .INDENT 0.0 .TP .B launch .UNINDENT .sp راه‌اندازی برنامه مشخص‌شده در یک پنجره/زبانه/غیره جدید. .sp برای جزئیات The launch command \%<> را ببینید .INDENT 0.0 .TP .B load_config_file .UNINDENT .sp بارگذاری مجدد پرونده پیکربندی .sp اگر بدون آرگومان نگاشت شود، پرونده پیکربندی پیش‌فرض را مجدداً بارگذاری می‌کند، در غیر این صورت پرونده‌های پیکربندی مشخص‌شده را به ترتیب بارگذاری می‌نماید. بارگذاری یک پرونده پیکربندی \fIجایگزین\fP تمام گزینه‌های پیکربندی می‌شود. به عنوان نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f5 load_config_file /path/to/some/kitty.conf .EE .UNINDENT .UNINDENT .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBctrl+shift+f5\fP \%<#\:shortcut-kitty\:.Reload-kitty\:.conf> .INDENT 0.0 .TP .B macos_cycle_through_os_windows .UNINDENT .sp چرخش میان پنجره‌های سیستم‌عامل در macOS .sp میان‌بُرهای پیش‌فرضی که از این کنش استفاده می‌کنند: \fBcmd+\(ga\fP \%<#\:shortcut-kitty\:.macOS-Cycle-through-OS-Windows> .INDENT 0.0 .TP .B macos_cycle_through_os_windows_backwards .UNINDENT .sp چرخش به عقب میان پنجره‌های سیستم‌عامل در macOS .sp میان‌برهای پیش‌گزیده برای این کنش: \fBcmd+shift+\(ga\fP \%<#\:shortcut-kitty\:.macOS-Cycle-through-OS-Windows-backwards> .INDENT 0.0 .TP .B minimize_macos_window .UNINDENT .sp کمینه‌سازی پنجره macOS .sp میان‌برهای پیش‌گزیده برای این کنش: \fBcmd+m\fP \%<#\:shortcut-kitty\:.Minimize-macOS-window> .INDENT 0.0 .TP .B open_url .UNINDENT .sp باز کردن نشانی اینترنتی (URL) مشخص‌شده .sp میان‌برهای پیش‌گزیده برای این کنش: \fBshift+cmd+/\fP \%<#\:shortcut-kitty\:.Open-kitty-Website> .INDENT 0.0 .TP .B open_url_with_hints .UNINDENT .sp کلیک روی یک نشانی اینترنتی (URL) با استفاده از صفحه‌کلید .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+e\fP \%<#\:shortcut-kitty\:.Open-URL> .INDENT 0.0 .TP .B pop_keyboard_mode .UNINDENT .sp پایان حالت فعلی صفحه‌کلید و بازگشت به حالت قبلی. .INDENT 0.0 .TP .B push_keyboard_mode .UNINDENT .sp تغییر به حالت صفحه‌کلید مشخص‌شده و قرار دادن آن در پشتهٔ حالت‌های صفحه‌کلید. .INDENT 0.0 .TP .B remote_control .UNINDENT .sp اجرای دستور کنترل از راه دور بدون نیاز به فعال‌سازی اجازهٔ کنترل از راه دور .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 remote_control set\-spacing margin=30 .EE .UNINDENT .UNINDENT .sp برای جزئیات Mapping key presses to remote control commands \%<#\:rc-mapping> را ببینید. .INDENT 0.0 .TP .B remote_control_script .UNINDENT .sp اجرای اسکریپت کنترل از راه دور بدون نیاز به فعال‌سازی اجازهٔ کنترل از راه دور .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 remote_control_script /path/to/script arg1 arg2 ... .EE .UNINDENT .UNINDENT .sp برای جزئیات Mapping key presses to remote control commands \%<#\:rc-mapping> را ببینید. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty سنجیده می‌شوند. .INDENT 0.0 .TP .B set_colors .UNINDENT .sp تغییر رنگ‌ها در پنجره‌های مشخص‌شده .sp برای جزئیات، kitten @ set\-colors \%<#\:at-set-colors>\& را ببینید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f5 set_colors \-\-configured /path/to/some/config/file/colors.conf .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B show_error .UNINDENT .sp نمایش پیام خطا با عنوان و متن مشخص‌شده .INDENT 0.0 .TP .B sleep .UNINDENT .sp توقف به مدت زمان مشخص‌شده. پسوند می‌تواند s برای ثانیه، m برای دقیقه، h برای ساعت و d برای روز باشد. زمان می‌تواند کسری باشد. .INDENT 0.0 .TP .B toggle_macos_secure_keyboard_entry .UNINDENT .sp تغییر وضعیت ورودی امن صفحه‌کلید macOS .sp میان‌برهای پیش‌گزیده برای این کنش: \fBopt+cmd+s\fP \%<#\:shortcut-kitty\:.Toggle-macOS-secure-keyboard-entry> .INDENT 0.0 .TP .B ungrab_keyboard .UNINDENT .sp رها کردن صفحه‌کلید در صورت تسخیر قبلی آن .INDENT 0.0 .TP .B no_op .UNINDENT .sp لغو انتساب میان‌بر .sp نگاشت میان‌بر به no_op موجب می‌شود kitty دیگر کلید فشرده‌شده را رهگیری نکند و در عوض آن را به برنامه در حال اجرا در آن بفرستد. .SS کنش‌های موشواره (Mouse actions) .INDENT 0.0 .TP .B mouse_click_url .UNINDENT .sp کلیک روی نشانی اینترنتی (URL) زیر موشواره .INDENT 0.0 .TP .B mouse_click_url_or_select .UNINDENT .sp کلیک روی نشانی اینترنتی (URL) زیر موشواره تنها در صورتی که چیزی در صفحه انتخاب نشده باشد .INDENT 0.0 .TP .B mouse_handle_click .UNINDENT .sp مدیریت کلیک موشواره .sp تلاش برای انجام کنش‌های مشخص‌شده یکی پس از دیگری تا زمانی که یکی از آن‌ها موفق شود. کنش‌های پشتیبانی‌شده عبارتند از: .INDENT 0.0 .INDENT 3.5 .sp .EX selection \- بررسی وجود متن انتخابی و در صورت وجود، لغو پردازش link \- در صورت وجود پیوند زیر موشواره، کلیک روی آن prompt \- اگر کلیک موشواره روی خط فرمان پوسته رخ دهد، مکان‌نما به موقعیت موشواره منتقل شود .EE .UNINDENT .UNINDENT .sp برای نمونه‌ها، Mouse actions \%<#\:conf-kitty-mouse-mousemap> را ببینید .INDENT 0.0 .TP .B mouse_select_command_output .UNINDENT .sp انتخاب خروجی دستور کلیک‌شده .sp برای کارکرد نیازمند Shell integration \%<#\:shell-integration> است .INDENT 0.0 .TP .B mouse_selection .UNINDENT .sp تغییر بازهٔ انتخابی بر اساس موقعیت فعلی موشواره .sp برای نمونه‌ها، Mouse actions \%<#\:conf-kitty-mouse-mousemap> را ببینید .INDENT 0.0 .TP .B mouse_show_command_output .UNINDENT .sp نمایش خروجی دستور کلیک‌شده در یک صفحه‌بند مانند less .sp برای کارکرد نیازمند Shell integration \%<#\:shell-integration> است .INDENT 0.0 .TP .B paste_selection .UNINDENT .sp چسباندن متن انتخابی اصلی فعلی (Primary selection) .INDENT 0.0 .TP .B paste_selection_or_clipboard .UNINDENT .sp چسباندن متن انتخابی اصلی فعلی یا حافظه کلیپ‌بورد در صورت عدم وجود متن انتخابی .SS پیمایش (Scrolling) .INDENT 0.0 .TP .B scroll_end .UNINDENT .sp پیمایش به انتهای بافر تاریخچه در صفحه اصلی .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+end\fP \%<#\:shortcut-kitty\:.Scroll-to-bottom> .INDENT 0.0 .TP .B scroll_home .UNINDENT .sp پیمایش به ابتدای بافر تاریخچه در صفحه اصلی .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+home\fP \%<#\:shortcut-kitty\:.Scroll-to-top> .INDENT 0.0 .TP .B scroll_line_down .UNINDENT .sp پیمایش یک خط به پایین در صفحه اصلی. برای پیمایش به مقادیر دیگر، می‌توانید کنش remote_control .sp scroll\-window را نگاشت کنید. آرگومان \fBsmooth\fP را برای پیمایش پویانمایی‌شده ارسال کنید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+down scroll_line_down smooth .EE .UNINDENT .UNINDENT .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+down\fP \%<#\:shortcut-kitty\:.Scroll-line-down> .INDENT 0.0 .TP .B scroll_line_up .UNINDENT .sp پیمایش یک خط به بالا در صفحه اصلی. برای پیمایش به مقادیر دیگر، می‌توانید کنش remote_control .sp scroll\-window را نگاشت کنید. آرگومان \fBsmooth\fP را برای پیمایش پویانمایی‌شده ارسال کنید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map kitty_mod+up scroll_line_up smooth .EE .UNINDENT .UNINDENT .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+up\fP \%<#\:shortcut-kitty\:.Scroll-line-up> .INDENT 0.0 .TP .B scroll_page_down .UNINDENT .sp پیمایش یک صفحه به پایین در صفحه اصلی. برای پیمایش به مقادیر دیگر، می‌توانید کنش remote_control scroll\-window را نگاشت کنید. .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+page_down\fP \%<#\:shortcut-kitty\:.Scroll-page-down> .INDENT 0.0 .TP .B scroll_page_up .UNINDENT .sp پیمایش یک صفحه به بالا در صفحه اصلی. برای پیمایش به مقادیر دیگر، می‌توانید کنش remote_control scroll\-window را نگاشت کنید. .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+page_up\fP \%<#\:shortcut-kitty\:.Scroll-page-up> .INDENT 0.0 .TP .B scroll_prompt_to_bottom .UNINDENT .sp پیمایش خط فرمان به پایین صفحه و پر کردن خط‌های اضافی از بافر تاریخچه، هنگام حضور در صفحه اصلی .INDENT 0.0 .TP .B scroll_prompt_to_top .UNINDENT .sp پیمایش خط فرمان به بالای صفحه و پر کردن صفحه با خط‌های خالی، هنگام حضور در صفحه اصلی. برای جلوگیری از قرارگیری خط‌های بالای خط فرمان در تاریخچه از scroll_prompt_to_top y استفاده کنید .INDENT 0.0 .TP .B scroll_to_prompt .UNINDENT .sp پیمایش به خط فرمان قبلی/بعدی پوسته .sp امکان پرش آسان از یک دستور به دستور دیگر را فراهم می‌کند. نیازمند کارکرد Shell integration \%<#\:shell-integration>\& است. دو عدد اختیاری را به عنوان آرگومان می‌پذیرد: .sp نخستین مقدار، تعداد خط‌های فرمانی است که باید پرش شوند؛ مقادیر منفی به بالا و مقادیر مثبت به پایین می‌پرند. مقدار صفر به آخرین خط فرمان بازدیدشده توسط این کنش پرش می‌کند. پیش‌گزیده \-1 است .sp دومین مقدار، تعداد خط‌هایی است که باید بالای خط فرمان پرش‌شده نمایش داده شوند. این گزینه تا حدی شبیه گزینهٔ \fI\-\-jump\-target\fP در \fIless\fP یا تنظیم \fIscrolloff\fP در vim است. پیش‌گزیده 0 است. .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+p scroll_to_prompt \-1 3 # پرش به قبلی، با نمایش ۳ خط پیشین map ctrl+n scroll_to_prompt 1 # پرش به بعدی map ctrl+o scroll_to_prompt 0 # پرش به آخرین بازدیدشده .EE .UNINDENT .UNINDENT .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+x\fP \%<#\:shortcut-kitty\:.Scroll-to-next-shell-prompt>، \fBctrl+shift+z\fP \%<#\:shortcut-kitty\:.Scroll-to-previous-shell-prompt> .INDENT 0.0 .TP .B search_scrollback .UNINDENT .sp جستجو در تاریخچه با صفحه‌بندهایی نظیر less. در صورت وجود متن انتخاب‌شده، به‌طور خودکار جستجو می‌شود. .sp توجه داشته باشید فرض بر این است که فشردن کلید / حالت جستجو را در صفحه‌بند پیکربندی‌شده به عنوان صفحه‌بند تاریخچه فعال می‌کند. .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+/\fP \%<#\:shortcut-kitty\:.Search-the-scrollback-within-a-pager> .INDENT 0.0 .TP .B show_first_command_output_on_screen .UNINDENT .sp نمایش خروجی نخستین دستور پوسته روی صفحه در یک صفحه‌بند مانند less .sp برای کارکرد نیازمند Shell integration \%<#\:shell-integration> است .INDENT 0.0 .TP .B show_last_command_output .UNINDENT .sp نمایش خروجی آخرین دستور پوسته در یک صفحه‌بند مانند less .sp برای کارکرد نیازمند Shell integration \%<#\:shell-integration> است .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+g\fP \%<#\:shortcut-kitty\:.Browse-output-of-the-last-shell-command-in-pager> .INDENT 0.0 .TP .B show_last_non_empty_command_output .UNINDENT .sp نمایش آخرین خروجی غیرخالی یک دستور پوسته در یک صفحه‌بند مانند less .sp برای کارکرد نیازمند Shell integration \%<#\:shell-integration> است .INDENT 0.0 .TP .B show_last_visited_command_output .UNINDENT .sp نمایش نخستین خروجی دستور زیر آخرین موقعیت پیمایش‌شده از طریق scroll_to_prompt .sp یا آخرین خروجی دستور کلیک‌شده با موشواره در یک صفحه‌بند مانند less .sp برای کارکرد نیازمند Shell integration \%<#\:shell-integration> است .INDENT 0.0 .TP .B show_scrollback .UNINDENT .sp نمایش تاریخچه در یک صفحه‌بند مانند less .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+h\fP \%<#\:shortcut-kitty\:.Browse-scrollback-buffer-in-pager> .SS نشست‌ها (Sessions) .INDENT 0.0 .TP .B close_session .UNINDENT .sp بستن یک نشست، یعنی بستن تمام پنجره‌های متعلق به آن نشست. .INDENT 0.0 .TP .B نمونه‌ها:: # پرسش برای نشست موردنظر جهت بستن map f1 close_session # بستن نشست فعال فعلی map f1 close_session . # بستن نشست بر اساس نام map f1 close_session \(dqmy session\(dq # بستن نشست بر اساس مسیر فایل نشست map f1 close_session \(dq/path/to/session/file.kitty\-session\(dq .UNINDENT .INDENT 0.0 .TP .B goto_session .UNINDENT .sp رفتن به نشست مشخص‌شده، و ایجاد آن در صورت عدم وجود. Creating/Switching to sessions with a keypress \%<#\:goto-session>\& را ببینید. .INDENT 0.0 .TP .B save_as_session .UNINDENT .sp ذخیره وضعیت فعلی kitty به عنوان یک فایل نشست. The save_as_session action \%<#\:save-as-session>\& را ببینید. .SS مدیریت زبانه‌ها (Tab management) .INDENT 0.0 .TP .B close_other_tabs_in_os_window .UNINDENT .sp بستن تمام زبانه‌های پنجره سیستم‌عامل جاری به جز زبانه فعال فعلی .INDENT 0.0 .TP .B close_tab .UNINDENT .sp بستن زبانه جاری .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+q\fP \%<#\:shortcut-kitty\:.Close-tab> .INDENT 0.0 .TP .B detach_tab .UNINDENT .sp جداسازی یک زبانه و انتقال آن به پنجره سیستم‌عامل دیگر. همچنین می‌توانید از کشیدن و رها کردن برای جداسازی زبانه‌ها استفاده کنید. .sp برای جزئیات detaching windows \%<#\:detach-window> را ببینید. .INDENT 0.0 .TP .B goto_tab .UNINDENT .sp رفتن به زبانه مشخص‌شده با شماره، شروع از ۱ .sp اعداد صفر و منفی به زبانه‌های فعال قبلی می‌روند. از کنش \fBselect_tab\fP برای انتخاب تعاملی زبانه جهت انتقال استفاده کنید. .INDENT 0.0 .TP .B move_tab_backward .UNINDENT .sp انتقال زبانه فعال به عقب. همچنین می‌توانید از کشیدن و رها کردن برای چیدمان مجدد زبانه‌ها استفاده کنید. .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+,\fP \%<#\:shortcut-kitty\:.Move-tab-backward> .INDENT 0.0 .TP .B move_tab_forward .UNINDENT .sp انتقال زبانه فعال به جلو. همچنین می‌توانید از کشیدن و رها کردن برای چیدمان مجدد زبانه‌ها استفاده کنید. .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+.\fP \%<#\:shortcut-kitty\:.Move-tab-forward> .INDENT 0.0 .TP .B new_tab .UNINDENT .sp ایجاد یک زبانه جدید .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+t\fP \%<#\:shortcut-kitty\:.New-tab> .INDENT 0.0 .TP .B new_tab_with_cwd .UNINDENT .sp ایجاد یک زبانه جدید با پوشه کاری یکسان با پنجره فعال برای پنجره موجود در آن. .sp زبانه به نشست فعال فعلی \%<#\:sessions> (در صورت وجود) افزوده می‌شود. .INDENT 0.0 .TP .B next_tab .UNINDENT .sp فعال کردن زبانه بعدی .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+right\fP \%<#\:shortcut-kitty\:.Next-tab> .INDENT 0.0 .TP .B previous_tab .UNINDENT .sp فعال کردن زبانه قبلی .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+left\fP \%<#\:shortcut-kitty\:.Previous-tab> .INDENT 0.0 .TP .B select_tab .UNINDENT .sp انتخاب تعاملی یک زبانه برای رفتن به آن .INDENT 0.0 .TP .B set_tab_title .UNINDENT .sp تغییر تعاملی عنوان زبانه فعال با نوشتن عنوان جدید. .sp اگر آرگومانی برای این کنش مشخص کنید، به جای درخواست عنوان، از آن به عنوان عنوان زبانه استفاده می‌شود. از رشته خالی (\(dq\(dq) برای بازنشانی عنوان به حالت پیش‌گزیده استفاده کنید. از یک فاصله (\(dq \(dq) برای مشخص کردن این که خط فرمان نباید پیش‌پر شده باشد استفاده کنید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # استفاده تعاملی map f1 set_tab_title # تنظیم یک عنوان مشخص map f2 set_tab_title some title # بازنشانی به پیش‌گزیده map f3 set_tab_title \(dq\(dq # استفاده تعاملی بدون خط فرمان پیش‌پر شده map f3 set_tab_title \(dq \(dq .EE .UNINDENT .UNINDENT .sp میان‌برهای پیش‌گزیده برای این کنش: \fBctrl+shift+alt+t\fP \%<#\:shortcut-kitty\:.Set-tab-title> .SS مدیریت پنجره (Window management) .INDENT 0.0 .TP .B set_window_title .UNINDENT .sp تغییر تعاملی عنوان پنجره فعال با نوشتن عنوان جدید. .sp در صورت تعیین آرگومان برای این کنش، از آن به عنوان عنوان استفاده می‌شود و درخواستی نمایش داده نخواهد شد. برای بازنشانی عنوان به پیش‌فرض از رشته خالی (\(dq\(dq) استفاده کنید. برای خالی ماندن اعلان ورودی و پیش‌پر نشدن آن، از یک فاصله (\(dq \(dq) استفاده کنید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # کاربرد تعاملی map f1 set_window_title # تنظیم عنوان مشخص map f2 set_window_title some title # بازنشانی به پیش‌فرض map f3 set_window_title \(dq\(dq # کاربرد تعاملی بدون اعلان پیش‌پر شده map f3 set_window_title \(dq \(dq .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B close_other_windows_in_tab .UNINDENT .sp بستن همه پنجره‌های برگه بجز پنجره فعال فعلی .INDENT 0.0 .TP .B eighth_window .UNINDENT .sp تمرکز روی پنجره هشتم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+8\fP \%<#\:shortcut-kitty\:.Eighth-window> .INDENT 0.0 .TP .B fifth_window .UNINDENT .sp تمرکز روی پنجره پنجم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+5\fP \%<#\:shortcut-kitty\:.Fifth-window> .INDENT 0.0 .TP .B first_window .UNINDENT .sp تمرکز روی پنجره نخست .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+1\fP \%<#\:shortcut-kitty\:.First-window> .INDENT 0.0 .TP .B focus_visible_window .UNINDENT .sp تمرکز روی یک پنجره مرئی با فشردن شماره پنجره. در این حالت شماره‌ها .sp برای انتخاب آسان روی پنجره‌ها نمایش داده می‌شوند. \fBvisual_window_select_characters\fP \%<#\:opt-kitty\:.visual_window_select_characters>\& را ببینید. .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+f7\fP \%<#\:shortcut-kitty\:.Visually-select-and-focus-window> .INDENT 0.0 .TP .B fourth_window .UNINDENT .sp تمرکز روی پنجره چهارم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+4\fP \%<#\:shortcut-kitty\:.Fourth-window> .INDENT 0.0 .TP .B move_window .UNINDENT .sp انتقال پنجره در جهت مشخص‌شده .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+left move_window left map ctrl+down move_window bottom .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B move_window_backward .UNINDENT .sp انتقال پنجره فعال به عقب (جابجایی با پنجره قبلی) .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+b\fP \%<#\:shortcut-kitty\:.Move-window-backward> .INDENT 0.0 .TP .B move_window_forward .UNINDENT .sp انتقال پنجره فعال به جلو (جابجایی با پنجره بعدی) .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+f\fP \%<#\:shortcut-kitty\:.Move-window-forward> .INDENT 0.0 .TP .B move_window_to_top .UNINDENT .sp انتقال پنجره فعال به ابتدا (تبدیل به پنجره نخست) .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+\(ga\fP \%<#\:shortcut-kitty\:.Move-window-to-top> .INDENT 0.0 .TP .B neighboring_window .UNINDENT .sp تمرکز روی پنجره همسایه در برگه جاری .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+left neighboring_window left map ctrl+down neighboring_window bottom .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B next_window .UNINDENT .sp تمرکز روی پنجره بعدی در برگه جاری. پنجره‌های روکش (overlay) پیمایش نمی‌شوند. .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+]\fP \%<#\:shortcut-kitty\:.Next-window> .INDENT 0.0 .TP .B ninth_window .UNINDENT .sp تمرکز روی پنجره نهم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+9\fP \%<#\:shortcut-kitty\:.Ninth-window> .INDENT 0.0 .TP .B nth_window .UNINDENT .sp تمرکز روی n-اُمین پنجره در صورت مثبت بودن یا پنجره‌های فعال قبلی در صورت منفی بودن. اگر عدد بزرگ‌تر .sp از تعداد پنجره‌ها باشد روی پنجره آخر تمرکز می‌شود. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # تمرکز روی پنجره فعال قبلی map ctrl+p nth_window \-1 # تمرکز روی پنجره نخست map ctrl+1 nth_window 0 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B previous_window .UNINDENT .sp تمرکز روی پنجره قبلی در برگه جاری. پنجره‌های روکش (overlay) پیمایش نمی‌شوند. .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+[\fP \%<#\:shortcut-kitty\:.Previous-window> .INDENT 0.0 .TP .B reset_window_sizes .UNINDENT .sp بازنشانی اندازه پنجره‌ها و واگردانی هرگونه تغییر اندازه پویا .INDENT 0.0 .TP .B resize_window .UNINDENT .sp تغییر اندازه پنجره فعال به مقدار مشخص‌شده .sp برای جزئیات بیشتر تغییر اندازه پنجره‌ها \%<#\:window-resizing> را ببینید. .INDENT 0.0 .TP .B second_window .UNINDENT .sp تمرکز روی پنجره دوم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+2\fP \%<#\:shortcut-kitty\:.Second-window> .INDENT 0.0 .TP .B seventh_window .UNINDENT .sp تمرکز روی پنجره هفتم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+7\fP \%<#\:shortcut-kitty\:.Seventh-window> .INDENT 0.0 .TP .B sixth_window .UNINDENT .sp تمرکز روی پنجره ششم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+6\fP \%<#\:shortcut-kitty\:.Sixth-window> .INDENT 0.0 .TP .B swap_with_window .UNINDENT .sp جابجایی پنجره جاری با پنجره‌ای دیگر در برگه فعلی با انتخاب دیداری. \fBvisual_window_select_characters\fP \%<#\:opt-kitty\:.visual_window_select_characters> را ببینید. .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+f8\fP \%<#\:shortcut-kitty\:.Visually-swap-window-with-another> .INDENT 0.0 .TP .B tenth_window .UNINDENT .sp تمرکز روی پنجره دهم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+0\fP \%<#\:shortcut-kitty\:.Tenth-window> .INDENT 0.0 .TP .B third_window .UNINDENT .sp تمرکز روی پنجره سوم .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+3\fP \%<#\:shortcut-kitty\:.Third-window> .INDENT 0.0 .TP .B close_os_window .UNINDENT .sp بستن پنجره فعال جاری در سیستم‌عامل .sp میان‌برهای پیش‌فرض این کنش: \fBshift+cmd+w\fP \%<#\:shortcut-kitty\:.Close-OS-window> .INDENT 0.0 .TP .B close_other_os_windows .UNINDENT .sp بستن همه پنجره‌های دیگر سیستم‌عامل بجز پنجره دربردارنده پنجره فعال جاری .INDENT 0.0 .TP .B close_window .UNINDENT .sp بستن پنجره فعال جاری .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+w\fP \%<#\:shortcut-kitty\:.Close-window> .INDENT 0.0 .TP .B close_window_with_confirmation .UNINDENT .sp بستن پنجره همراه با تأیید .sp پیش از بستن پنجره درخواست تأیید می‌کند. اگر در اعلان پوسته نیازی به تأیید ندارید (نیازمند یکپارچه‌سازی پوسته \%<#\:shell-integration>)، استفاده کنید از: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 close_window_with_confirmation ignore\-shell .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B detach_window .UNINDENT .sp جداسازی پنجره و انتقال آن به برگه یا پنجره سیستم‌عامل دیگر .sp برای جزئیات بیشتر جداسازی پنجره‌ها \%<#\:detach-window> را ببینید. .INDENT 0.0 .TP .B new_os_window .UNINDENT .sp پنجره جدید سیستم‌عامل .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+n\fP \%<#\:shortcut-kitty\:.New-OS-window> .INDENT 0.0 .TP .B new_os_window_with_cwd .UNINDENT .sp پنجره جدید سیستم‌عامل با پوشه کاری یکسان با پنجره فعال جاری. .sp پنجره جدید سیستم‌عامل به نشست فعال فعلی \%<#\:sessions> (در صورت وجود) اضافه می‌شود. .INDENT 0.0 .TP .B new_window .UNINDENT .sp ایجاد پنجره جدید .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+enter\fP \%<#\:shortcut-kitty\:.New-window> .INDENT 0.0 .TP .B new_window_with_cwd .UNINDENT .sp ایجاد پنجره جدید با پوشه کاری یکسان با پنجره فعال. .sp پنجره جدید به نشست فعال \%<#\:sessions> (در صورت وجود) تعلق خواهد داشت. .INDENT 0.0 .TP .B nth_os_window .UNINDENT .sp تمرکز روی n-اُمین پنجره سیستم‌عامل در صورت مثبت بودن یا پنجره‌های فعال قبلی سیستم‌عامل در صورت منفی بودن. اگر عدد بزرگ‌تر .sp از تعداد پنجره‌های سیستم‌عامل باشد روی آخرین پنجره سیستم‌عامل تمرکز می‌شود. مقدار صفر تمرکز را دوباره به پنجره فعلی سیستم‌عامل می‌دهد؛ این حالت زمانی که تمرکز روی هیچ پنجره kitty نیست کاربرد دارد، با این حال تنها زمانی کار خواهد کرد که مدیر پنجره اجازه گرفتن تمرکز را به برنامه‌ها بدهد. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX # تمرکز روی پنجره فعال قبلی kitty در سیستم‌عامل map ctrl+p nth_os_window \-1 # تمرکز روی پنجره فعلی kitty در سیستم‌عامل (گرفتن تمرکز) map ctrl+0 nth_os_window 0 # تمرکز روی نخستین پنجره kitty در سیستم‌عامل map ctrl+1 nth_os_window 1 # تمرکز روی آخرین پنجره kitty در سیستم‌عامل map ctrl+1 nth_os_window 999 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B quit .UNINDENT .sp خروج و بستن همه پنجره‌ها .sp میان‌برهای پیش‌فرض این کنش: \fBcmd+q\fP \%<#\:shortcut-kitty\:.Quit-kitty> .INDENT 0.0 .TP .B set_background_opacity .UNINDENT .sp تنظیم کدر بودن پس‌زمینه برای پنجره فعال سیستم‌عامل .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 set_background_opacity +0.1 map f2 set_background_opacity \-0.1 map f3 set_background_opacity 0.5 .EE .UNINDENT .UNINDENT .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+a>l\fP \%<#\:shortcut-kitty\:.Decrease-background-opacity>, \fBctrl+shift+a>1\fP \%<#\:shortcut-kitty\:.Make-background-fully-opaque>, \fBctrl+shift+a>m\fP \%<#\:shortcut-kitty\:.Increase-background-opacity>, \fBctrl+shift+a>d\fP \%<#\:shortcut-kitty\:.Reset-background-opacity> .INDENT 0.0 .TP .B start_resizing_window .UNINDENT .sp تغییر اندازه تعاملی پنجره فعال .sp برای جزئیات بیشتر تغییر اندازه پنجره‌ها \%<#\:window-resizing> را ببینید. .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+r\fP \%<#\:shortcut-kitty\:.Start-resizing-window> .INDENT 0.0 .TP .B toggle_fullscreen .UNINDENT .sp تغییر وضعیت تمام‌صفحه پنجره فعال سیستم‌عامل .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+f11\fP \%<#\:shortcut-kitty\:.Toggle-fullscreen> .INDENT 0.0 .TP .B toggle_maximized .UNINDENT .sp تغییر وضعیت بیشینه‌بودن پنجره فعال سیستم‌عامل .sp میان‌برهای پیش‌فرض این کنش: \fBctrl+shift+f10\fP \%<#\:shortcut-kitty\:.Toggle-maximized> .INDENT 0.0 .TP .B toggle_tab .UNINDENT .sp جابجایی به برگه منطبق با عبارت مشخص‌شده .sp اگر برگه دیگری جاری باشد به برگه منطبق جابجا می‌شود، در غیر این صورت به آخرین برگه استفاده‌شده می‌رود. برای رفت‌وبرگشت آسان به یک برگه با یک میان‌بر کاربرد دارد. توجه کنید که جابجایی تنها میان برگه‌های درون یک پنجره سیستم‌عامل کار می‌کند. برای جزئیات عبارت تطبیق، تطبیق پنجره‌ها و برگه‌ها \%<#\:search-syntax> را ببینید. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX map f1 toggle_tab title:mytab .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B toggle_window_title_bars .UNINDENT .sp نمایش موقت نوار عنوان پنجره‌ها برای امکان مرتب‌سازی با کشیدن .sp هنگامی که نوارهای عنوان پنجره پنهان هستند (به دلیل برقرار نشدن شرط \fBwindow_title_bar_min_windows\fP \%<#\:opt-kitty\:.window_title_bar_min_windows>)، این کنش آن‌ها را موقتاً نمایان می‌کند تا با کشیدن بتوان چیدمان پنجره‌ها را تغییر داد. پس از پایان هر عملیات کشیدن، نوارها خودکار دوباره پنهان می‌شوند. پیش از کشیدن، برای لغو مجدداً فشار دهید. .sp روی برگه‌هایی که نوارهای عنوان از قبل به طور طبیعی نمایان هستند تأثیری ندارد. .sp یک کلید به این کنش نگاشت کنید و پیش از کشیدن نوار عنوان پنجره آن را بفشارید. .SS قالب‌های رنگی گستره وسیع (Wide gamut color formats) .sp نرم‌افزار kitty از قالب‌های رنگی مدرن با گستره وسیع (wide gamut) برای تعیین دقیق رنگ‌ها پشتیبانی می‌کند. از این قالب‌ها می‌توان در هر کجای پیکربندی که مقدار رنگ پذیرفته می‌شود (مانند foreground، background، color0\-color255 و غیره) استفاده کرد. .SS رنگ‌های OKLCH .sp فضای رنگی OKLCH یک فضای رنگی یکنواخت از نظر ادراکی است و برای ایجاد تم‌های رنگی ایده‌آل است. قالب آن به شرح زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX foreground oklch(0.9 0.05 140) color1 oklch(0.7 0.25 25) .EE .UNINDENT .UNINDENT .sp پارامترها: .INDENT 0.0 .IP \(bu 2 \fBL\fP (روشنایی - Lightness): بین ۰ تا ۱، که ۰ نشان‌دهنده سیاه و ۱ نشان‌دهنده سفید است .IP \(bu 2 \fBC\fP (فام‌داری - Chroma): بین ۰ تا تقریباً ۰.۴، بیانگر غلظت رنگ (اشباع) است .IP \(bu 2 \fBH\fP (فام - Hue): بین ۰ تا ۳۶۰ درجه (۰=قرمز، ۱۲۰=سبز، ۲۴۰=آبی) .UNINDENT .sp مزایا: .INDENT 0.0 .IP \(bu 2 یکنواخت از نظر ادراکی \- تغییرات برابر منجر به تفاوت‌های ادراکی برابر می‌شود .IP \(bu 2 تنظیم روشنایی باعث حفظ فام رنگ می‌شود (برخلاف HSL) .IP \(bu 2 استاندارد صنعتی برای طراحی مدرن رنگ .UNINDENT .sp نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX foreground oklch(0.9 0.05 140) color1 oklch(0.65 0.25 29) # قرمز-نارنجی زنده color2 oklch(0.65 0.25 142) # سبز زنده color3 oklch(0.70 0.19 90) # زرد گرم .EE .UNINDENT .UNINDENT .SS رنگ‌های CIE LAB .sp فضای CIE LAB یک فضای رنگی مستقل از دستگاه است که برای تقریب بینایی انسان طراحی شده است. .sp قالب آن به شرح زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX background lab(20 5 \-10) color4 lab(50 0 \-50) .EE .UNINDENT .UNINDENT .sp پارامترها: .INDENT 0.0 .IP \(bu 2 \fBL\fP: روشنایی، بین ۰ تا ۱۰۰ (۰ = سیاه، ۱۰۰ = سفید) .IP \(bu 2 \fBa\fP: سبز (\-) تا قرمز (+)، معمولاً ۱۰۰\- تا ۱۰۰+ .IP \(bu 2 \fBb\fP: آبی (\-) تا زرد (+)، معمولاً ۱۰۰\- تا ۱۰۰+ .UNINDENT .sp نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX background lab(10 0 0) # خاکستری خنثی بسیار تیره foreground lab(90 0 0) # خاکستری خنثی بسیار روشن color1 lab(50 60 40) # قرمز color4 lab(50 0 \-50) # آبی .EE .UNINDENT .UNINDENT .SS نگاشت گستره رنگ (Gamut Mapping) .sp هنگامی که رنگ‌هایی را در قالب‌های OKLCH یا CIE LAB خارج از گستره رنگ sRGB مشخص می‌کنید، kitty به طور خودکار آن‌ها را با استفاده از الگوریتم نگاشت گستره رنگ CSS Color Module Level 4 تبدیل می‌کند: .INDENT 0.0 .IP \(bu 2 روشنایی و فام اصلی را تا حد امکان حفظ می‌کند .IP \(bu 2 فام‌داری (غلظت رنگ) را تا جایی کاهش می‌دهد که رنگ در محدوده قابل نمایش قرار گیرد .IP \(bu 2 از تفاوت رنگ ادراکی (deltaE OK) برای به حداقل رساندن تغییرات قابل مشاهده استفاده می‌کند .IP \(bu 2 غلظت رنگ را ضمن حفظ حضور در گستره قابل نمایش، به بیشترین حد ممکن می‌رساند .UNINDENT .sp این موضوع تضمین می‌کند که رنگ‌های با گستره وسیع در نمایشگرهای استاندارد sRGB سازگاری روان داشته باشند و در عین حال در صورت وجود نمایشگرهای با گستره وسیع، از تمام پتانسیل آن‌ها بهره ببرند. این نگاشت به طور خودکار انجام می‌شود \- نیازی به انجام تنظیمات خاصی نیست. .sp برای نمونه، \fBoklch(0.7 0.4 25)\fP ممکن است برای sRGB بیش از حد غلیظ باشد، اما با حفظ فام و روشنایی ادراک‌شده، به طور خودکار متناسب‌سازی می‌شود. .SS مراجع (REFERENCES) .INDENT 0.0 .IP \(bu 2 CSS Color Module Level 4 \% .IP \(bu 2 OKLCH Color Space \% .UNINDENT .SH "نویسنده (AUTHOR)" Kovid Goyal .SH "حق نشر (COPYRIGHT)" 2026, Kovid Goyal .\" End of generated man page.