Oh My Zsh on avoimen lähdekoodin, yhteisölähtöinen kehys zsh-konfiguraatiosi hallintaan.

Kuulostaa tylsältä. Yritetään uudestaan.

Oh My Zsh ei tee sinusta 10x kehittäjää… mutta saatat tuntea itsesi sellaiseksi.

Asennettuasi päätelaitteestasi tulee kaupungin puheenaihe tai saat rahasi takaisin! Jokaisella komentokehotteesi näppäinpainalluksella hyödynnät satoja tehokkaita lisäosia ja kauniita teemoja. Tuntemattomat tulevat luoksesi kahviloissa ja kysyvät sinulta: ”Tuo on uskomatonta! oletko joku nero?”

Vihdoin alat saada sellaista huomiota, jonka olet aina tuntenut ansaitsevasi. …tai ehkä käytät säästämäsi ajan siihen, että alat käyttää hammaslankaa useammin. 😬

Jos haluat lisätietoja, käy osoitteessa ohmyz.sh, seuraa @ohmyzsh Twitterissä ja liity meihin Discordissa.

Aloittaminen

Edellytykset

• Unix-tyyppinen käyttöjärjestelmä: macOS, Linux, BSD. Windowsissa:
• Zsh tulisi olla asennettuna (v4.3.9 tai uudempi käy, mutta suosimme 5.0.8:aa ja uudempaa). Jos sitä ei ole asennettu valmiiksi (suorita zsh --version varmistaaksesi), tarkista seuraavat wiki-ohjeet täältä: ZSH:n asentaminen
• curl tai wget tulisi olla asennettuna
• git tulisi olla asennettuna (suositellaan v2.4.11 tai uudempi)

Perusasennus

Oh My Zsh asennetaan suorittamalla jokin seuraavista komennoista terminaalissa. Voit asentaa sen komentorivin kautta joko curl, wget tai jollain muulla vastaavalla työkalulla.

Manuaalinen tarkastus

On hyvä idea tarkastaa asennusskripti projekteista, joita et vielä tunne. Voit tehdä sen lataamalla asennusskriptin ensin, katsomalla sen läpi, jotta kaikki näyttää normaalilta,ja ajamalla sen sitten:

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

Oh My Zsh:n käyttäminen

Liitännäiset

Oh My Zsh:n mukana tulee kasa liitännäisiä, joita voit hyödyntää. Voit katsoa plugins-hakemistosta ja/tai wikistä, mitä tällä hetkellä on saatavilla.

Pluginsin ottaminen käyttöön

Kun huomaat pluginin (tai useamman), jota haluat käyttää Oh My Zsh:n kanssa, sinun täytyy ottaa ne käyttöön .zshrc-tiedostossa. Löydät zshrc-tiedoston $HOME-hakemistosta. Avaa se suosikkitekstieditorillasi ja näet kohdan, jossa voit luetella kaikki lisäosat, jotka haluat ladata.

vi ~/.zshrc

Tämä voi esimerkiksi alkaa näyttää tältä:

plugins=( git bundler dotenv osx rake rbenv ruby)

Huomaa, että lisäosat erotetaan toisistaan välilyönneillä (välilyönneillä, tabulaattoreilla, uusilla riveillä…). Älä käytä pilkkuja niiden välissä tai se katkeaa.

Pluginien käyttäminen

Jokaiseen pluginiin sisältyy README, jossa se dokumentoidaan. Tämän README:n pitäisi näyttää aliakset (jos lisäosa lisää niitä) ja ylimääräiset herkut, jotka sisältyvät kyseiseen lisäosaan.

Teemat

Myönnämme sen. Oh My Zsh -maailman alkuvaiheessa olemme ehkä olleet hieman liian teemarakkaita. Meillä on nyt yli sataviisikymmentä teemaa niputettuna. Useimmilla niistä on kuvakaappauksia wikissä (Teemme töitä tämän päivittämiseksi!). Tutustu niihin!

Teeman valitseminen

Robbyn teema on oletusteema. Se ei ole kaikkein hienoin. Se ei ole yksinkertaisin. Se on vain oikea (hänelle).

Kun löydät teeman, jota haluat käyttää, sinun täytyy muokata ~/.zshrc-tiedostoa. Näet siellä ympäristömuuttujan (kaikki suuraakkoset), joka näyttää seuraavalta:

ZSH_THEME="robbyrussell"

Käyttääksesi toista teemaa, muuta vain arvo vastaamaan haluamasi teeman nimeä. Esimerkiksi:

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

Huomaa: monet teemat vaativat Powerline-fonttien asentamisen, jotta ne renderöityisivät oikein.

Avaa uusi terminaali-ikkuna, ja komentokehotteesi pitäisi näyttää jotakuinkin tältä:

Jos et löytänyt tarpeisiisi sopivaa teemaa, katso wikistä lisää niitä.

Jos tunnet itsesi ärhäkäksi, voit antaa tietokoneen valita yhden satunnaisesti puolestasi joka kerta, kun avaat uuden pääteikkunan.

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

Ja jos haluat valita satunnaisen teeman suosikkiteemojesi luettelosta:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Jos tiedät vain, mistä teemoista et pidä, voit lisätä ne samalla tavalla huomiotta jätettyjen listalle:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

UKK

Jos sinulla on lisää kysymyksiä tai ongelmia, saatat löytää ratkaisun UKK-tietokannasta.

Edistyneempiä aiheita

Jos olet sitä tyyppiä, joka tykkää liata kätensä, nämä osiot saattavat olla sinulle mieluisia.

Edistyneempi asennus

Jotkut käyttäjät saattavat haluta asentaa Oh My Zsh:n manuaalisesti tai muuttaa oletuspolkua tai muita asetuksia, jotkaasennusohjelma hyväksyy (nämä asetukset on myös dokumentoitu asennusskriptin yläosassa).

Mukautettu hakemisto

Vakiosijainti on ~/.oh-my-zsh (piilossa kotihakemistossasi, pääset siihen käsiksi komennolla cd ~/.oh-my-zsh)

Jos haluat muuttaa asennushakemistoa ympäristömuuttujalla ZSH, joko ajamallaexport ZSH=/your/path ennen asennusta tai asettamalla sen ennen asennusputken loppua näin:

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

Valvomaton asennus

Jos suoritat Oh My Zsh -asennusskriptin osana automatisoitua asennusta, voit välittää merkin --unattended skriptille install.sh. Tämä vaikuttaa siten, että oletuskuorta ei yritetä muuttaa, eikä se myöskään suorita zsh, kun asennus on päättynyt.

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

Asennus haarautuneesta arkistosta

Asennusskripti hyväksyy myös nämä muuttujat salliakseen asennuksen toisesta arkistosta:

• REPO (oletusarvoisesti: ohmyzsh/ohmyzsh): tämä tapahtuu muodossa owner/repository. Jos asetat tämän muuttujan, asennusohjelma etsii arkistoa osoitteesta

• REMOTE (oletus: ): tämä on git-repositoryclonen täydellinen URL-osoite. Voit käyttää tätä asetusta, jos haluat asentaa haarasta, joka ei ole GitHubissa (GitLab,Bitbucket…) tai jos haluat kloonata SSH:lla HTTPS:n sijaan ([email protected]:user/project.git).

  Huomautus: se on yhteensopimaton muuttujan REPO asettamisen kanssa. Tämä asetus on ensisijainen.

• BRANCH (oletusarvo: master): voit käyttää tätä asetusta, jos haluat muuttaa oletushaaraksi bechecked out, kun kloonaat arkistoa. Tästä voi olla hyötyä Pull Requestin testaamisessa tai jos haluat käyttää muuta haaraa kuin master.

Esimerkiksi:

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

Manuaalinen asennus

1. Asennus

. Kloonaa arkisto

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

2. Vaihtoehtoisesti varmuuskopioi olemassa oleva ~/.zshrc -tiedosto

cp ~/.zshrc ~/.zshrc.orig

3. Luo uusi zsh-konfigurointitiedosto

Voit luoda uuden zsh-konfigurointitiedoston kopioimalla mallin, jonka olemme lisänneet sinulle.

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

4. Luo uusi zsh-konfigurointitiedosto. Vaihda oletuskäyttökuoresi

chsh -s $(which zsh)

Sinun on kirjauduttava ulos käyttäjäistunnostasi ja kirjauduttava takaisin sisään nähdäksesi tämän muutoksen.

5. Vaihda oletuskuoresi. Alusta uusi zsh-konfiguraatiosi

Kun avaat uuden terminaali-ikkunan, sen pitäisi ladata zsh:n Oh My Zsh:n konfiguraatiolla.

Asennusongelmat

Jos asennuksessa ilmenee ongelmia, tässä on muutamia yleisiä korjauksia.

• Mahdollisesti sinun on muutettava PATH kohdassa ~/.zshrc, jos et löydä joitain komentoja sen jälkeen, kun olet vaihtanut oh-my-zsh.
• Jos olet asentanut manuaalisesti tai muuttanut asennuspaikkaa, tarkista ympäristömuuttuja ZSH kohdassa ~/.zshrc.

Mukautetut lisäosat ja teemat

Jos haluat ohittaa minkä tahansa oletuskäyttäytymisen, lisää vain uusi tiedosto (pääte .zsh) custom/-hakemistoon.

Jos sinulla on monia toimintoja, jotka sopivat hyvin yhteen, voit laittaa ne XYZ.plugin.zsh-tiedostoksi custom/plugins/-hakemistoon custom/plugins/ ja ottaa tämän lisäosan käyttöön.

Jos haluat ohittaa Oh My Zsh:n mukana jaetun lisäosan toiminnallisuuden, luo samanniminen lisäosa custom/plugins/-hakemistoon, jolloin se ladataan plugins/-hakemistossa olevan lisäosan sijasta.

Päivitysten saaminen

Oletusarvoisesti sinua kehotetaan tarkistamaan päivitykset muutaman viikon välein. Jos haluat, että oh-my-zsh päivittää itsensä automaattisesti ilman kehotusta, aseta ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Jos haluat poistaa automaattiset päivitykset käytöstä, aseta ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Manuaaliset päivitykset

Jos haluat päivittää milloin tahansa (kenties joku on juuri julkaissut uuden laajennuksen etkä halua odottaa viikkoa?) sinun tarvitsee vain suorittaa:

omz update

Magic! 🎉

Oh My Zsh:n poistaminen

Oh My Zsh ei ole tarkoitettu kaikille. Jäämme kaipaamaan sinua, mutta haluamme tehdä tästä helpon eron.

Jos haluat poistaa oh-my-zsh, suorita uninstall_oh_my_zsh komentoriviltä. Se poistaa itsensä ja palauttaa aiemman bash– tai zsh-konfiguraatiosi.

Miten voin osallistua Oh My Zsh:n toimintaan?

Ennen kuin osallistut ilahduttavaan yhteisöömme, lue käytännesäännöt.

En ole läheskään Zsh-asiantuntija ja epäilen, että on monia tapoja parantaa – jos sinulla on ideoita siitä, miten konfiguraatiosta voisi tehdä helpommin ylläpidettävän (ja nopeammin), älä epäröi haarukoida ja lähettää pull-pyyntöjä!

Tarvitsemme myös ihmisiä testaamaan pull-pyyntöjä. Tutustu siis avoimiin ongelmiin ja auta, missä voit.

Katso lisätietoja kohdasta Contributing.

ÄLÄ lähetä meille teemoja

Meillä on (enemmän kuin) tarpeeksi teemoja toistaiseksi. Ole hyvä ja lisää teemasi ulkoisten teemojen wiki-sivulle.

Contributors

Oh My Zsh:lla on elinvoimainen yhteisö iloisia käyttäjiä ja ihastuttavia avustajia. Ilman myötävaikuttajiemme kaikkea aikaa ja apua emme olisi näin mahtavia.

Kiitos paljon!

Seuraa meitä

Olemme sosiaalisessa mediassa:

• @ohmyzsh Twitterissä. Kannattaa seurata.
• FaceBook poke meille.
• Instagram tag meille postauksessasi, jossa näytät Oh My Zsh:n!
• Discordissa voit jutella kanssamme!

Merchandise

Meillä on tarroja, paitoja ja kahvimukkeja saatavilla, joilla voit näyttää rakkautesi Oh My Zsh:ta kohtaan. Jälleen kerran sinusta tulee kaupungin puheenaihe!

Lisenssi

Oh My Zsh on julkaistu MIT-lisenssillä.

Tietoja Planet Argonista