Ръководство
Създаване на собствена тема
Можете да добавяте собствените си теми в ~/.config/omarchy/themes. Просто копирайте една от съществуващите като основа (вижте в /usr/share/omarchy/themes), след това я променете както ви харесва. Стига темата ви да е в тази папка, тя ще бъде включена в менюто за избор на тема.
Основният файл, който трябва да промените, е colors.toml. Той определя набора от цветове, който след това се използва за генериране на конфигурации за терминала (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian и цялата обвивка на Omarchy (горната лента, менюто, известията, OSD и заключения екран).
Можете също да използвате включеното приложение Aether, за да създадете нова тема чрез приятен GUI интерфейс, в който да си играете с цветовете и да търсите фонове. Просто го стартирайте от мрежата с приложения със Super + Alt + Space.
Какво може да съдържа една инсталирана тема
Тема, която напишете сами в ~/.config/omarchy/themes, може да съдържа каквото пожелаете - това е вашата машина и вашият файл, и Omarchy прилага всичко от нея.
Тема, която инсталирате от чуждо хранилище с omarchy theme install, запазва всичко, което е цвят, и губи шепата файлове, които биха изпълнили код на вашата машина: всеки .lua файл, конфигурациите на терминала (alacritty.toml, foot.ini, ghostty.conf, kitty.conf) и vscode.json. hyprland.lua на дадена тема е Lua, който вашият композитор изпълнява при влизане, конфигурацията на терминала посочва програмата, която терминалът ви стартира, а vscode.json посочва разширение на VSCode за инсталиране. Инсталирането на чужда тема трябва да променя как изглежда работният ви плот, никога какво изпълнява той.
Всичко останало продължава да работи точно както авторът на темата го е написал - btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, фоновете и предварителните прегледи се запазват всички. Само изхвърленото се генерира отново от colors.toml на вашата машина.
Omarchy различава двете по това дали темата има собствено git хранилище в себе си, което е това, което omarchy theme install оставя след себе си, когато клонира. Така тема, която сте написали, си остава ваша, а такава, която сте изтеглили от интернет, си остава цветове.
Светъл режим
Ако правите тема със светъл режим, задайте mode = "light" в началото на вашия colors.toml. Тогава тя автоматично ще бъде съчетана със светъл режим за всички приложения. (Старият начин с пускане на празен файл, наречен light.mode, в корена на темата ви, също все още работи.)
Цветове на иконите
Ако искате иконите на файловия мениджър да съответстват по цвят на темата ви, добавете файл, наречен icons.theme, с името на набора от икони, който искате да използвате. По подразбиране опциите са: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.
Изображение за отключване
Темите, предоставени с изображения unlock.png и preview-unlock.png, ще бъдат изброени под Външен вид > Отключване. Вашият unlock.png за предпочитане трябва да бъде прозрачен png. А изображението за предварителен преглед можете да създадете с omarchy plymouth preview.
Тематизиране на приложения, които Omarchy не покрива
Ако използвате приложение, което го няма в този списък, можете сами да научите Omarchy да го тематизира с шаблон. Пуснете файл в ~/.config/omarchy/themed/, наречен на конфигурацията, която генерира, плюс разширение .tpl, и напишете конфигурацията с {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} до {{ color15 }} и останалата част от палитрата като заместители. Всеки път, когато сменяте темите, файлът се генерира отново с цветовете на тази тема.
В тази папка има напълно коментиран alacritty.toml.tpl.sample, от който да копирате - той изброява всяка променлива, която можете да използвате, плюс модификаторите _strip и _rgb за приложения, които искат цветовете си без # или като десетичен RGB. Вашите шаблони имат предимство пред собствените на Omarchy, така че можете да използвате това и за да замените начина, по който се тематизира вградено приложение.
Разпространение на вашата тема
Ако искате да разпространявате темата си, за да могат други хора да я използват, трябва да я поставите на публичен git сървър, като GitHub. След това хората могат да я инсталират чрез Инсталиране > Стил > Тема в менюто на Omarchy, като използват този URL. Препоръчително е да следвате конвенцията за именуване omarchy-[themename]-theme, тъй като темата ще се показва правилно само като [themename] в менюто за избор на тема след инсталирането.
Това останало [themename] става име на директорията на темата, така че трябва да бъде такова, което Omarchy може безопасно да предава наоколо: трябва да започва с буква, цифра или долна черта, а останалата част може да съдържа букви, цифри, ., _, + и -. Главните букви се превръщат в малки вместо вас, но всичко останало - интервал, кавичка, неанглийски знак - се отказва по време на инсталиране, вместо да се превръща в име на директория. Така omarchy-tokyo-night-theme, omarchy-flexoki_light-theme и omarchy-c++-theme се инсталират без проблеми.
Не забравяйте, че щом бъде инсталирана от хранилище, всеки .lua, конфигурация на терминал или vscode.json, който доставя, се изхвърля, така че не изграждайте темата около тях.
Можете да добавите темата си към страницата с допълнителни теми, като изпратите pull request към хранилището omarchy-site.