.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "kitten-choose-fonts" 1 "Jul 30, 2026" "0.48.2" "kitty" .SH "نام (NAME)" kitten-choose-fonts \- ابزار انتخاب و تنظیم قلم‌ها در ترمینال kitty .SH "نمای کلی (OVERVIEW)" .sp علاقه‌مندان به ترمینال تمام روز را به تماشای متن می‌گذرانند؛ از این رو رندرینگ درست و دقیق متن بسیار حائز اهمیت است. kitty امکانات فوق‌العاده قدرتمندی برای تنظیم دقیق رندرینگ متن دارد. این ترمینال از ویژگی‌های OpenType \% برای انتخاب اشکال جایگزین گلیف‌ها و همچنین فونت‌های متغیر (Variable fonts) \% برای کنترل دقیق ضخامت (weight) یا فاصله‌گذاری فونت پشتیبانی می‌کند. شما همچنین می‌توانید \fBمشخص کنید که کدام فونت برای رندر کدپوینت‌های خاص یونیکد استفاده شود\fP \%<#\:opt-kitty\:.symbol_map>، \fBسنجه‌های فونت (font metrics) را اصلاح کنید\fP \%<#\:opt-kitty\:.modify_font> و حتی \fBمنحنی‌های گاما را تنظیم کنید\fP \%<#\:opt-kitty\:.text_composition_strategy> که برای رندر متن روی رنگ پس‌زمینه به کار می‌روند. .sp نخستین گام، انتخاب قلم‌هایی (faces) است که kitty برای رندر متن‌های معمولی (regular)، ضخیم (bold) و مورب (italic) استفاده خواهد کرد. kitty همراه با یک رابط کاربری مناسب برای انتخاب فونت‌ها در قالب برنامه جانبی (kitten) به نام \fIchoose\-fonts\fP ارائه می‌شود. کافی است دستور زیر را اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten choose\-fonts .EE .UNINDENT .UNINDENT .sp و اعلان‌های روی صفحه را دنبال کنید. .sp ابتدا، خانواده فونت مورد نظر خود را انتخاب کنید؛ فهرست خانواده‌ها را می‌توان با تایپ چند حرف از نام خانواده‌ای که به دنبال آن هستید به آسانی فیلتر کرد. صفحه انتخاب خانواده پیش‌نمایشی از نحوه نمایش آن خانواده را به شما نشان می‌دهد. .sp پس از انتخاب یک خانواده با فشردن کلید \fBEnter\fP، پیش‌نمایشی از شکل ظاهری قلم‌های معمولی، بولد و ایتالیک آن خانواده به شما نشان داده می‌شود. شما می‌توانید هر یک از این سبک‌ها را به دلخواه تنظیم دقیق کنید. کار را با فشردن کلید \fBR\fP برای تنظیم دقیق قلم معمولی آغاز کنید. سایر سبک‌ها بر اساس انتخابی که برای قلم معمولی انجام می‌دهید، به‌طور خودکار تنظیم خواهند شد. .sp می‌توانید با کلیک روی یک سبک خاص یا ویژگی فونت، آن را انتخاب کنید. مقدار دقیق هر محور متغیر (variable axes) با استفاده از اسلایدر قابل انتخاب است؛ در تصویر بالا، فونت از تنظیم دقیق ضخامت (weight) پشتیبانی می‌کند. اگر شانس با شما یار باشد، طراح فونت نام‌های توصیفی را برای ویژگی‌های فونت قرار داده است که نمایش داده خواهند شد؛ در غیر این صورت، برای اطلاع از کارکرد هر ویژگی به مستندات فونت مراجعه کنید. .SH "نحو مشخص‌سازی فونت (THE FONT SPECIFICATION SYNTAX)" .sp اگر به برنامه choose fonts علاقه‌ای ندارید یا صرفاً می‌خواهید گزینه‌های انتخاب فونت را بشناسید و خودتان در فایل \fBkitty.conf\fP بنویسید، ادامه را بخوانید. .sp چهار کلید برای انتخاب قلم فونت وجود دارد: \fIfont_family\fP، \fIbold_font\fP، \fIitalic_font\fP و \fIbold_italic_font\fP\&. هر یک از این‌ها از نحو شرح داده شده در زیر پشتیبانی می‌کنند. مقادیر آن‌ها می‌تواند از سه نوع باشد: نام یک خانواده فونت، کلمه کلیدی \fBauto\fP، یا نحو گسترده \fBkey=value\fP برای مشخص کردن دقیق انتخاب فونت. .sp اگر نام خانواده فونت مشخص شود، kitty از APIهای سیستم‌عامل برای جستجوی فونت منطبق استفاده خواهد کرد. کلمه کلیدی \fBauto\fP بدین معناست که kitty فونت را کاملاً خودکار انتخاب می‌کند؛ این حالت معمولاً برای انتخاب خودکار انواع بولد/ایتالیک پس از تعیین \fBfont_family\fP \%<#\:opt-kitty\:.font_family> استفاده می‌شود. سپس گونه‌های بولد و ایتالیک به‌طور خودکار از همان مجموعه ویژگی‌های قلم اصلی استفاده خواهند کرد. .sp برای مشخص کردن دقیق‌تر انتخاب قلم فونت، از نحو \fBkey=value\fP استفاده می‌شود. ابتدا به چند مثال نگاهی بیندازیم: .INDENT 0.0 .INDENT 3.5 .sp .EX # انتخاب تنها بر اساس خانواده، انتخاب قلم واقعی خودکار است font_family family=\(dqFira Code\(dq # انتخاب یک قلم دقیق با نام Postscript font_family postscript_name=FiraCode # انتخاب یک قلم دقیق بر اساس خانواده همراه با ویژگی‌ها و ضخامت متغیر font_family family=SourceCodeVF variable_name=SourceCodeUpright features=\(dq+zero cv01=2\(dq wght=380 .EE .UNINDENT .UNINDENT .sp کلیدهای شناخته‌شده در ادامه آورده شده‌اند؛ هر کلید دیگری به عنوان نام یک \fIمحور متغیر (variable axis)\fP در نظر گرفته می‌شود، بدین معنی که برای تعیین مقدار متغیر برای مشخصه‌ای از فونت به کار می‌رود. .INDENT 0.0 .TP .B \fBfamily\fP نام یک خانواده فونت. یک خانواده معمولاً شامل چندین قلم واقعی مختلف است، مانند گونه‌های بولد و ایتالیک. حتی یک یا چند قلم می‌توانند متغیر باشند که امکان تنظیم دقیق مشخصه‌های فونت را فراهم می‌کند. .TP .B \fBstyle\fP نام سبک برای انتخاب یک فونت خاص از خانواده مشخص‌شده. تنها با کلید \fBfamily\fP مفید است، زمانی که روش‌های دقیق‌تری برای انتخاب قلم تعیین نشده باشد. همچنین می‌تواند برای مشخص کردن یک سبک متغیر نام‌گذاری‌شده در فونت‌های متغیر استفاده شود. .TP .B \fBpostscript_name\fP نام واقعی Postscript برای یک قلم فونت. این امکان انتخاب یک گونه خاص را در یک خانواده فونت فراهم می‌کند. اما توجه داشته باشید که نام‌های Postscript معمولاً برای انتخاب فونت‌های متغیر کافی نیستند. .TP .B \fBfull_name\fP از این کلید می‌توان برای انتخاب یک قلم فونت خاص در یک خانواده استفاده کرد. با این حال، دقت آن از \fBpostscript_name\fP کمتر است و عموماً نباید استفاده شود. .TP .B \fBvariable_name\fP برخی از خانواده‌های دارای فونت‌های متغیر در واقع شامل چندین فایل فونت هستند. برای مثال، یک خانواده می‌تواند دارای وزن‌های متغیر باشد به‌طوری که یک فایل فونت شامل قلم‌های ایستاده با وزن متغیر و فایل دیگر شامل قلم‌های ایتالیک با وزن متغیر باشد. فونت‌های خوش‌طراحی‌شده از یک \fIنام متغیر (variable name)\fP برای تمایز میان چنین فایل‌هایی استفاده می‌کنند. باید همراه با \fBfamily\fP برای انتخاب فایل فونت متغیر خاص استفاده شود. .TP .B \fBfeatures\fP فهرستی از ویژگی‌های فونت OpenType که با فاصله از هم جدا شده‌اند تا برای این فونت فعال/غیرفعال شوند یا مقداری برای آن‌ها انتخاب گردد. برای مشاهده ویژگی‌های پشتیبانی‌شده و تأثیر آن‌ها، به مستندات خانواده فونت مراجعه کنید. نحو دقیق مشخص‌سازی ویژگی‌ها توسط HarfBuzz در مستندات آن \% مستند شده است. .TP .B \fBsystem\fP می‌توان از این کلید برای ارسال یک رشته دلخواه، معمولاً نام خانواده یا نام کامل، به APIهای انتخاب فونت سیستم‌عامل استفاده کرد. نباید همراه با هیچ کلید دیگری استفاده شود. عملکرد آن مشابه مشخص کردن تنها نام فونت بدون هیچ کلیدی است. .UNINDENT .sp علاوه بر این کلیدها، هر کلید چهارحرفی به عنوان نام یک مشخصه متغیر فونت در نظر گرفته می‌شود. مقدار آن برای تعیین مقدار مشخصه مربوطه استفاده خواهد شد. .SH "نویسنده (AUTHOR)" Kovid Goyal .SH "حق نشر (COPYRIGHT)" 2026, Kovid Goyal .\" End of generated man page.