Ugrás a tartalomra
Chapters
  1. Üdv az Omarchyban!
  2. Első lépések
  3. Ha Macről vagy Windowsról jössz
  4. Navigáció
  5. A felső sáv
  6. Témák
  7. Gyorsbillentyűk
  8. Egységes vágólap és előzmények
  9. Emlékeztetők
  10. Értesítések
  11. Szövegkinyerés és diktálás
  12. Képernyőképek és rögzítés
  13. Kapcsolók, tétlenség és a képernyővédő
  14. Omarchy CLI
  15. Terminál
  16. Neovim
  17. AI
  18. Fejlesztői eszközök
  19. Shell-eszközök
  20. Shell-funkciók
  21. TUIs
  22. GUI-k
  23. Böngészők
  24. Kereskedelmi alkalmazások/szolgáltatások
  25. Webalkalmazások
  26. Játékok
  27. PDF-ek kitöltése
  28. Windows VM
  29. Egyéb csomagok
  30. Frissítések
  31. Dotfile-ok
  32. Shell-bővítmények
  33. Monitorok
  34. Billentyűzet, egér, érintőpad
  35. Hálózat
  36. Rendszeralvás
  37. Hardveres hitelesítés
  38. Betűtípusok
  39. Hátterek
  40. Prompt
  41. Arculat
  42. Gyakori finomhangolások
  43. Saját téma készítése
  44. Mac-támogatás
  45. Hibaelhárítás
  46. GYIK
  47. Rendszer-pillanatképek
  48. Biztonság
  49. Omarchy ezen: ...
  50. Telepítés kettős rendszerindítással
  51. Felügyelet nélküli telepítések

Kézikönyv

Fejlesztői eszközök

Alternatív szerkesztők

Az Omarchy alapértelmezetten a Neovim szerkesztővel érkezik, de ha valami elterjedtebbre és ismerősebbre vágysz, indítsd el az Omarchy Menu menüt (Super + Space), és nézd meg a lehetőségeket a Telepítés > Szerkesztő alatt. Ott szerepel a VSCode, a Cursor, a Zed, a Sublime Text, a Helix, a Vim és az Emacs. Ha nem találod, amit keresel, nézd meg a Telepítés > Csomag menüpontot, és ellenőrizd, nincs-e benne egy Arch-csomagban (ha pedig nincs, próbáld ki a Telepítés > AUR lehetőséget az AUR ellenőrzéséhez).

Az eredeti vi szerkesztő is azonnal használható. Fájl terminálban történő szerkesztéséhez futtasd a vi filename parancsot.

Témához illesztés érhető el a VSCode, a Cursor, a VSCodium és a Helix esetében.

A rendszer szintű alapértelmezett szerkesztőt a Beállítás > Alapértelmezések > Szerkesztő alatt állíthatod be.

Környezet

Az Omarchy rengeteg fejlesztői környezet beállítását támogatja az Omarchy Menu (Super + Space) Telepítés > Fejlesztés szakaszán keresztül. Természetesen megtalálod ott a Ruby on Rails keretrendszert, de a JavaScript három fő futtatókörnyezetét (Node.js, Bun, Deno) is, valamint népszerű PHP-keretrendszereket, például a Laravelt és a Symfonyt. Ja, és van Go, Rust, Python, Java, Elixir (Phoenixszel), .NET, OCaml, Zig, Clojure és Scala is. Ez egy nagyon széles választék!

Ezeknek a környezeteknek a többségét a Mise kezeli. Ez egy olyan eszköz, amellyel egy programozási nyelv több verzióját telepítheted és futtathatod ugyanazon a gépen. Olyan, mint az rbenv vagy az rvm Rubyhoz, vagy a virtualenv Pythonhoz, de egy csomó különböző környezettel működik.

Ha például Rubyt szeretnél telepíteni, futtasd a mise use -g ruby parancsot, amely telepíti a Rubyt, és beállítja globális alapértelmezettként. Ha pedig a projektedben van egy .ruby-version fájl, egyszerűen futtathatod a mise i parancsot annak a projektnek a gyökerében.

Előre telepített CLI-eszközök

Az Omarchy olyan eszközöket tesz elérhetővé, mint a gh, az uv és a legtöbb kódolóügynök, a mise lusta telepítésén keresztül. Amikor először futtatsz egyet, a mise telepíti. A későbbi futtatások a telepített verziót használják újra; nem ellenőriznek frissítést minden indításkor.

Megnézheted az alapértelmezéseket is, vagy előre telepítheted őket:

mise ls --current              # List the tools configured for this directory
mise install gh               # Install one tool now
mise install --include-lazy    # Install all configured tools, including lazy tools

Futtasd az omarchy update parancsot a telepített eszközök frissítéséhez az Omarchy többi részével együtt. A mup alias csak a mise által kezelt eszközöket frissíti. Ha egy másik eszközt szeretnél hozzáadni a saját konfigurációdhoz, használd a mise use -g <tool> parancsot.

A Python beállítása az uv eszközt is telepíti a mise segítségével. A Python fejlesztői környezet eltávolítása után az uv független eszközként továbbra is elérhető marad.

Saját telepítés használata

A mise parancsai a ~/.local/bin előtt szerepelnek a PATH változóban, ezért egy saját magad által telepített eszköz, például a Claude Code vagy a Cursor saját telepítőjével, továbbra is a mise példányát futtatja. Az asztalról indított alkalmazások is a rendszer csomagjai előtt találják meg a mise parancsait, így egy alkalmazás, amely a gh parancsot futtatja, a mise példányát kapja meg akkor is, ha a github-cli csomagot a pacman segítségével telepítetted, és a mise az első alkalommal telepíti azt a példányt. Ha helyette a sajátodat szeretnéd használni, tiltsd le a mise példányát a ~/.config/mise/config.toml fájlban. Ha például a Cursor CLI-t magad telepítetted:

[settings]
disable_tools = ["cursor-agent"]

Ha már van [settings] táblád, oda add hozzá a bejegyzést; egy meglévő disable_tools listát bővíts, ne cseréld le. Győződj meg róla, hogy a telepítésed szerepel a PATH változóban. A mise eszköznevét használd, amely eltérhet a parancsától: az oh-my-pi például az omp parancsot biztosítja. Az alapértelmezett ügynökindító szintén előnyben részesíti a felhasználó által a ~/.local/bin könyvtárba telepített Cursort vagy Muse-ot.

Az alapértelmezések eltávolítása és visszaállítása

Az Előre telepítettek eltávolítása hatására a mise kihagyja az Omarchy eszközdeklarációit a felhasználódnál azáltal, hogy hozzáadja őket az ignored_config_paths beállításhoz a ~/.config/mise/miserc.toml fájlban. Az Előre telepítettek visszaállítása ismét eltávolítja ezt a sort. Az általad deklarált eszközök, a saját konfigurációdban vagy egy projekt mise.toml fájljában, mindkét esetben tovább működnek. Ha az előre telepítettek eltávolítása után választasz alapértelmezett ügynököt vagy beállítod a Pythont, az eszköz bekerül a saját konfigurációdba. Mindkettő csak a te felhasználódra vonatkozik; a gép többi felhasználója megtartja a saját választását.

Docker

A Docker aligha szorul bemutatásra. Lehetővé teszi elszigetelt konténerek futtatását, és az Omarchy mindent telepít, ami a megfelelő működéséhez szükséges, beleértve magát a Dockert és a Docker Compose eszközt is.

Alapértelmezetten a felhasználód nem tagja a docker csoportnak. Ez a csoport gyakorlatilag jelszó nélküli root hozzáférést jelent - minden, ami tagja, futtathatja a docker run -v /:/host parancsot, és átveheti az irányítást a gép felett - , így egyetlen, a nevedben futó rosszindulatú szkript vagy függőség egyébként egyetlen parancsra lenne a root hozzáféréstől. Ezért a parancssorban a Dockert sudo segítségével futtatod (sudo docker ps, sudo docker compose up), a démonnal kommunikáló grafikus eszközök - a Windows VM - pedig engedélyt kérnek, amikor szükségük van rá. Ha vissza szeretnéd kapni a csoport nélküli beállítás kényelmét, és érted a kompromisszumot, engedélyezd a Beállítás > Biztonság > Sudoless Docker menüpontban (vagy futtasd az omarchy-setup-security-sudoless-docker parancsot), amely egy figyelmeztetés után hozzáad a docker csoporthoz; ezután az egyszerű docker parancs és a d alias ismét sudo nélkül működik.

A helyi fejlesztéshez használt gyakori adatbázisokat Dockerben az Omarchy menü Telepítés > Fejlesztés > Docker DB menüpontjával állíthatod be.

GitHub CLI

A GitHub CLI gh néven érhető el adattárakkal, issue-kkal és pull requestekkel való munkához a terminálból. Futtasd a gh auth login parancsot az első használatkor történő telepítéshez és hitelesítéshez, majd a gh repo clone org/repo parancsot egy adattár klónozásához. Futtasd a gh --help parancsot a parancsai felfedezéséhez.

Pull requestekhez való terminálfelületért futtasd a ghui parancsot; a mise ezt is telepíti az első használatkor. A Lazygit előre telepítve érkezik a Gittel való munkához.