Sådan laver du dit eget tema

Du kan tilføje dine egne temaer i ~/.config/omarchy/themes. Kopiér blot et af de eksisterende som udgangspunkt (se i /usr/share/omarchy/themes), og tilpas det efter behag. Så længe dit tema ligger i den mappe, bliver det vist i menuen til valg af tema.

Den vigtigste fil, du skal tilpasse, er colors.toml. Den definerer det farvesæt, der derefter bruges til at generere konfigurationer til terminalen (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian og hele Omarchy-skallen (toplinje, menu, notifikationer, OSD og låseskærm).

Du kan også bruge det medfølgende Aether-program til at oprette et nyt tema via en lækker grafisk brugerflade, hvor du kan eksperimentere med farver og søge efter baggrunde. Start det blot fra programmenuen med Super + Alt + Space.

Hvad et installeret tema kan indeholde #

Et tema, du selv skriver i ~/.config/omarchy/themes, kan indeholde lige, hvad du ønsker — det er din maskine og din fil, og Omarchy anvender det hele.

Et tema, du installerer fra en andens repository med omarchy theme install, beholder alt, der har med farver at gøre, men mister de få filer, som ville køre kode på din maskine: enhver .lua-fil, terminalkonfigurationerne (alacritty.toml, foot.ini, ghostty.conf, kitty.conf) og vscode.json. Et temas hyprland.lua er Lua-kode, som din compositor kører ved login, en terminalkonfiguration angiver det program, din terminal starter, og vscode.json angiver en VSCode-udvidelse, der skal installeres. Når du installerer en andens tema, bør det ændre, hvordan dit skrivebord ser ud, aldrig hvad det kører.

Alt andet fungerer fortsat præcis, som temaets forfatter har skrevet det — btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, baggrundene og forhåndsvisningerne bevares alle. Kun det, der blev fjernet, bliver genereret igen ud fra colors.toml på din maskine.

Omarchy skelner mellem de to ud fra, om temaet har sit eget git-repository indeni, hvilket er det, omarchy theme install efterlader, når det kloner. Et tema, du selv har skrevet, forbliver derfor dit, mens et, du har hentet fra internettet, begrænses til farver.

Lys tilstand #

Hvis du laver et tema til lys tilstand, skal du angive mode = "light" øverst i din colors.toml. Så bliver det automatisk kombineret med lys tilstand i alle programmerne. (Den gamle metode, hvor du placerer en tom fil med navnet light.mode i roden af dit tema, virker også stadig.)

Ikonfarver #

Hvis du vil matche filhåndteringens ikonfarver med dit tema, skal du tilføje en fil med navnet icons.theme, som indeholder navnet på det ikonsæt, du vil bruge. Som standard er mulighederne: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.

Oplåsningsbillede #

Temaer, der leveres med billederne unlock.png og preview-unlock.png, vises under Stil > Lås op. Din unlock.png bør helst være en gennemsigtig PNG-fil. Du kan oprette forhåndsvisningsbilledet med omarchy plymouth preview.

Tilpas temaet i programmer, som Omarchy ikke dækker #

Hvis du bruger et program, der ikke står på listen, kan du selv lære Omarchy at tilpasse det med en skabelon. Placér en fil i ~/.config/omarchy/themed/, navngivet efter den konfiguration, den genererer, plus filendelsen .tpl, og skriv konfigurationen med {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} til og med {{ color15 }} samt resten af paletten som pladsholdere. Hver gang du skifter tema, genereres filen igen med temaets farver.

Der ligger en fuldt kommenteret alacritty.toml.tpl.sample i mappen, som du kan tage udgangspunkt i — den viser alle de variabler, du kan bruge, samt modifikatorerne _strip og _rgb til programmer, der skal bruge farverne uden # eller som decimale RGB-værdier. Dine skabeloner har højere prioritet end Omarchys egne, så du kan også bruge dette til at tilsidesætte, hvordan et indbygget program får tilpasset sit tema.

Distribution af dit tema #

Hvis du vil distribuere dit tema, så andre kan bruge det, skal du lægge det på en offentlig git-server såsom GitHub. Derefter kan andre installere det via Installér > Stil > Tema i Omarchy-menuen ved at bruge URL'en. Det anbefales, at du følger navngivningskonventionen omarchy-[themename]-theme, da temaet så vises korrekt som blot [themename] i menuen til valg af tema efter installationen.

Den resterende del, [themename], bliver temaets mappenavn, så det skal være et navn, Omarchy kan håndtere sikkert: Det skal begynde med et bogstav, et tal eller en understregning, og resten må indeholde bogstaver, tal, ., _, + og -. Store bogstaver konverteres automatisk til små, men alt andet — et mellemrum, et anførselstegn eller et ikke-engelsk tegn — afvises under installationen i stedet for at blive omdannet til et mappenavn. Derfor kan omarchy-tokyo-night-theme, omarchy-flexoki_light-theme og omarchy-c++-theme alle installeres uden problemer.

Husk, at når temaet først er installeret fra et repository, fjernes eventuelle .lua-filer, terminalkonfigurationer og vscode.json, som følger med, så byg ikke temaet op omkring dem.

Du kan få dit tema føjet til siden med ekstra temaer ved at sende en pull request til omarchy-site-repositoriet.