Oh My Zsh jest open source’owym, kierowanym przez społeczność frameworkiem do zarządzania konfiguracją zsh.

Brzmi nudno. Spróbujmy jeszcze raz.

Oh My Zsh nie sprawi, że staniesz się 10-krotnym programistą… ale możesz się tak poczuć.

Po zainstalowaniu, Twoja powłoka terminala stanie się tematem miasta lub otrzymasz zwrot pieniędzy! Z każdym naciśnięciem klawisza w wierszu poleceń, skorzystasz z setek potężnych wtyczek i pięknych motywów. Obcy ludzie będą podchodzić do ciebie w kawiarniach i pytać: „to jest niesamowite! czy jesteś jakimś geniuszem?”

W końcu zaczniesz zdobywać uwagę, na którą zawsze czułeś, że zasługujesz. …A może wykorzystasz zaoszczędzony w ten sposób czas, by zacząć częściej nitkować zęby. 😬

Aby dowiedzieć się więcej, odwiedź stronę ohmyz.sh, śledź @ohmyzsh na Twitterze i dołącz do nas na Discordzie.

Rozpoczęcie

Wymagania wstępne

• Uniksowy system operacyjny: macOS, Linux, BSD. W Windows: WSL2 jest preferowany, ale cygwin lub msys również w większości przypadków działają.
• Zsh powinien być zainstalowany (v4.3.9 lub nowszy jest w porządku, ale preferujemy 5.0.8 i nowsze). Jeśli nie jest preinstalowany (uruchom zsh --version aby potwierdzić), sprawdź następujące instrukcje wiki tutaj: Installing ZSH
• curl or wget should be installed
• git should be installed (recommended v2.4.11 or higher)

Basic Installation

Oh My Zsh jest instalowany przez uruchomienie jednego z następujących poleceń w terminalu. Możesz zainstalować to przez wiersz poleceń za pomocą curl, wget lub innego podobnego narzędzia.

Ręczna inspekcja

Dobrym pomysłem jest sprawdzenie skryptu instalacyjnego z projektów, których jeszcze nie znasz. Możesz to zrobić pobierając najpierw skrypt instalacyjny, przeglądając go i sprawdzając czy wszystko wygląda normalnie, a następnie uruchamiając go:

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

Używanie Oh My Zsh

Wtyczki

Oh My Zsh posiada mnóstwo wtyczek, z których możesz skorzystać. Możesz zajrzeć do katalogu wtyczek i/lub na wiki, aby zobaczyć, co jest obecnie dostępne.

Włączanie wtyczek

Gdy już zauważysz wtyczkę (lub kilka), której chciałbyś użyć z Oh My Zsh, będziesz musiał włączyć je w pliku .zshrc. Plik zshrc znajdziesz w swoim katalogu $HOME. Otwórz go w swoim ulubionym edytorze tekstu, a zobaczysz miejsce na listę wszystkich wtyczek, które chcesz załadować.

vi ~/.zshrc

Na przykład, może to zacząć wyglądać tak:

plugins=( git bundler dotenv osx rake rbenv ruby)

Zauważ, że wtyczki są oddzielone białymi odstępami (spacje, tabulatory, nowe linie…). Nie używaj przecinków między nimi, bo się zepsują.

Używanie wtyczek

Każda wtyczka zawiera README, dokumentujące ją. To README powinno pokazywać aliasy (jeśli wtyczka dodaje jakieś) i dodatkowe gadżety, które są zawarte w tej konkretnej wtyczce.

Motywy

Przyznajemy się. Na początku w świecie Oh My Zsh, mogliśmy się trochę za bardzo rozpieścić tematami. Mamy teraz ponad sto pięćdziesiąt motywów w pakiecie. Większość z nich ma zrzuty ekranu na wiki (Pracujemy nad uaktualnieniem tego!). Sprawdź je!

Wybieranie motywu

Motyw Bobby’ego jest domyślny. Nie jest on najbardziej wyszukany. Nie jest też najprostszy. Jest po prostu właściwy (dla niego).

Gdy znajdziesz motyw, którego chciałbyś użyć, będziesz musiał edytować plik ~/.zshrc. Zobaczysz tam zmienną środowiskową (wszystkie wielkie litery), która wygląda jak:

ZSH_THEME="robbyrussell"

Aby użyć innego motywu, po prostu zmień wartość, aby dopasować ją do nazwy żądanego motywu. Na przykład:

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

Uwaga: wiele motywów wymaga zainstalowania czcionek Powerline Fonts w celu poprawnego renderowania.

Otwórz nowe okno terminala, a twój znak zachęty powinien wyglądać tak:

W przypadku, gdy nie znalazłeś odpowiedniego motywu dla swoich potrzeb, spójrz na wiki, gdzie znajdziesz ich więcej.

Jeśli czujesz się zadziorny, możesz pozwolić komputerowi wybrać losowo jeden dla ciebie za każdym razem, gdy otwierasz nowe okno terminala.

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

A jeśli chcesz wybrać losowy motyw z listy ulubionych motywów:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Jeśli wiesz tylko, których motywów nie lubisz, możesz je dodać do listy ignorowanych:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Jeśli masz więcej pytań lub problemów, możesz znaleźć rozwiązanie w naszym FAQ.

Tematy zaawansowane

Jeśli jesteś typem, który lubi brudzić sobie ręce, te sekcje mogą Ci się spodobać.

Instalacja zaawansowana

Niektórzy użytkownicy mogą chcieć ręcznie zainstalować Oh My Zsh, lub zmienić domyślną ścieżkę lub inne ustawienia, które akceptuje instalator (te ustawienia są również udokumentowane na górze skryptu instalacyjnego).

Katalog niestandardowy

Domyślna lokalizacja to ~/.oh-my-zsh (ukryta w twoim katalogu domowym, możesz się do niej dostać za pomocą cd ~/.oh-my-zsh)

Jeśli chcesz zmienić katalog instalacyjny za pomocą zmiennej środowiskowej ZSH, albo przez uruchomienieexport ZSH=/your/path przed instalacją, albo przez ustawienie jej przed końcem potoku instalacyjnego, jak poniżej:

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

Instalacja nienadzorowana

Jeśli uruchamiasz skrypt instalacyjny Oh My Zsh jako część instalacji automatycznej, możesz przekazać flagę --unattended do skryptu install.sh. Spowoduje to, że nie będzie on próbował zmienić domyślnej powłoki, a także nie uruchomi zsh po zakończeniu instalacji.

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

Instalowanie z rozwidlonego repozytorium

Skrypt instalacyjny akceptuje również te zmienne, aby umożliwić instalację z innego repozytorium:

• REPO (domyślnie: ohmyzsh/ohmyzsh): ma to postać owner/repository. Jeśli ustawisz tę zmienną, instalator będzie szukał repozytorium pod adresem

• REMOTE (domyślnie: ): jest to pełny adres URL repozytorium git repositoryclone. Możesz użyć tego ustawienia, jeśli chcesz zainstalować z widelca, który nie jest na GitHubie (GitLab,Bitbucket…) lub jeśli chcesz klonować za pomocą SSH zamiast HTTPS ([email protected]:user/project.git).

  UWAGA: to jest niekompatybilne z ustawieniem zmiennej REPO. To ustawienie będzie miało pierwszeństwo.

• BRANCH (domyślnie: master): możesz użyć tego ustawienia, jeśli chcesz zmienić domyślną gałąź do sprawdzenia podczas klonowania repozytorium. Może to być przydatne do testowania Pull Request, lub jeśli chcesz użyć innej gałęzi niż master.

Na przykład:

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

Instalacja ręczna

1. Sklonuj repozytorium

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

2. Opcjonalnie wykonaj kopię zapasową istniejącego pliku ~/.zshrc

cp ~/.zshrc ~/.zshrc.orig

3. Utwórz nowy plik konfiguracyjny zsh

Możesz utworzyć nowy plik konfiguracyjny zsh, kopiując szablon, który dla Ciebie dołączyliśmy.

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

4. Zmień swoją domyślną powłokę

chsh -s $(which zsh)

Musisz wylogować się z sesji użytkownika i zalogować się ponownie, aby zobaczyć tę zmianę.

5. Zainicjuj nową konfigurację zsh

Gdy otworzysz nowe okno terminala, powinno ono załadować zsh z konfiguracją Oh My Zsh.

Problemy z instalacją

Jeśli masz jakiekolwiek problemy z instalacją, oto kilka typowych poprawek.

• Możesz potrzebować zmodyfikować swój PATH w ~/.zshrc, jeśli nie jesteś w stanie znaleźć niektórych poleceń po przełączeniu się na oh-my-zsh.
• Jeśli instalowałeś ręcznie lub zmieniłeś miejsce instalacji, sprawdź zmienną środowiskową ZSH w ~/.zshrc.

Niestandardowe wtyczki i motywy

Jeśli chcesz zastąpić którekolwiek z domyślnych zachowań, po prostu dodaj nowy plik (kończący się na .zsh) w katalogu custom/.

Jeśli masz wiele funkcji, które dobrze ze sobą współgrają, możesz umieścić je jako plik XYZ.plugin.zsh w katalogu custom/plugins/, a następnie włączyć tę wtyczkę.

Jeśli chcesz zastąpić funkcjonalność wtyczki dystrybuowanej z Oh My Zsh, utwórz wtyczkę o tej samej nazwie w katalogu custom/plugins/, a zostanie ona załadowana zamiast tej w plugins/.

Uzyskiwanie aktualizacji

Domyślnie, co kilka tygodni zostaniesz poproszony o sprawdzenie aktualizacji. Jeśli chcesz, aby oh-my-zsh automatycznie aktualizował się bez monitów, ustaw następujące ustawienia w swoim ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Aby wyłączyć automatyczne aktualizacje, ustaw następujące ustawienia w swoim ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Aktualizacje ręczne

Jeśli chcesz zaktualizować się w dowolnym momencie (może ktoś właśnie wydał nowy plugin i nie chcesz czekać tydzień?) wystarczy, że uruchomisz:

omz update

Magic! 🎉

Odinstalowanie Oh My Zsh

Oh My Zsh nie jest dla wszystkich. Będziemy za tobą tęsknić, ale chcemy, aby to było łatwe rozstanie.

Jeśli chcesz odinstalować oh-my-zsh, po prostu uruchom uninstall_oh_my_zsh z wiersza poleceń. Usunie się ona sama i przywróci twoją poprzednią konfigurację bash lub zsh.

Jak mogę przyczynić się do Oh My Zsh?

Zanim weźmiesz udział w naszej zachwycającej społeczności, przeczytaj kodeks postępowania.

Jestem daleki od bycia ekspertem Zsh i podejrzewam, że jest wiele sposobów na poprawę – jeśli masz pomysł, jak sprawić, by konfiguracja była łatwiejsza w utrzymaniu (i szybsza), nie wahaj się rozwidlić i wysłać pull requests!

Potrzebujemy także ludzi do testowania pull-requestów. Więc przejrzyj otwarte problemy i pomóż gdzie możesz.

Zobacz Contributing po więcej szczegółów.

NIE wysyłaj nam motywów

Mamy (więcej niż) wystarczająco dużo motywów na razie. Proszę dodać swój motyw do strony wiki tematów zewnętrznych.

Współtwórcy

Oh My Zsh ma tętniącą życiem społeczność szczęśliwych użytkowników i wspaniałych współtwórców. Bez czasu i pomocy naszych współpracowników nie byłoby to tak niesamowite.

Bardzo dziękujemy!

Śledź nas

Jesteśmy w mediach społecznościowych:

• @ohmyzsh na Twitterze. You should follow it.
• 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 mugs available for you to show off your love of Oh My Zsh. Ponownie staniesz się tematem rozmów w mieście!

Licencja

Oh My Zsh jest wydany na licencji MIT.

O Planet Argon

.