Приручник
Прављење сопствене теме
Можете да додате сопствене теме у ~/.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 репозиторијум.