Preskočite na sadržaj
Chapters
  1. Dobrodošli u Omarchy!
  2. Početak rada
  3. Dolazak s Maca ili Windowsa
  4. Navigacija
  5. Gornja traka
  6. Teme
  7. Tipkovničke prečice
  8. Ujednačeni međuspremnik i povijest
  9. Podsjetnici
  10. Obavijesti
  11. Izdvajanje teksta i diktiranje
  12. Snimke zaslona i snimanje
  13. Preklopnici, mirovanje i čuvar zaslona
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Razvojni alati
  19. Alati ljuske
  20. Funkcije ljuske
  21. TUIs
  22. Grafičke aplikacije
  23. Preglednici
  24. Komercijalne aplikacije/usluge
  25. Web-aplikacije
  26. Gaming
  27. Ispunjavanje PDF-ova
  28. Windows VM
  29. Ostali paketi
  30. Ažuriranja
  31. Dotfiles
  32. Dodaci ljuske
  33. Monitori
  34. Tipkovnica, miš, dodirna pločica
  35. Umrežavanje
  36. Spavanje sustava
  37. Hardverska autentifikacija
  38. Fontovi
  39. Pozadine
  40. Prompt
  41. Brendiranje
  42. Uobičajene prilagodbe
  43. Izrada vlastite teme
  44. Podrška za Mac
  45. Rješavanje problema
  46. Često postavljana pitanja
  47. Snimke sustava
  48. Sigurnost
  49. Omarchy na...
  50. Instalacija s dvostrukim pokretanjem
  51. Instalacije bez nadzora

Priručnik

Razvojni alati

Alternativni uređivači

Omarchy prema zadanim postavkama dolazi s Neovimom, ali ako želite nešto malo raširenije i poznatije, možete pokrenuti Omarchy Menu (Super + Space) i pogledati mogućnosti pod Install > Editor. Tamo su navedeni VSCode, Cursor, Zed, Sublime Text, Helix, Vim i Emacs. Ako ne pronađete ono što tražite, pogledajte Install > Package i provjerite nije li to u nekom Arch paketu (a ako nije, pokušajte s Install > AUR kako biste provjerili AUR).

Izvorni uređivač vi također je dostupan odmah po instalaciji. Pokrenite vi filename kako biste uredili datoteku u terminalu.

Usklađivanje tema nudi se za VSCode, Cursor, VSCodium i Helix.

Zadani uređivač za cijeli sustav možete postaviti pod Setup > Defaults > Editor.

Razvojna okruženja

Omarchy podržava postavljanje cijelog niza razvojnih okruženja putem odjeljka Install > Development u Omarchy Menuu (Super + Space). Ondje ćete, naravno, pronaći Ruby on Rails, ali i sva tri glavna izvršna okruženja za JavaScript (Node.js, Bun, Deno), kao i popularne PHP okvire poput Laravela i Symfonyja. Oh, tu su i Go, Rust, Python, Java, Elixir (s Phoenixom), .NET, OCaml, Zig, Clojure i Scala. Izbor je doista vrlo širok!

Većinom tih okruženja upravlja Mise. To je alat koji vam omogućuje instaliranje i pokretanje više verzija programskog jezika na istom računalu. Sličan je alatima rbenv ili rvm za Ruby ili virtualenv za Python, ali radi s nizom različitih okruženja.

Kako biste instalirali, recimo, Ruby, pokrenuli biste mise use -g ruby, čime ćete Ruby i instalirati i postaviti kao globalnu zadanu verziju. Ili, ako vaš projekt ima datoteku .ruby-version, možete jednostavno pokrenuti mise i u korijenu tog projekta.

Unaprijed instalirani CLI alati

Omarchy alate kao što su gh, uv i većinu agenata za programiranje čini dostupnima putem miseove lijene instalacije. Kada neki od njih pokrenete prvi put, mise će ga instalirati. Kasnija pokretanja upotrebljavaju instaliranu verziju; ne provjeravaju postoji li ažuriranje pri svakom pokretanju.

Zadane alate možete i pregledati ili ih instalirati unaprijed:

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

Pokrenite omarchy update kako biste instalirane alate ažurirali zajedno s ostatkom Omarchyja. Alias mup ažurira samo alate kojima upravlja mise. Kako biste u vlastitu konfiguraciju dodali još jedan alat, upotrijebite mise use -g <tool>.

Postavljanje Pythona putem misea instalira i uv. Uklanjanje razvojnog okruženja za Python ostavlja uv dostupan kao neovisan alat.

Korištenje vlastite instalacije

miseove naredbe dolaze prije ~/.local/bin na PATH, pa će alat koji ste sami instalirali, primjerice vlastitim instalacijskim programom Claude Codea ili Cursora, i dalje pokretati miseovu kopiju. Aplikacije pokrenute s radne površine također pronalaze miseove naredbe prije paketa sustava, pa aplikacija koja pokrene gh dobiva miseovu kopiju čak i ako ste github-cli instalirali pacmanom, a mise tu kopiju instalira pri prvom pokretanju. Kako biste umjesto toga koristili svoju, onemogućite miseovu kopiju u ~/.config/mise/config.toml. Primjerice, ako ste sami instalirali Cursor CLI:

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

Ako već imate tablicu [settings], unos dodajte ondje; proširite postojeći popis disable_tools, a nemojte ga zamijeniti. Pobrinite se da je vaša instalacija na PATH. Upotrijebite naziv mise alata, koji se može razlikovati od njegove naredbe: oh-my-pi, primjerice, pruža omp. Pokretač zadanog agenta također daje prednost Cursoru ili Claude Codeu koje je korisnik instalirao u ~/.local/bin.

Uklanjanje i vraćanje zadanih alata

Remove Preinstalls čini da mise za vašeg korisnika preskoči Omarchyjeve deklaracije alata tako da ih doda u ignored_config_paths u ~/.config/mise/miserc.toml. Restore Preinstalls ponovno uklanja taj redak. Alati koje sami deklarirate, u vlastitoj konfiguraciji ili u projektnoj datoteci mise.toml, u oba slučaja nastavljaju raditi. Ako nakon uklanjanja unaprijed instaliranih alata odaberete zadanog agenta ili postavite Python, taj će se alat dodati u vašu vlastitu konfiguraciju. Oboje se primjenjuje samo na vašeg korisnika; ostali korisnici na računalu zadržavaju vlastiti izbor.

Docker

Docker gotovo da i ne treba predstavljati. Omogućuje vam pokretanje izoliranih spremnika, a Omarchy instalira sve što je potrebno za njegov dobar rad, uključujući sam Docker i Docker Compose.

Prema zadanim postavkama vaš korisnik nije u grupi docker. Ta je grupa zapravo root bez lozinke - sve u njoj može pokrenuti docker run -v /:/host i preuzeti računalo - pa bi jedan jedini zlonamjerni skript ili ovisnost pokrenuta pod vašim korisnikom inače bio na samo jednu naredbu od roota. Zato Docker na naredbenom retku pokrećete sa sudo (sudo docker ps, sudo docker compose up), a grafički alati koji komuniciraju s pozadinskim procesom - Windows VM - traže autorizaciju kada im je potrebna. Ako želite natrag praktičnost postavljanja bez grupe i razumijete kompromis, omogućite ga putem Setup > Security > Sudoless Docker (ili pokrenite omarchy-setup-security-sudoless-docker), čime ćete nakon upozorenja biti dodani u grupu docker; tada obični docker i alias d ponovno rade bez sudo.

Uobičajene baze podataka za lokalni razvoj u Dockeru možete postaviti putem Install > Development > Docker DB u Omarchy izborniku.

GitHub CLI

GitHub CLI dostupan je kao gh za rad s repozitorijima, problemima i zahtjevima za povlačenje iz terminala. Pokrenite gh auth login kako biste ga instalirali pri prvoj upotrebi i autentificirali se, zatim gh repo clone org/repo kako biste klonirali repozitorij. Pokrenite gh --help kako biste istražili njegove naredbe.

Za terminalsko sučelje za zahtjeve za povlačenje pokrenite ghui; mise ga također instalira pri prvoj upotrebi. Lazygit unaprijed je instaliran za rad sa samim Gitom.