Kézikönyv
Dotfile-ok
Az Omarchyt elsődlegesen az úgynevezett dotfile-okból konfigurálod, amelyek a ~/.config mappában élnek. Ezek a saját módosításaidhoz a saját fájljaidnak tekintendők. A /usr/share/omarchy mappában élő fájlok magához az Omarchyhoz tartoznak, és nem kellene belekotnod. Ha bármit módosítani szeretnél a /usr/share/omarchy mappában, helyette a ~/.config mappában lévő értéket kell felülírnia.
A legfontosabb konfigurációk közvetlenül az Omarchy menüből (Super + Space) szerkeszthetők, mint például Setup > Monitors, Setup > Keybindings, Setup > Input és Setup > Config > [file]. Amikor így szerkesztesz, minden folyamat, amelynek a konfiguráció módosítása után szüksége van az újraindításra, automatikusan újraindul, miután kilépsz a szerkesztőből (alapértelmezetten a Neovim - :wq, emlékszel! - , de ezt a Setup > Defaults > Editor pontban módosíthatod).
Íme a legfontosabb fájlok listája a ~/.config mappában és az, amiket vezérelnek:
| Fájl | Cél |
|---|---|
~/.config/hypr/hyprland.lua |
A fő Hyprland-konfiguráció. Betölti az Omarchy alapértelmezéseit és a saját felülíró fájljaidat. Tudjon meg többet a Hyprland-konfigurációkról. |
~/.config/hypr/bindings.lua |
A saját billentyűkiosztásaid és az alapértelmezéseket felülíró kiosztások. |
~/.config/hypr/monitors.lua |
A monitorokat, a felbontást és a pozíciót vezérli. |
~/.config/hypr/input.lua |
A billentyűzetkiosztást, az egeret és az érintőpad beállításait vezérli. |
~/.config/hypr/looknfeel.lua |
A térközöket, a szegélyeket, az animációkat és a megjelenés többi részét vezérli. |
~/.config/hypr/autostart.lua |
A munkamenettel együtt indított extra folyamatokat vezérli. |
~/.config/omarchy/shell.json |
Az Omarchy shellt vezérli: a sáv helyzetét, elrendezését és moduljait, valamint a képernyővédő, a zárolás és az üresjárat időzítését. |
~/.config/foot/foot.ini |
A terminálodat vezérli (a Foot az alapértelmezett). |
~/.XCompose |
Definiálja a gyorselérésű emojidat és a név/e-mail automatikus kiegészítésedet. Gondoskodj arról, hogy a módosítások után futtatod az omarchy-restart-xcompose parancsot. |
Ha végül sok módosítást végezsz a saját beállításaidon, jó ötlet biztonsági másolatot készíteni az összes dotfile-ról. A Stow nagyszerű módja ennek.
Saját alkalmazások indítása a munkamenettel
Ha valami minden bejelentkezéskor futni szeretnél - egy szinkronizációs folyamatot, egy csevegőalkalmazást, a saját parancsszkriptedet - tedd a ~/.config/hypr/autostart.lua fájlba:
o.launch_on_start("my-service")
Ez a parancsot a munkamenet részeként indítja, így megfelelően tisztánlódik, amikor ismét kijelentkezel.
Szkriptek futtatása rendszereseményekhez
Az Omarchy néhány pillanatban hookokat lő ki, és saját szkriptjeidet aggathatod rájuk. Ezek a ~/.config/omarchy/hooks/<event>.d/ helyen találhatók, egy könyvtár eseményenként, és az ott lévő minden végrehajtható fájl fut, amikor az esemény bekövetkezik:
| Esemény | Mikor fut |
|---|---|
post-boot |
Rögtön az asztal elindulása után |
post-update |
Az omarchy update vége felé, a csomagok, migrációk és szolgáltatás-újraindítások után, mielőtt a mise-eszközök frissülnének |
pre-refresh-pacman |
Miután az omarchy refresh pacman újraszinkronizálja a csomagkonfigurációt, mielőtt a csomagokat frissítené; egy csatornaváltás ugyanabban a frissítési lépésben futtatja |
theme-set |
Egy témaváltás után (a téma neve a $1-ben) |
font-set |
Betűtípus-váltás után (a betűtípus neve a $1-ben) |
battery-low |
Amikor az akkumulátor alacsonnyá válik (a százalék a $1-ben) |
A pre-refresh-pacman hook az, ahová az egyéni tárolók vagy az IgnorePkg-sorok tartoznak, mivel a csomagtranzakció előtt fut. Mindkét frissítéssel kapcsolatos hook a felhasználód nevében fut, miután az Omarchy törli a tárolt sudo-engedélyét, így egy olyan hooknak, amelyik sudo-t használ, saját engedélyre van szüksége, és kérheti a jelszavadat.
Ezen könyvtárak mindegyike már tartalmaz egy .sample fájlt, amely bemutatja, hogy milyen formaú egy hook - távolítsd el a .sample részt a névből, hogy használatba vedd. Egy máshol megírt szkript telepítéséhez használd az omarchy hook install post-boot ~/my-hook parancsot, amely indítási végrehajtási engedélyt állít be.
Saját menüelemek hozzáadása
Az Omarchy menü (Super + Space) kiterjeszthető a saját soraival a ~/.config/omarchy/extensions/omarchy-menu.jsonc szerkesztésével. A bejegyzések pontozott azonosítóval vannak felvéve, és az azonosító az, ami elhelyezi őket a fában, így a personal megjelenhet a gyökérmenüben, a personal.notes pedig azon belül jelenhet meg:
"personal": {"icon":"","label":"Personal"},
"personal.notes": {"icon":"","label":"Notes","action":"omarchy-launch-editor ~/notes"},
Ha meglévő azonosítót használsz újra, azt a sort váltod fel, ahelyett, hogy újat adnál hozzá. A fájl az összes elérhető mezőt megjegyzésekként dokumentálva érkezik.
Saját shell-eksportok, függvények és aliaszok hozzáadása
Az Omarchy egy sor ergonómiai aliást és hasznos funkciót szállít, de gyakori, hogy sajátokat akarsz hozzáadni. Mind az aliasokat, funkciókat, mind az exportokat a ~/.bashrc fájlba kell tenned. Ez a fájl nem íródik felül frissítéseken. Ha az Omarchy alapértelmezéseiből bármit meg szeretnél változtatni, itt is biztonságosan hozzáadhatod őket.
Belső Omarchy-fájlok módosítása
Nézzük, ez az ön számítógépe. Bármit megtehet vele, de azt javaslom, ne módosítsd közvetlenül a /usr/share/omarchy mappában lévő fájlokat. Az Omarchy pacman-csomagjához tartoznak, így a módosításaidat egyszerűen felülírja a következő frissítés. Jobban jársz, ha a ~/.config/* mappában írsz felül minden alapértelmezett értéket, amit nem szeretsz.
Szinte mindent megváltoztathatsz így, például az alapértelmezett billentyűkiosztásokat. Csak szerkeszd a ~/.config/hypr/bindings.lua fájlt, hogy például az Obsidiant a Joplinnal helyettesítsd (telepítse az omarchy-pkg-add joplin-bin paranccsal):
o.rebind("SUPER + SHIFT + O", "Joplin", "joplin-desktop")
Az o.rebind eltávolítja a meglévő kötést, mielőtt hozzáadná a helyettesítőjét. Ugyanazokat az argumentumokat veszi át, mint az o.bind, beleértve az indító segítőket és a kapcsolási beállításokat is. Használd az o.bind parancsot egy kötés hozzáadásához, vagy a hl.unbind parancsot, ha csak meg akarod szüntetni a helyettesítő beállítása nélkül.
Ha ragaszkodsz a belső Omarchy-fájlok feltöréséhez, válts a dev csatornára az Update > Channel > Dev ponton keresztül. Ez az Omarchyt a forráskód egy git-checkoutjához köti a ~/omarchy helyén, és szabadon megváltoztathatod a lelked szerint. Senki sem mondja meg, mit csinálj!
Módosítások visszaállítása
Ha végül összezavarod a konfigurációkat, mindig visszaállíthatod azokat az alapértelmezésekre az Omarchy menüben lévő Update > Config ponton keresztül. Vagy az omarchy reinstall configs parancs futtatásával minden visszaállítására.