Oh My Zsh este un cadru open source, condus de comunitate, pentru gestionarea configurației zsh.

Sună plictisitor. Să mai încercăm o dată.

Oh My Zsh nu vă va face un dezvoltator de 10 ori mai bun… dar s-ar putea să vă simțiți ca unul.

După instalare, shell-ul dvs. de terminal va deveni subiect de discuție în oraș sau vă veți primi banii înapoi! Cu fiecare apăsare de tastă în promptul de comandă, veți profita de sutele de plugin-uri puternice și de temele frumoase. Străinii vor veni la tine în cafenele și te vor întreba: „este uimitor! ești un fel de geniu?”

În sfârșit, vei începe să primești genul de atenție pe care ai simțit întotdeauna că o meriți. …sau poate că veți folosi timpul pe care îl economisiți pentru a începe să folosiți mai des ața dentară. 😬

Pentru a afla mai multe, vizitați ohmyz.sh, urmăriți @ohmyzsh pe Twitter și alăturați-vă nouă pe Discord.

Noțiuni introductive

Precondiții

• Un sistem de operare de tip Unix: macOS, Linux, BSD. Pe Windows: WSL2 este preferat, dar cygwin sau msys funcționează, de asemenea, de cele mai multe ori.
• Zsh ar trebui să fie instalat (v4.3.9 sau mai recent este bine, dar preferăm 5.0.8 și mai nou). Dacă nu este preinstalat (rulați zsh --version pentru a confirma), verificați următoarele instrucțiuni wiki aici: Instalarea ZSH
• curl sau wget ar trebui să fie instalat
• git ar trebui să fie instalat (se recomandă v2.4.11 sau o versiune mai recentă)

Instalare de bază

Oh My Zsh se instalează prin rularea uneia dintre următoarele comenzi în terminalul dumneavoastră. Puteți să-l instalați prin linia de comandă cu curl, wget sau cu un alt instrument similar.

Inspecție manuală

Este o idee bună să inspectați scriptul de instalare din proiectele pe care nu le cunoașteți încă. Puteți face acest lucru descărcând mai întâi scriptul de instalare, uitându-vă prin el pentru ca totul să pară normal,apoi rulați-l:

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

Utilizarea Oh My Zsh

Plugin-uri

Oh My Zsh vine cu o grămadă de plugin-uri de care puteți profita. Puteți arunca o privire în directorul de plugin-uri și/sau în wiki pentru a vedea ce este disponibil în prezent.

Activarea plugin-urilor

După ce ați reperat un plugin (sau mai multe) pe care ați dori să îl folosiți cu Oh My Zsh, va trebui să le activați în fișierul .zshrc. Veți găsi fișierul zshrc în directorul $HOME. Deschideți-l cu editorul de text preferat și veți vedea un loc pentru a lista toate plugin-urile pe care doriți să le încărcați.

vi ~/.zshrc

De exemplu, acesta ar putea începe să arate astfel:

plugins=( git bundler dotenv osx rake rbenv ruby)

Rețineți că plugin-urile sunt separate prin spații albe (spații, tabulări, linii noi…). Nu folosiți virgule între ele sau se va întrerupe.

Utilizarea pluginurilor

Care plugin include un README, care îl documentează. Acest README ar trebui să arate aliasurile (dacă pluginul adaugă vreunul) și bunătățile suplimentare care sunt incluse în acel plugin particular.

Teme

Admitem. La începutul lumii Oh My Zsh, s-ar putea să fi devenit un pic prea fericiți cu temele. Avem peste o sută cincizeci de teme incluse acum în pachet. Cele mai multe dintre ele au capturi de ecran pe wiki (Lucrăm la actualizarea acestuia!). Check them out!

Selectarea unei teme

Tema lui Robby este cea implicită. Nu este cea mai fantezistă. Nu este nici cea mai simplă. Este doar cea potrivită (pentru el).

După ce ați găsit o temă pe care doriți să o folosiți, va trebui să editați fișierul ~/.zshrc. Veți vedea acolo o variabilă de mediu (toate majusculele) care arată astfel:

ZSH_THEME="robbyrussell"

Pentru a folosi o temă diferită, pur și simplu schimbați valoarea pentru a se potrivi cu numele temei dorite. De exemplu:

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

Rețineți: multe teme necesită instalarea fonturilor Powerline pentru a putea fi redate corect.

Deschideți o nouă fereastră de terminal și promptul dvs. ar trebui să arate cam așa:

În cazul în care nu ați găsit o temă potrivită pentru nevoile dvs., vă rugăm să aruncați o privire pe wiki pentru mai multe dintre ele.

Dacă vă simțiți combativ, puteți lăsa calculatorul să selecteze una la întâmplare pentru dumneavoastră de fiecare dată când deschideți o nouă fereastră de terminal.

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

Și dacă doriți să alegeți la întâmplare o temă dintr-o listă cu temele dvs. preferate:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Dacă știți doar ce teme nu vă plac, le puteți adăuga în mod similar la o listă ignorată:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Dacă aveți mai multe întrebări sau probleme, s-ar putea să găsiți o soluție în FAQ-ul nostru.

Subiecte avansate

Dacă sunteți genul căruia îi place să se murdărească pe mâini, aceste secțiuni s-ar putea să vă placă.

Instalare avansată

Cerți utilizatori ar putea dori să instaleze manual Oh My Zsh, sau să schimbe calea implicită sau alte setări pe care le acceptă programul de instalare (aceste setări sunt, de asemenea, documentate în partea de sus a scriptului de instalare).

Custom Directory

Locația implicită este ~/.oh-my-zsh (ascunsă în directorul dvs. personal, o puteți accesa cu cd ~/.oh-my-zsh)

Dacă doriți să schimbați directorul de instalare cu variabila de mediu ZSH, fie prin rulareaexport ZSH=/your/path înainte de instalare, fie prin setarea acesteia înainte de sfârșitul pipelinei de instalare în felul următor:

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

Instalare nesupravegheată

Dacă executați scriptul de instalare Oh My Zsh ca parte a unei instalări automatizate, puteți trece flagul --unattended la scriptul install.sh. Acest lucru va avea ca efect faptul că nu va încerca să schimbe shell-ul implicit și, de asemenea, nu va rula zsh atunci când instalarea s-a terminat.

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

Instalarea dintr-un depozit bifurcat

Scriptul de instalare acceptă și aceste variabile pentru a permite instalarea dintr-un depozit diferit:

• REPO (implicit: ohmyzsh/ohmyzsh): aceasta ia forma owner/repository. Dacă setațiaceastă variabilă, programul de instalare va căuta un depozit la

• REMOTE (implicit: ): aceasta este adresa URL completă a depozitului git repositoryclone. Puteți utiliza această setare dacă doriți să instalați dintr-o bifurcație care nu se află pe GitHub (GitLab,Bitbucket…) sau dacă doriți să clonați cu SSH în loc de HTTPS ([email protected]:user/project.git).

  NOTA: este incompatibilă cu setarea variabilei REPO. Această setare va avea prioritate.

• BRANCH (implicit: master): puteți utiliza această setare dacă doriți să schimbați ramura implicită pentru a fi verificată atunci când clonați depozitul. Acest lucru ar putea fi util pentru testarea unei cereri de tip Pull Request, sau dacă doriți să folosiți o altă ramură decât master.

De exemplu:

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

Instalare manuală

1. Clonați depozitul

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

2. Opțional, faceți o copie de rezervă a fișierului ~/.zshrc existent

cp ~/.zshrc ~/.zshrc.orig

3. Creați un nou fișier de configurare zsh

Puteți crea un nou fișier de configurare zsh copiind șablonul pe care l-am inclus pentru dumneavoastră.

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

4. Creați un nou fișier de configurare zsh. Schimbați shell-ul implicit

chsh -s $(which zsh)

Trebuie să vă deconectați din sesiunea de utilizator și să vă conectați din nou pentru a vedea această modificare.

5. Inițializați noua dvs. configurație zsh

După ce deschideți o nouă fereastră de terminal, aceasta ar trebui să încarce zsh cu configurația Oh My Zsh.

Probleme de instalare

Dacă aveți probleme la instalare, iată câteva remedii comune.

• S-ar putea fi nevoie să vă modificați PATH în ~/.zshrc dacă nu reușiți să găsiți unele comenzi după ce ați trecut la oh-my-zsh.
• Dacă ați instalat manual sau ați schimbat locația de instalare, verificați variabila de mediu ZSH din ~/.zshrc.

Plugin-uri și teme personalizate

Dacă doriți să suprascrieți oricare dintre comportamentele implicite, trebuie doar să adăugați un nou fișier (care se termină în .zsh) în directorul custom/.

Dacă aveți multe funcții care merg bine împreună, le puteți pune ca fișier XYZ.plugin.zsh în directorul custom/plugins/ și apoi activați acest plugin.

Dacă doriți să suprascrieți funcționalitatea unui plugin distribuit cu Oh My Zsh, creați un plugin cu același nume în directorul custom/plugins/ și acesta va fi încărcat în locul celui din plugins/.

Obținerea de actualizări

În mod implicit, vi se va cere să verificați actualizările la fiecare câteva săptămâni. Dacă doriți ca oh-my-zsh să se actualizeze automat fără să vă solicite, setați următoarele în ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Pentru a dezactiva actualizările automate, setați următoarele în ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Actualizări manuale

Dacă doriți să vă actualizați în orice moment (poate cineva tocmai a lansat un nou plugin și nu doriți să așteptați o săptămână?) trebuie doar să rulați:

omz update

Magic! 🎉

Dezinstalarea Oh My Zsh

Oh My Zsh nu este pentru toată lumea. Ne va fi dor de tine, dar vrem să facem această despărțire ușoară.

Dacă doriți să dezinstalați oh-my-zsh, doar rulați uninstall_oh_my_zsh din linia de comandă. Se va elimina singur și va reveni la configurația dvs. anterioară bash sau zsh.

Cum pot contribui la Oh My Zsh?

Înainte de a participa la încântătoarea noastră comunitate, vă rugăm să citiți codul de conduită.

Sunt departe de a fi un expert Zsh și bănuiesc că există multe modalități de îmbunătățire – dacă aveți idei despre cum să faceți configurația mai ușor de întreținut (și mai rapidă), nu ezitați să faceți fork și să trimiteți pull requests!

De asemenea, avem nevoie de oameni care să testeze pull-requests. Așa că aruncați o privire prin problemele deschise și ajutați unde puteți.

Vezi Contribuirea pentru mai multe detalii.

NU ne trimiteți teme

Avem (mai mult decât) suficiente teme pentru moment. Vă rugăm să adăugați tema dvs. la pagina wiki a temelor externe.

Colaboratori

Oh My Zsh are o comunitate vibrantă de utilizatori fericiți și colaboratori încântați. Fără tot timpul și ajutorul contributorilor noștri, nu ar fi atât de minunat.

Mulțumim foarte mult!

Urmăriți-ne

Suntem pe rețelele sociale:

• @ohmyzsh pe Twitter. Ar trebui să-l urmați.
• FaceBook poke-ne.
• Instagram tag-ne în postarea dvs. care arată Oh My Zsh!
• Discord pentru a discuta cu noi!

Merchandise

Avem autocolante, tricouri și căni de cafea disponibile pentru a vă arăta dragostea dvs. pentru Oh My Zsh. Încă o dată, veți deveni subiect de discuție în oraș!

Licență

Oh My Zsh este lansat sub licența MIT.

Despre Planeta Argon

.