نام (NAME)

kitten-themes - مدیریت آسان طرح‌های رنگی kitty

نمای کلی (OVERVIEW)

کیتن themes به شما امکان می‌دهد تم‌های رنگی را به‌سادگی از میان مجموعه‌ای شامل بیش از ۳۰۰ تم پیش‌ساخته‌ی موجود در kitty-themes https://github.com/kovidgoyal/kitty-themes تغییر دهید. برای استفاده از آن، کافی است دستور زیر را اجرا کنید:

kitten themes

این کیتن امکان انتخاب تم همراه با پیش‌نمایش زنده رنگ‌ها را فراهم می‌کند. می‌توانید بین تم‌های روشن و تاریک انتخاب کنید و تنها با تایپ چند نویسه از نام تم، به جستجو بپردازید.

این کیتن فهرستی از تم‌های اخیراً استفاده‌شده را برای جابه‌جایی سریع نگه می‌دارد.

اگر می‌خواهید رنگ‌ها را به حالت پیش‌فرض بازگردانید، می‌توانید این کار را با انتخاب تم Default انجام دهید.

اضافه‌شده در نگارش 0.23.0: کیتن themes

نحوه کارکرد (HOW IT WORKS)

یک تم در kitty صرفاً فایلی با پسوند .conf حاوی تنظیمات kitty است. وقتی تمی را انتخاب می‌کنید، این کیتن به‌سادگی فایل .conf را در ~/.config/kitty/current-theme.conf کپی کرده و یک دستور درج (include) برای current-theme.conf به kitty.conf می‌افزاید. همچنین هرگونه تنظیمات رنگ فعلی در kitty.conf را کامنت می‌کند تا تداخلی ایجاد نشود.

پس از انجام این کار، کیتن سیگنالی به kitty ارسال می‌کند تا پیکربندی خود را دوباره بارگذاری کند.

نکته:

اگر می‌خواهید تنظیمات رنگی خاصی در kitty.conf خود داشته باشید که کیتن تم آن‌ها را بازنویسی نکند، آن‌ها را به یک فایل conf جداگانه منتقل کرده و با include در kitty.conf وارد کنید. این include باید بعد از درج current-theme.conf قرار گیرد تا تنظیمات درون آن بر تنظیمات متناقض حاصل از current-theme.conf برتری یابند و بازنویسی‌شان کنند.

تغییر خودکار تم رنگی هنگام تغییر سیستم‌عامل بین حالت‌های روشن و تاریک (CHANGE COLOR THEMES AUTOMATICALLY WHEN THE OS SWITCHES BETWEEN LIGHT AND DARK)

اضافه‌شده در نگارش 0.38.0.

می‌توانید کاری کنید که با تغییر حالت سیستم‌عامل بین حالت‌های dark (تاریک)، light (روشن) و no-preference (بدون اولویت)، kitty به طور خودکار تم رنگی خود را تغییر دهد. برای انجام این کار، کیتن theme را به طور معمول اجرا کرده و در صفحه پایانی گزینه‌ای را برای ذخیره تم انتخابی خود به عنوان light، dark یا no-preference انتخاب کنید. این کار را تکرار کنید تا برای هر یک از این سه حالت یک تم مشخص کرده باشید. سپس با راه‌اندازی دوباره kitty، بسته به طرح رنگ سیستم‌عامل، تم‌های انتخابی شما به‌طور خودکار اعمال خواهند شد.

این سازوکار با ایجاد سه فایل dark-theme.auto.conf، light-theme.auto.conf و no-preference-theme.auto.conf در دایرکتوری پیکربندی kitty کار می‌کند. هنگامی که این فایل‌ها وجود داشته باشند، kitty طرح رنگ را از سیستم‌عامل استعلام کرده و از فایل مناسب استفاده می‌کند. توجه داشته باشید که رنگ‌های درون این فایل‌ها بر تمام رنگ‌های دیگر و همچنین تمام تنظیمات تصویر پس‌زمینه اولویت دارند، حتی مواردی که با پرچم خط فرمان kitty --override <#cmdoption-kitty-override> مشخص شده‌اند. همچنین kitty با تغییر طرح رنگ سیستم‌عامل (مانند انتقال بین روز و شب)، رنگ‌ها را به‌طور خودکار تغییر خواهد داد.

هنگام استفاده از این رنگ‌ها، شما همچنان می‌توانید رنگ‌ها را به‌طور پویا تغییر دهید، اما دفعه بعد که سیستم‌عامل حالت رنگ خود را تغییر دهد، تمام تغییرات پویا بازنویسی خواهند شد.

نکته:

در میزکار GNOME، هنگامی که "Dark style" فعال نباشد، میزکار ترجیح رنگ را به عنوان no-preference گزارش می‌دهد. بنابراین از no-preference-theme.auto.conf برای تعیین رنگ‌های حالت روشن در GNOME استفاده کنید. می‌توانید حالت روشن را با دستور gsettings set org.gnome.desktop.interface color-scheme prefer-light به صورت دستی فعال کنید؛ در این حالت GNOME طرح رنگ را به عنوان light گزارش می‌دهد و kitty از light-theme.auto.conf استفاده خواهد کرد.

استفاده از تم‌های سفارشی (USING YOUR OWN THEMES)

همچنین می‌توانید تم‌های خود را به صورت فایل‌های .conf بسازید. آن‌ها را در زیردایرکتوری themes از دایرکتوری پیکربندی kitty <#confloc> قرار دهید، که معمولاً مسیر آن ~/.config/kitty/themes است. کیتن به‌طور خودکار آن‌ها را به فهرست تم‌ها می‌افزاید. می‌توانید با نام‌گذاری فایل conf به صورت Some theme name.conf، تم داخلیِ هم‌نام با آن را بازنویسی و اصلاح کنید. در اینجا Some theme name نام واقعی تم داخلی است، نه نام فایل آن. توجه داشته باشید که پس از انجام این کار، باید یک بار کیتن را اجرا کرده و آن تم را انتخاب کنید تا تغییرات اعمال شوند.

مشارکت در تم‌های جدید (CONTRIBUTING NEW THEMES)

اگر مایل به ارسال تم جدیدی به مخزن تم‌های kitty هستید، با مراجعه به مخزن kitty-themes https://github.com/kovidgoyal/kitty-themes شروع کنید. از آن یک انشعاب (Fork) تهیه کنید https://docs.github.com/en/get-started/quickstart/fork-a-repo، و هنگام ساخت تم خود از فایل template.conf به عنوان الگو استفاده کنید. هنگامی که از ظاهر آن رضایت داشتید، یک درخواست ادغام (pull request) ثبت کنید https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request تا تم شما در مخزن kitty-themes https://github.com/kovidgoyal/kitty-themes ادغام شده و به‌طور خودکار در این کیتن در دسترس قرار گیرد.

تغییر تم به‌صورت غیرتعاملی (CHANGING THE THEME NON-INTERACTIVELY)

می‌توانید نام تم را هنگام فراخوانی کیتن به عنوان یک آرگومان مشخص کنید تا فوراً به آن تم تغییر یابد. برای مثال:

kitten themes --reload-in=all Dimmed Monokai

تم را در تمام نمونه‌های در حال اجرای kitty به Dimmed Monokai تغییر خواهد داد. برای جزئیات بیشتر درباره عملکرد غیرتعاملی به ادامه متن مراجعه کنید.

کد منبع تم‌ها (SOURCE CODE FOR THEMES)

کد منبع این کیتن در GitHub https://github.com/kovidgoyal/kitty/tree/master/kittens/themes در دسترس است.

رابط خط فرمان (COMMAND LINE INTERFACE)

kitten themes [options] [theme name to switch to]

تم kitty را تغییر می‌دهد. اگر نام تمی ارائه نشود، به‌صورت تعاملی اجرا می‌شود؛ در غیر این صورت تم فعلی را به نام تم مشخص‌شده تغییر می‌دهد.

گزینه‌ها (OPTIONS)

--cache-age <CACHE_AGE>: بررسی برای تم‌های جدید تنها پس از تعداد روزهای مشخص‌شده صورت می‌گیرد. مقدار صفر همیشه تم‌های جدید را بررسی می‌کند. مقدار منفی هرگز تم‌های جدید را بررسی نخواهد کرد و در صورتی که نسخه محلی تم‌ها موجود نباشد، خطا صادر می‌کند. پیش‌فرض: 1

--reload-in <RELOAD_IN>: به‌طور پیش‌فرض، این کیتن پس از اعمال تغییرات، تنها به نمونه والد kitty که درون آن اجرا می‌شود سیگنال می‌دهد تا پیکربندی خود را دوباره بارگذاری کند. از این گزینه استفاده کنید تا پیکربندی اصلاً بارگذاری مجدد نشود یا در تمامی نمونه‌های در حال اجرای kitty بارگذاری شود. توجه داشته باشید که اگر بارگذاری خودکار پیکربندی در kitty.conf فعال باشد (به‌طور پیش‌فرض فعال است)، گزینه parent با all یکسان خواهد بود، زیرا تمامی نمونه‌های kitty تغییرات فایل پیکربندی را شناسایی کرده و خودبه‌خود آن را دوباره بارگذاری می‌کنند. پیش‌فرض: parent انتخاب‌ها: all، none، parent

--dump-theme [=no]: هنگام اجرای غیرتعاملی، تم مشخص‌شده را به جای تغییر در kitty.conf، در STDOUT تخلیه می‌کند. پیش‌فرض: false

--config-file-name <CONFIG_FILE_NAME>: نام یا مسیر فایل پیکربندی برای ویرایش. مسیرهای نسبی با توجه به دایرکتوری پیکربندی kitty تفسیر می‌شوند. به‌طور پیش‌فرض فایل پیکربندی kitty یعنی kitty.conf ویرایش می‌شود. این گزینه زمانی بیشترین کاربرد را دارد که include themes.conf را به kitty.conf خود افزوده و بخواهید کیتن فقط روی themes.conf عملیات انجام دهد تا kitty.conf بدون تغییر باقی بماند. پیش‌فرض: kitty.conf

نویسندگان (AUTHORS)

Kovid Goyal

کپی‌رایت و تکثیر (COPYRIGHT)

2026, Kovid Goyal