Oh My Zsh je open source, komunitou řízený framework pro správu konfigurace zsh.

Zní to nudně. Zkusíme to znovu.

Oh My Zsh z vás neudělá desetinásobného vývojáře… ale možná se tak budete cítit.

Po instalaci se o vašem terminálovém shellu bude mluvit jako o městě, nebo vám vrátí peníze! S každým stiskem klávesy v příkazovém řádku využijete stovky výkonných doplňků a krásných motivů. V kavárnách za vámi budou chodit cizí lidé a ptát se vás: „To je úžasné, vy jste nějaký génius?“

Konečně se vám začne dostávat pozornosti, kterou jste vždy cítili, že si zasloužíte. … Nebo možná využiješ ušetřený čas k tomu, abys začal častěji používat zubní nit. 😬

Chcete-li se dozvědět více, navštivte ohmyz.sh, sledujte @ohmyzsh na Twitteru a připojte se k nám na Discordu.

Začínáme

Předpoklady

• Operační systém podobný Unixu: MacOS, Linux, BSD. V operačním systému Windows:
• Měl by být nainstalován Zsh (stačí verze 4.3.9 nebo novější, ale preferujeme verzi 5.0.8 a novější). Pokud není předinstalován (pro potvrzení spusťte zsh --version), podívejte se na následující návod na wiki zde: Instalace ZSH
• curl nebo wget měl by být nainstalován
• git měl by být nainstalován (doporučujeme v2.4.11 nebo novější)

Základní instalace

Oh My Zsh se instaluje spuštěním jednoho z následujících příkazů v terminálu. Přes příkazový řádek můžete instalovat pomocí curl, wget nebo jiného podobného nástroje.

Ruční kontrola

Je dobré zkontrolovat instalační skript z projektů, které ještě neznáte. Můžete to udělat tak, že si instalační skript nejprve stáhnete, prohlédnete si ho, aby vše vypadalo normálně, a pak ho spustíte:

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

Použití Oh My Zsh

Zásuvné moduly

Oh My Zsh obsahuje spoustu zásuvných modulů, které můžete využít. Můžete se podívat do adresáře plugins a/nebo na wiki, abyste zjistili, co je aktuálně k dispozici.

Povolení pluginů

Jakmile si všimnete pluginu (nebo několika pluginů), které chcete s Oh My Zsh používat, musíte je povolit v souboru .zshrc. Soubor zshrc najdete v adresáři $HOME. Otevřete jej ve svém oblíbeném textovém editoru a uvidíte místo pro seznam všech zásuvných modulů, které chcete načíst.

vi ~/.zshrc

Například to může začít vypadat takto:

plugins=( git bundler dotenv osx rake rbenv ruby)

Všimněte si, že zásuvné moduly jsou odděleny bílými znaky (mezery, tabulátory, nové řádky…). Nepoužívejte mezi nimi čárky, jinak se to rozbije.

Použití zásuvných modulů

Každý zásuvný modul obsahuje soubor README, který jej dokumentuje. V tomto README by měly být uvedeny aliasy (pokud zásuvný modul nějaké přidává) a další vychytávky, které jsou součástí daného zásuvného modulu.

Motivy

Přiznáváme. Na začátku světa Oh My Zsh jsme se možná až příliš radovali z témat. Nyní máme přibaleno více než sto padesát motivů. Většina z nich má na wiki screenshoty (Pracujeme na jejich aktualizaci!). Podívejte se na ně!

Výběr tématu

Téma Robby je výchozí. Není to ten nejfantastičtější. Není ani nejjednodušší. Je to prostě to pravé (pro něj).

Jakmile najdete téma, které chcete používat, budete muset upravit soubor ~/.zshrc. Uvidíte v něm proměnnou prostředí (všechna velká písmena), která vypadá takto:

ZSH_THEME="robbyrussell"

Chcete-li použít jiné téma, jednoduše změňte hodnotu tak, aby odpovídala názvu požadovaného tématu. Například:

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

Poznámka: mnoho motivů vyžaduje instalaci Powerline Fonts, aby se správně vykreslovaly.

Otevřete nové okno terminálu a vaše výzva by měla vypadat takto:

Pokud jste nenašli vhodný motiv pro vaše potřeby, podívejte se na wiki, kde jich najdete více.

Pokud se cítíte divocí, můžete nechat počítač, aby vám při každém otevření nového okna terminálu jedno náhodně vybral.

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

A pokud si chcete vybrat náhodný motiv ze seznamu svých oblíbených motivů:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Pokud jen víte, které motivy se vám nelíbí, můžete je podobně přidat do ignorovaného seznamu:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Pokud máte nějaké další otázky nebo problémy, možná najdete řešení v našich FAQ.

Témata pro pokročilé

Pokud jste typ, který si rád zašpiní ruce, mohly by vám přijít vhod tyto sekce:

Pokročilá instalace

Někteří uživatelé mohou chtít instalovat Oh My Zsh ručně nebo změnit výchozí cestu či jiná nastavení, která instalátor akceptuje (tato nastavení jsou také zdokumentována v horní části instalačního skriptu).

Vlastní adresář

Výchozí umístění je ~/.oh-my-zsh (skryté ve vašem domovském adresáři, můžete se k němu dostat pomocí cd ~/.oh-my-zsh)

Pokud chcete změnit instalační adresář pomocí proměnné prostředí ZSH, buď spuštěnímexport ZSH=/your/path před instalací, nebo jejím nastavením před koncem instalační pipeline, jako je tato:

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

Neobslužná instalace

Pokud spouštíte instalační skript Oh My Zsh jako součást automatizované instalace, můžete skriptu install.sh předat příznak --unattended. To bude mít za následek, že se nebude pokoušet změnit výchozí shell, a také se po dokončení instalace nespustí zsh.

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

Instalace z forknutého repozitáře

Instalační skript také přijímá tyto proměnné, aby umožnil instalaci z jiného repozitáře:

• REPO (výchozí: ohmyzsh/ohmyzsh): to má podobu owner/repository. Pokud nastavíte tuto proměnnou, bude instalátor hledat úložiště na adrese

• REMOTE (výchozí: ): jedná se o úplnou adresu URL repozitáře git repositoryclone. Toto nastavení můžete použít, pokud chcete instalovat z forku, který není na GitHubu (GitLab,Bitbucket…), nebo pokud chcete klonovat pomocí SSH místo HTTPS ([email protected]:user/project.git).

  POZNÁMKA: není kompatibilní s nastavením proměnné REPO. Toto nastavení bude mít přednost.

• BRANCH (výchozí: master): toto nastavení můžete použít, pokud chcete změnit výchozí větev, která má být při klonování úložiště zkontrolována. To může být užitečné pro testování žádosti o vytažení, nebo pokud chcete použít jinou větev než master.

Například:

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

Ruční instalace

1. V případě, že chcete použít jinou větev než master, můžete ji použít pro testování žádosti o vytažení. Klonování úložiště

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

2. Klonujte úložiště. Případně zálohujte stávající ~/.zshrc soubor

cp ~/.zshrc ~/.zshrc.orig

3. Vytvořte nový konfigurační soubor zsh

Nový konfigurační soubor zsh můžete vytvořit zkopírováním šablony, kterou jsme pro vás přiložili.

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

4. Vytvořte nový konfigurační soubor zsh. Změna výchozího shellu

chsh -s $(which zsh)

Pro zobrazení této změny se musíte odhlásit ze své uživatelské relace a znovu se přihlásit.

5. Změňte výchozí shell. Inicializujte novou konfiguraci zsh

Pokud otevřete nové okno terminálu, mělo by se načíst zsh s konfigurací Oh My Zsh.

Problémy s instalací

Pokud máte při instalaci nějaké zádrhele, zde je několik běžných řešení.

• Možná budete muset upravit PATH v ~/.zshrc, pokud nejste schopni najít některé příkazy popřepnutí na oh-my-zsh.
• Pokud jste instalovali ručně nebo jste změnili umístění instalace, zkontrolujte proměnnou prostředí ZSH v~/.zshrc.

Vlastní zásuvné moduly a motivy

Pokud chcete přepsat některé z výchozích chování, stačí přidat nový soubor (končící na .zsh) do adresáře custom/.

Pokud máte mnoho funkcí, které se k sobě hodí, můžete je umístit jako soubor XYZ.plugin.zsh do adresáře custom/plugins/ a pak tento zásuvný modul povolit.

Pokud chcete přepsat funkčnost zásuvného modulu distribuovaného s Oh My Zsh, vytvořte stejnojmenný zásuvný modul v adresáři custom/plugins/ a ten se načte místo toho v plugins/.

Získávání aktualizací

Ve výchozím nastavení budete každých několik týdnů vyzváni ke kontrole aktualizací. Pokud chcete, aby se oh-my-zsh automaticky aktualizoval sám bez vyzvání, nastavte ve svém ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Chcete-li automatické aktualizace zakázat, nastavte ve svém ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Ruční aktualizace

Pokud chcete aktualizovat kdykoli (třeba někdo právě vydal nový zásuvný modul a vy nechcete čekat týden?) stačí spustit:

omz update

Magic! 🎉

Odinstalování Oh My Zsh

Oh My Zsh není pro každého. Budete nám chybět, ale chceme vám usnadnit rozchod.

Pokud chcete odinstalovat oh-my-zsh, stačí spustit uninstall_oh_my_zsh z příkazového řádku. Odstraní se a vrátí vaši předchozí konfiguraci bash nebo zsh.

Jak mohu přispívat do Oh My Zsh?

Předtím, než se zapojíte do naší rozkošné komunity, přečtěte si prosím kodex chování.

Zdaleka nejsem odborník na Zsh a tuším, že existuje mnoho způsobů, jak konfiguraci vylepšit – pokud máte nápady, jak usnadnit údržbu (a zrychlit), neváhejte forkovat a posílat pull requesty!“

Potřebujeme také lidi, kteří by testovali pull requesty. Proto se podívejte na otevřené problémy a pomozte, kde můžete.

Další podrobnosti najdete v části Přispívání.

NEposílejte nám témata

Témat máme zatím (více než) dost. Přidejte prosím své téma na stránku wiki s externími tématy.

Přispěvatelé

Oh My Zsh má živou komunitu spokojených uživatelů a příjemných přispěvatelů. Bez veškerého času a pomoci našich přispěvatelů by to nebylo tak úžasné.

Moc vám děkujeme!

Sledujte nás

Jsme na sociálních sítích:

• @ohmyzsh na Twitteru. Měli byste ho sledovat.
• FaceBook poke.
• Instagram nás označte ve svém příspěvku, kde ukazujete Oh My Zsh!
• Discord, kde s námi můžete chatovat!

Merchandise

Máme pro vás k dispozici samolepky, trička a hrnky na kávu, abyste mohli ukázat svou lásku k Oh My Zsh. Opět se o vás bude mluvit ve městě!

Licence

Oh My Zsh je vydána pod licencí MIT.

O Planet Argon

.