.\" 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-themes" 1 "Jul 30, 2026" "0.48.2" "kitty" .SH "نام (NAME)" kitten-themes \- مدیریت آسان طرح‌های رنگی kitty .SH "نمای کلی (OVERVIEW)" .sp کیتن themes به شما امکان می‌دهد تم‌های رنگی را به‌سادگی از میان مجموعه‌ای شامل بیش از ۳۰۰ تم پیش‌ساخته‌ی موجود در kitty\-themes \%\& تغییر دهید. برای استفاده از آن، کافی است دستور زیر را اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten themes .EE .UNINDENT .UNINDENT .sp این کیتن امکان انتخاب تم همراه با پیش‌نمایش زنده رنگ‌ها را فراهم می‌کند. می‌توانید بین تم‌های روشن و تاریک انتخاب کنید و تنها با تایپ چند نویسه از نام تم، به جستجو بپردازید. .sp این کیتن فهرستی از تم‌های اخیراً استفاده‌شده را برای جابه‌جایی سریع نگه می‌دارد. .sp اگر می‌خواهید رنگ‌ها را به حالت پیش‌فرض بازگردانید، می‌توانید این کار را با انتخاب تم \fBDefault\fP انجام دهید. .sp اضافه‌شده در نگارش 0.23.0: کیتن themes .SH "نحوه کارکرد (HOW IT WORKS)" .sp یک تم در kitty صرفاً فایلی با پسوند \fB\&.conf\fP حاوی تنظیمات kitty است. وقتی تمی را انتخاب می‌کنید، این کیتن به‌سادگی فایل \fB\&.conf\fP را در \fB~/.config/kitty/current\-theme.conf\fP کپی کرده و یک دستور درج (include) برای \fBcurrent\-theme.conf\fP به \fBkitty.conf\fP می‌افزاید. همچنین هرگونه تنظیمات رنگ فعلی در \fBkitty.conf\fP را کامنت می‌کند تا تداخلی ایجاد نشود. .sp پس از انجام این کار، کیتن سیگنالی به kitty ارسال می‌کند تا پیکربندی خود را دوباره بارگذاری کند. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 اگر می‌خواهید تنظیمات رنگی خاصی در \fBkitty.conf\fP خود داشته باشید که کیتن تم آن‌ها را بازنویسی نکند، آن‌ها را به یک فایل conf جداگانه منتقل کرده و با \fBinclude\fP در kitty.conf وارد کنید. این include باید بعد از درج \fBcurrent\-theme.conf\fP قرار گیرد تا تنظیمات درون آن بر تنظیمات متناقض حاصل از \fBcurrent\-theme.conf\fP برتری یابند و بازنویسی‌شان کنند\&. .UNINDENT .UNINDENT .SH "تغییر خودکار تم رنگی هنگام تغییر سیستم‌عامل بین حالت‌های روشن و تاریک (CHANGE COLOR THEMES AUTOMATICALLY WHEN THE OS SWITCHES BETWEEN LIGHT AND DARK)" .sp اضافه‌شده در نگارش 0.38.0. .sp می‌توانید کاری کنید که با تغییر حالت سیستم‌عامل بین حالت‌های dark (تاریک)، light (روشن) و no\-preference (بدون اولویت)، kitty به طور خودکار تم رنگی خود را تغییر دهد. برای انجام این کار، کیتن theme را به طور معمول اجرا کرده و در صفحه پایانی گزینه‌ای را برای ذخیره تم انتخابی خود به عنوان light، dark یا no\-preference انتخاب کنید. این کار را تکرار کنید تا برای هر یک از این سه حالت یک تم مشخص کرده باشید. سپس با راه‌اندازی دوباره kitty، بسته به طرح رنگ سیستم‌عامل، تم‌های انتخابی شما به‌طور خودکار اعمال خواهند شد. .sp این سازوکار با ایجاد سه فایل \fBdark\-theme.auto.conf\fP، \fBlight\-theme.auto.conf\fP و \fBno\-preference\-theme.auto.conf\fP در دایرکتوری پیکربندی kitty کار می‌کند. هنگامی که این فایل‌ها وجود داشته باشند، kitty طرح رنگ را از سیستم‌عامل استعلام کرده و از فایل مناسب استفاده می‌کند. توجه داشته باشید که رنگ‌های درون این فایل‌ها بر تمام رنگ‌های دیگر و همچنین تمام تنظیمات تصویر پس‌زمینه اولویت دارند، حتی مواردی که با پرچم خط فرمان \fBkitty \-\-override\fP \%<#\:cmdoption-kitty-override> مشخص شده‌اند. همچنین kitty با تغییر طرح رنگ سیستم‌عامل (مانند انتقال بین روز و شب)، رنگ‌ها را به‌طور خودکار تغییر خواهد داد. .sp هنگام استفاده از این رنگ‌ها، شما همچنان می‌توانید رنگ‌ها را به‌طور پویا تغییر دهید، اما دفعه بعد که سیستم‌عامل حالت رنگ خود را تغییر دهد، تمام تغییرات پویا بازنویسی خواهند شد. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 در میزکار GNOME، هنگامی که \(dqDark style\(dq فعال نباشد، میزکار ترجیح رنگ را به عنوان no\-preference گزارش می‌دهد. بنابراین از \fBno\-preference\-theme.auto.conf\fP برای تعیین رنگ‌های حالت روشن در GNOME استفاده کنید. می‌توانید حالت روشن را با دستور \fBgsettings set org.gnome.desktop.interface color\-scheme prefer\-light\fP به صورت دستی فعال کنید؛ در این حالت GNOME طرح رنگ را به عنوان light گزارش می‌دهد و kitty از \fBlight\-theme.auto.conf\fP استفاده خواهد کرد\&. .UNINDENT .UNINDENT .SH "استفاده از تم‌های سفارشی (USING YOUR OWN THEMES)" .sp همچنین می‌توانید تم‌های خود را به صورت فایل‌های \fB\&.conf\fP بسازید. آن‌ها را در زیردایرکتوری \fBthemes\fP از دایرکتوری پیکربندی kitty \%<#\:confloc> قرار دهید، که معمولاً مسیر آن \fB~/.config/kitty/themes\fP است\&. کیتن به‌طور خودکار آن‌ها را به فهرست تم‌ها می‌افزاید. می‌توانید با نام‌گذاری فایل conf به صورت \fBSome theme name.conf\fP، تم داخلیِ هم‌نام با آن را بازنویسی و اصلاح کنید. در اینجا \fBSome theme name\fP نام واقعی تم داخلی است، نه نام فایل آن. توجه داشته باشید که پس از انجام این کار، باید یک بار کیتن را اجرا کرده و آن تم را انتخاب کنید تا تغییرات اعمال شوند. .SH "مشارکت در تم‌های جدید (CONTRIBUTING NEW THEMES)" .sp اگر مایل به ارسال تم جدیدی به مخزن تم‌های kitty هستید، با مراجعه به مخزن kitty\-themes \% شروع کنید. از آن یک انشعاب (Fork) تهیه کنید \%، و هنگام ساخت تم خود از فایل \fBtemplate.conf\fP به عنوان الگو استفاده کنید. هنگامی که از ظاهر آن رضایت داشتید، یک درخواست ادغام (pull request) ثبت کنید \% تا تم شما در مخزن kitty\-themes \% ادغام شده و به‌طور خودکار در این کیتن در دسترس قرار گیرد. .SH "تغییر تم به‌صورت غیرتعاملی (CHANGING THE THEME NON-INTERACTIVELY)" .sp می‌توانید نام تم را هنگام فراخوانی کیتن به عنوان یک آرگومان مشخص کنید تا فوراً به آن تم تغییر یابد. برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten themes \-\-reload\-in=all Dimmed Monokai .EE .UNINDENT .UNINDENT .sp تم را در تمام نمونه‌های در حال اجرای kitty به \fBDimmed Monokai\fP تغییر خواهد داد. برای جزئیات بیشتر درباره عملکرد غیرتعاملی به ادامه متن مراجعه کنید. .SH "کد منبع تم‌ها (SOURCE CODE FOR THEMES)" .sp کد منبع این کیتن در GitHub \%\& در دسترس است. .SH "رابط خط فرمان (COMMAND LINE INTERFACE)" .INDENT 0.0 .INDENT 3.5 .sp .EX kitten themes [options] [theme name to switch to] .EE .UNINDENT .UNINDENT .sp تم kitty را تغییر می‌دهد. اگر نام تمی ارائه نشود، به‌صورت تعاملی اجرا می‌شود؛ در غیر این صورت تم فعلی را به نام تم مشخص‌شده تغییر می‌دهد. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-cache\-age بررسی برای تم‌های جدید تنها پس از تعداد روزهای مشخص‌شده صورت می‌گیرد. مقدار صفر همیشه تم‌های جدید را بررسی می‌کند. مقدار منفی هرگز تم‌های جدید را بررسی نخواهد کرد و در صورتی که نسخه محلی تم‌ها موجود نباشد، خطا صادر می‌کند. پیش‌فرض: \fB1\fP .UNINDENT .INDENT 0.0 .TP .B \-\-reload\-in به‌طور پیش‌فرض، این کیتن پس از اعمال تغییرات، تنها به نمونه والد kitty که درون آن اجرا می‌شود سیگنال می‌دهد تا پیکربندی خود را دوباره بارگذاری کند. از این گزینه استفاده کنید تا پیکربندی اصلاً بارگذاری مجدد نشود یا در تمامی نمونه‌های در حال اجرای kitty بارگذاری شود. توجه داشته باشید که اگر بارگذاری خودکار پیکربندی در kitty.conf فعال باشد (به‌طور پیش‌فرض فعال است)، گزینه \fBparent\fP با \fBall\fP یکسان خواهد بود، زیرا تمامی نمونه‌های kitty تغییرات فایل پیکربندی را شناسایی کرده و خودبه‌خود آن را دوباره بارگذاری می‌کنند. پیش‌فرض: \fBparent\fP انتخاب‌ها: \fBall\fP، \fBnone\fP، \fBparent\fP .UNINDENT .INDENT 0.0 .TP .B \-\-dump\-theme [=no] هنگام اجرای غیرتعاملی، تم مشخص‌شده را به جای تغییر در kitty.conf، در STDOUT تخلیه می‌کند. پیش‌فرض: \fBfalse\fP .UNINDENT .INDENT 0.0 .TP .B \-\-config\-file\-name نام یا مسیر فایل پیکربندی برای ویرایش. مسیرهای نسبی با توجه به دایرکتوری پیکربندی kitty تفسیر می‌شوند. به‌طور پیش‌فرض فایل پیکربندی kitty یعنی kitty.conf ویرایش می‌شود. این گزینه زمانی بیشترین کاربرد را دارد که \fBinclude themes.conf\fP را به kitty.conf خود افزوده و بخواهید کیتن فقط روی \fBthemes.conf\fP عملیات انجام دهد تا \fBkitty.conf\fP بدون تغییر باقی بماند. پیش‌فرض: \fBkitty.conf\fP .UNINDENT .SH "نویسندگان (AUTHORS)" Kovid Goyal .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2026, Kovid Goyal .\" End of generated man page.