Az Oh My Zsh egy nyílt forráskódú, közösség által vezérelt keretrendszer a zsh konfigurációjának kezelésére.

Unalmasan hangzik. Próbáljuk meg újra.

Az Oh My Zsh nem fog téged 10x fejlesztővé tenni… de talán annak érezheted magad.

A telepítés után a terminálburok a város beszédtémája lesz, vagy visszakapod a pénzed! A parancssorod minden egyes billentyűleütésével kihasználhatod a több száz erőteljes bővítmény és gyönyörű téma előnyeit. Idegenek fognak odajönni hozzád a kávézókban, és megkérdezni: “ez elképesztő! te valami zseni vagy?”

Végre elkezded majd megkapni azt a fajta figyelmet, amiről mindig is úgy érezted, hogy megérdemled. …Vagy talán arra használod majd a megspórolt időt, hogy gyakrabban kezdj el fogselymet használni. 😬

Hogy többet megtudj, látogass el az ohmyz.sh oldalra, kövesd a @ohmyzsh-t a Twitteren, és csatlakozz hozzánk a Discordon.

Első lépések

Előfeltételek

• Egy Unix-szerű operációs rendszer: macOS, Linux, BSD. Windowson:
• A Zsh-t telepíteni kell (a v4.3.9-es vagy újabb verzió jó, de mi az 5.0.8-as vagy újabb verziót részesítjük előnyben). Ha nincs előtelepítve (futtasd zsh --version a megerősítéshez), nézd meg a következő wiki utasításokat itt: A ZSH telepítése
• curl vagy wget kell telepíteni
• git kell telepíteni (ajánlott v2.4.11 vagy újabb)

Alap telepítés

Oh My Zsh telepítése a következő parancsok egyikének futtatásával történik a terminálban. A parancssoron keresztül curl, wget vagy más hasonló eszközzel is telepítheted.

Kézi ellenőrzés

A még nem ismert projektek telepítőszkriptjét érdemes ellenőrizni. Ezt úgy tudod megtenni, hogy először letöltöd a telepítőszkriptet, átnézed, hogy minden normálisnak tűnjön,majd lefuttatod:

wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.shsh install.sh

Oh My Zsh használata

Pluginok

Az Oh My Zsh egy rakás pluginnel érkezik, amiket kihasználhatsz. Megnézheted a plugins könyvtárban és/vagy a wikiben, hogy mi érhető el jelenleg.

Plugins engedélyezése

Mihelyt kiszúrtál egy (vagy több) plugint, amit az Oh My Zsh-val szeretnél használni, engedélyezned kell őket a .zshrc fájlban. A zshrc fájlt a $HOME könyvtárban találod. Nyisd meg a kedvenc szövegszerkesztőddel, és látni fogsz egy helyet, ahol felsorolhatod a betölteni kívánt bővítményeket.

vi ~/.zshrc

Ez például így kezdődhet:

plugins=( git bundler dotenv osx rake rbenv ruby)

Figyelj arra, hogy a bővítményeket szóközökkel (szóközök, tabulátorok, új sorok…) választják el. Ne használj közöttük vesszőket, különben megszakad.

Pluginok használata

Minden plugin tartalmaz egy README-t, ami dokumentálja azt. Ennek a README-nek meg kell mutatnia az aliasokat (ha a plugin hozzáadja azokat) és az extra finomságokat, amelyeket az adott plugin tartalmaz.

Témák

Elismerjük. Az Oh My Zsh világának elején talán egy kicsit túlságosan is témaboldogok lettünk. Már több mint százötven témát csomagoltunk. A legtöbbjükről képernyőképek vannak a wikiben (Dolgozunk ennek frissítésén!). Nézd meg őket!

Téma kiválasztása

Robby témája az alapértelmezett. Nem a legcsinosabb. Nem a legegyszerűbb sem. Csak éppen a megfelelő (számára).

Ha megtaláltad azt a témát, amit használni szeretnél, szerkesztened kell a ~/.zshrc fájlt. Ott látni fogsz egy környezeti változót (csupa nagybetűvel), ami így néz ki:

ZSH_THEME="robbyrussell"

Hogy más témát használj, egyszerűen változtasd meg az értéket a kívánt téma nevére. Például:

ZSH_THEME="agnoster" # (this is one of the fancy ones)# see https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#agnoster

Figyelem: sok téma megköveteli a Powerline betűtípusok telepítését a megfelelő megjelenítéshez.

Nyiss meg egy új terminálablakot, és a promptnak valahogy így kell kinéznie:

Ha nem találtad meg a számodra megfelelő témát, nézz szét a wikiben, ahol továbbiakat találsz.

Ha bátornak érzed magad, hagyhatod, hogy a számítógép véletlenszerűen válasszon neked egyet minden alkalommal, amikor új terminálablakot nyitsz.

ZSH_THEME="random" # (...please let it be pie... please be some pie..)

És ha véletlenszerűen akarsz témát választani a kedvenc témáid listájából:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Ha csak azt tudod, hogy mely témák nem tetszenek, akkor azokat hasonlóan felveheted egy figyelmen kívül hagyott listára:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

GYIK

Ha van még néhány kérdésed vagy problémád, a GYIK-ben talán találsz rá megoldást.

Haladó témák

Ha az a típus vagy, aki szereti bepiszkolni a kezét, ezek a részek talán visszhangra találnak.

Haladó telepítés

Egyes felhasználók esetleg manuálisan szeretnék telepíteni az Oh My Zsh-t, vagy megváltoztatni az alapértelmezett elérési utat vagy más beállításokat, amelyeket a telepítő elfogad (ezek a beállítások szintén dokumentálva vannak a telepítő szkript tetején).

Custom Directory

Az alapértelmezett hely a ~/.oh-my-zsh (a home könyvtáradban rejtve, a cd ~/.oh-my-zsh segítségével érheted el)

Ha szeretnéd megváltoztatni a telepítési könyvtárat a ZSH környezeti változóval, akkor vagy aexport ZSH=/your/path futtatásával a telepítés előtt, vagy a telepítő pipeline vége előtt állítsd be, például így:

ZSH="$HOME/.dotfiles/oh-my-zsh" sh install.sh

felügyelet nélküli telepítés

Ha az Oh My Zsh telepítő szkriptet egy automatizált telepítés részeként futtatja, akkor a --unattended jelzőt átadhatja a install.sh szkriptnek. Ennek az lesz a hatása, hogy nem próbálja megváltoztatni az alapértelmezett héjat, és a telepítés befejeztével nem fut le a zsh sem.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended

Telepítés forked repositoryból

A telepítő szkript ezeket a változókat is elfogadja, hogy más repositoryból is lehessen telepíteni:

• REPO (alapértelmezett: ohmyzsh/ohmyzsh): ez owner/repository formában történik. Ha ezt a változót beállítod, a telepítő a

• REMOTE (alapértelmezett: ) címen fog tárolót keresni: ez a git repositoryclone teljes URL címe. Ezt a beállítást használhatod, ha olyan forkról szeretnél telepíteni, ami nincs a GitHubon (GitLab,Bitbucket…), vagy ha HTTPS helyett SSH-val akarsz klónozni ([email protected]:user/project.git).

  Figyelem: nem kompatibilis a REPO változó beállításával. Ez a beállítás elsőbbséget élvez.

• BRANCH (alapértelmezett: master): ezt a beállítást akkor használhatja, ha a repository klónozásakor meg akarja változtatni az alapértelmezett ágat, amelyet ki kell ellenőrizni. Ez hasznos lehet egy Pull Request tesztelésénél, vagy ha a master-től eltérő ágat szeretne használni.

Példa:

REPO=apjanke/oh-my-zsh BRANCH=edge sh install.sh

Kézi telepítés

1. Kézi telepítés

. Klónozza a tárolóhelyet

git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh

2. Opcionálisan készítsen biztonsági másolatot a meglévő ~/.zshrc fájljáról

cp ~/.zshrc ~/.zshrc.orig

3. Hozzon létre egy új zsh konfigurációs fájlt

Elkészíthet egy új zsh konfigurációs fájlt az általunk mellékelt sablon másolásával.

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

4. Hozzon létre egy új zsh konfigurációs fájlt. Az alapértelmezett shell megváltoztatása

chsh -s $(which zsh)

A változtatás megtekintéséhez ki kell jelentkeznie a felhasználói munkamenetből, majd vissza kell jelentkeznie.

5. Az alapértelmezett shell módosítása. Az új zsh konfiguráció inicializálása

Mihelyt megnyit egy új terminálablakot, annak be kell töltenie a zsh-t az Oh My Zsh konfigurációjával.

Telepítési problémák

Ha a telepítéssel akadnak problémák, itt van néhány gyakori megoldás.

• Szükséged lehet a PATH módosítására a ~/.zshrc-ben, ha nem találsz meg néhány parancsot a oh-my-zsh-ra váltás után.
• Ha kézzel telepítettél vagy megváltoztattad a telepítés helyét, ellenőrizd a ZSH környezeti változót a ~/.zshrc-ben.

Egyéni bővítmények és témák

Ha felül akarja írni bármelyik alapértelmezett viselkedést, csak adjon hozzá egy új (.zsh végződésű) fájlt a custom/ könyvtárban.

Ha sok olyan funkciója van, amelyek jól illeszkednek egymáshoz, akkor ezeket egy XYZ.plugin.zsh fájlként elhelyezheti a custom/plugins/ könyvtárban, majd engedélyezze ezt a bővítményt.

Ha felül szeretné írni egy Oh My Zsh-val terjesztett plugin funkcióit, hozzon létre egy azonos nevű plugint a custom/plugins/ könyvtárban, és ez fog betöltődni a plugins/ könyvtárban lévő plugin helyett.

Frissítések beszerzése

Alapértelmezés szerint a rendszer néhány hetente kéri, hogy ellenőrizze a frissítéseket. Ha azt szeretnéd, hogy a oh-my-zsh automatikusan frissítse magát anélkül, hogy kérdezne, állítsd be a következőket a ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Az automatikus frissítések kikapcsolásához állítsd be a következőket a ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Kézi frissítések

Ha bármikor frissíteni szeretnél (esetleg valaki most adott ki egy új plugint, és nem akarsz várni egy hetet?), akkor csak futtatnod kell:

omz update

Magic! 🎉

Az Oh My Zsh eltávolítása

Az Oh My Zsh nem mindenkinek való. Hiányozni fogsz, de szeretnénk, ha ez egy könnyű szakítás lenne.

Ha szeretnéd eltávolítani oh-my-zsh, csak futtasd a uninstall_oh_my_zsh parancssorból. Ez eltávolítja magát, és visszaállítja a korábbi bash vagy zsh konfigurációdat.

Hogyan járulhatok hozzá az Oh My Zsh-hez?

Mielőtt részt vennél a bájos közösségünkben, kérlek olvasd el a magatartási kódexet.

Távol áll tőlem, hogy Zsh-szakértő legyek, és gyanítom, hogy sok lehetőség van a javításra – ha vannak ötleteid, hogyan lehetne a konfigurációt könnyebben karbantarthatóvá (és gyorsabbá) tenni, ne habozz elágazni és pull requesteket küldeni!

A pull-requestek teszteléséhez is szükségünk van emberekre. Szóval nézd át a nyitott problémákat, és segíts, ahol tudsz.

Lásd a Contributing-ot további részletekért.

NE küldj nekünk témákat

Előre (több mint) elég témánk van. Kérjük, add a témádat a külső témák wiki oldalra.

Hozzájárulók

A Zsh-nak egy élénk, boldog felhasználókból és örömteli közreműködőkből álló közössége van. A közreműködőink minden ideje és segítsége nélkül nem lenne ilyen fantasztikus.

Nagyon köszönjük!

Kövess minket

A közösségi médiában:

• @ohmyzsh a Twitteren. Követned kellene.
• FaceBook poke us.
• Instagram tag us in your post showing Oh My Zsh!
• Discord to chat with us!

Merchandise

We have stickers, shirts, and coffee mug available for you to show off your love of Oh My Zsh. Ismét te leszel a város beszédtémája!

Licenc

Az Oh My Zsh a MIT licenc alatt jelenik meg.

A Planet Argonról