ohmyzsh / ohmyzsh

Oh My Zsh ist ein quelloffenes, Community-getriebenes Framework zur Verwaltung deiner zsh-Konfiguration.

Klingt langweilig. Versuchen wir es noch einmal.

Oh My Zsh wird Sie nicht zu einem 10-fachen Entwickler machen… aber Sie werden sich wie einer fühlen.

Nach der Installation wird Ihre Terminal-Shell zum Stadtgespräch oder Sie bekommen Ihr Geld zurück! Mit jedem Tastendruck in der Eingabeaufforderung werden Sie die Vorteile der Hunderte von leistungsstarken Plugins und schönen Themen nutzen. Fremde werden Sie in Cafés ansprechen und fragen: „Das ist ja unglaublich! Sind Sie so eine Art Genie?“

Endlich werden Sie anfangen, die Art von Aufmerksamkeit zu bekommen, von der Sie immer dachten, Sie hätten sie verdient. …oder vielleicht nutzt du die Zeit, die du sparst, um öfter Zahnseide zu benutzen. 😬

Um mehr zu erfahren, besuchen Sie ohmyz.sh, folgen Sie @ohmyzsh auf Twitter und schließen Sie sich uns auf Discord an.

Erste Schritte

Voraussetzungen

  • Ein Unix-ähnliches Betriebssystem: macOS, Linux, BSD. Unter Windows: WSL2 wird bevorzugt, aber cygwin oder msys funktionieren auch meistens.
  • Zsh sollte installiert sein (v4.3.9 oder neuer ist in Ordnung, aber wir bevorzugen 5.0.8 und neuer). Wenn es nicht vorinstalliert ist (führen Sie zsh --version aus, um dies zu bestätigen), lesen Sie die folgenden Wiki-Anweisungen hier: Installation von ZSH
  • curl oder wget sollte installiert sein
  • git sollte installiert sein (empfohlen v2.4.11 oder höher)

Grundinstallation

Mein Zsh wird installiert, indem Sie einen der folgenden Befehle in Ihrem Terminal ausführen. Sie können es auch über die Kommandozeile mit curl, wget oder einem ähnlichen Tool installieren.

Manuelle Überprüfung

Es ist eine gute Idee, das Installationsskript von Projekten zu überprüfen, die Sie noch nicht kennen. Du kannst das tun, indem du das Installationsskript zuerst herunterlädst, es durchschaust, damit alles normal aussieht, und es dann ausführst:

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

Oh My Zsh benutzen

Plugins

Oh My Zsh kommt mit einer Menge Plugins, die du nutzen kannst. Sie können einen Blick in das Plugins-Verzeichnis und/oder das Wiki werfen, um zu sehen, was derzeit verfügbar ist.

Plugins aktivieren

Wenn Sie ein Plugin (oder mehrere) gefunden haben, das Sie mit Oh My Zsh verwenden möchten, müssen Sie es in der .zshrc-Datei aktivieren. Sie finden die zshrc-Datei in Ihrem $HOME-Verzeichnis. Öffnen Sie sie mit Ihrem bevorzugten Texteditor, und Sie werden eine Stelle sehen, an der Sie alle Plugins auflisten können, die Sie laden möchten.

vi ~/.zshrc

Das könnte zum Beispiel so aussehen:

plugins=( git bundler dotenv osx rake rbenv ruby)

Beachten Sie, dass die Plugins durch Leerzeichen getrennt sind (Leerzeichen, Tabs, neue Zeilen…). Verwenden Sie keine Kommas dazwischen, sonst bricht es ab.

Plugins verwenden

Jedes Plugin enthält eine README, die es dokumentiert. Diese README sollte die Aliase (wenn das Plugin welche hinzufügt) und zusätzliche Goodies zeigen, die in diesem speziellen Plugin enthalten sind.

Themes

Wir geben es zu. In der Anfangszeit von Oh My Zsh sind wir vielleicht ein bisschen zu themenverliebt geworden. Wir haben jetzt über einhundertfünfzig Themen gebündelt. Von den meisten gibt es Screenshots im Wiki (Wir arbeiten daran, das zu aktualisieren!). Schau sie dir an!

Auswahl eines Themas

Robbys Thema ist das Standardthema. Es ist nicht das schickste. Es ist auch nicht das einfachste. Es ist einfach das richtige (für ihn).

Wenn Sie ein Thema gefunden haben, das Sie verwenden möchten, müssen Sie die Datei ~/.zshrc bearbeiten. Sie werden dort eine Umgebungsvariable (in Großbuchstaben) sehen, die wie folgt aussieht:

ZSH_THEME="robbyrussell"

Um ein anderes Thema zu verwenden, ändern Sie einfach den Wert so, dass er dem Namen des gewünschten Themas entspricht. Zum Beispiel:

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

Hinweis: viele Themes erfordern die Installation der Powerline-Schriftarten, um korrekt dargestellt zu werden.

Öffnen Sie ein neues Terminal-Fenster und Ihre Eingabeaufforderung sollte in etwa so aussehen:

Sollten Sie kein passendes Theme für Ihre Bedürfnisse gefunden haben, schauen Sie bitte im Wiki nach weiteren Themes.

Wenn Sie sich munter fühlen, können Sie den Computer jedes Mal, wenn Sie ein neues Terminalfenster öffnen, ein zufälliges Thema für Sie auswählen lassen.

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

Und wenn du ein zufälliges Thema aus einer Liste deiner Lieblingsthemen auswählen möchtest:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Wenn du nur weißt, welche Themen du nicht magst, kannst du sie ebenfalls zu einer Ignorierliste hinzufügen:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Wenn du weitere Fragen oder Probleme hast, findest du vielleicht eine Lösung in unserer FAQ.

Fortgeschrittene Themen

Wenn Sie der Typ sind, der sich gerne die Hände schmutzig macht, könnten diese Abschnitte interessant sein.

Fortgeschrittene Installation

Einige Benutzer möchten Oh My Zsh vielleicht manuell installieren oder den Standardpfad oder andere Einstellungen, die das Installationsprogramm akzeptiert, ändern (diese Einstellungen sind auch am Anfang des Installationsskripts dokumentiert).

Benutzerdefiniertes Verzeichnis

Der Standardpfad ist ~/.oh-my-zsh (versteckt in Ihrem Home-Verzeichnis, Sie können mit cd ~/.oh-my-zsh darauf zugreifen)

Wenn Sie das Installationsverzeichnis mit der Umgebungsvariable ZSH ändern möchten, führen Sie entwederexport ZSH=/your/path vor der Installation aus, oder setzen Sie es vor dem Ende der Installationspipeline wie folgt:

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

Unbeaufsichtigte Installation

Wenn Sie das Oh My Zsh-Installationsskript als Teil einer automatisierten Installation ausführen, können Sie das Flag --unattended an das install.sh-Skript übergeben. Dies hat den Effekt, dass nicht versucht wird, die Standard-Shell zu ändern und auch zsh nicht ausgeführt wird, wenn die Installation beendet ist.

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

Installation aus einem geforkten Repository

Das Installationsskript akzeptiert auch diese Variablen, um die Installation eines anderen Repositorys zu ermöglichen:

  • REPO (Standard: ohmyzsh/ohmyzsh): dies hat die Form von owner/repository. Wenn Sie diese Variable setzen, sucht das Installationsprogramm nach einem Repository unter

  • REMOTE (Standard: ): Dies ist die vollständige URL des Git-Repositoryclone. Sie können diese Einstellung verwenden, wenn Sie von einem Fork installieren möchten, der nicht auf GitHub ist (GitLab, Bitbucket…) oder wenn Sie mit SSH statt mit HTTPS ([email protected]:user/project.git) klonen möchten.

    HINWEIS: Diese Einstellung ist nicht kompatibel mit der Einstellung der REPO-Variable. Diese Einstellung hat Vorrang.

  • BRANCH (Standard: master): Sie können diese Einstellung verwenden, wenn Sie den Standardzweig ändern möchten, der beim Klonen des Repositorys ausgecheckt wird. Dies kann nützlich sein, um einen Pull Request zu testen, oder wenn Sie einen anderen Zweig als master verwenden möchten.

Beispiel:

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

Manuelle Installation

1. Klonen Sie das Repository
git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh
2. Sichern Sie optional Ihre vorhandene ~/.zshrc Datei
cp ~/.zshrc ~/.zshrc.orig
3. Erstellen Sie eine neue zsh-Konfigurationsdatei

Sie können eine neue zsh-Konfigurationsdatei erstellen, indem Sie die Vorlage kopieren, die wir für Sie bereitgestellt haben.

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
4. Ändern Sie Ihre Standardshell
chsh -s $(which zsh)

Sie müssen sich von Ihrer Benutzersitzung abmelden und wieder anmelden, um diese Änderung zu sehen.

5. Initialisieren Sie Ihre neue zsh-Konfiguration

Wenn Sie ein neues Terminalfenster öffnen, sollte zsh mit der Konfiguration von Oh My Zsh geladen werden.

Installationsprobleme

Wenn Sie Probleme bei der Installation haben, finden Sie hier ein paar allgemeine Lösungen.

  • Es kann sein, dass Sie Ihre PATH in ~/.zshrc ändern müssen, wenn Sie einige Befehle nicht finden können, nachdem Sie zu oh-my-zsh gewechselt haben.
  • Wenn Sie manuell installiert oder den Installationsort geändert haben, überprüfen Sie die ZSH Umgebungsvariable in~/.zshrc.

Benutzerdefinierte Plugins und Themes

Wenn Sie eines der Standardverhalten überschreiben möchten, fügen Sie einfach eine neue Datei (mit der Endung .zsh) im Verzeichnis custom/ hinzu.

Wenn Sie viele Funktionen haben, die gut zusammenpassen, können Sie sie als XYZ.plugin.zsh Datei im Verzeichnis custom/plugins/ ablegen und dann dieses Plugin aktivieren.

Wenn Sie die Funktionalität eines mit Oh My Zsh verteilten Plugins außer Kraft setzen möchten, erstellen Sie ein gleichnamiges Plugin im Verzeichnis custom/plugins/ und es wird anstelle desjenigen in plugins/ geladen.

Updates erhalten

Standardmäßig werden Sie alle paar Wochen aufgefordert, nach Aktualisierungen zu suchen. Wenn du möchtest, dass oh-my-zsh sich automatisch aktualisiert, ohne dich dazu aufzufordern, setze folgendes in deinem ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Um automatische Upgrades zu deaktivieren, setze folgendes in deinem ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Manuelle Updates

Wenn du zu einem beliebigen Zeitpunkt upgraden möchtest (vielleicht hat jemand gerade ein neues Plugin veröffentlicht und du möchtest nicht eine Woche warten?), müssen Sie nur folgendes ausführen:

omz update

Magic! 🎉

Deinstallation von Oh My Zsh

Oh My Zsh ist nicht für jeden geeignet. Wir werden dich vermissen, aber wir wollen dir die Trennung leicht machen.

Wenn du oh-my-zsh deinstallieren willst, führe einfach uninstall_oh_my_zsh von der Kommandozeile aus. Es wird sich selbst entfernen und deine vorherige bash oder zsh Konfiguration wiederherstellen.

Wie kann ich zu Oh My Zsh beitragen?

Bevor du dich an unserer entzückenden Gemeinschaft beteiligst, lies bitte den Verhaltenskodex.

Ich bin weit davon entfernt, ein Zsh-Experte zu sein und vermute, dass es viele Möglichkeiten zur Verbesserung gibt – wenn Sie Ideen haben, wie man die Konfiguration einfacher (und schneller) pflegen kann, zögern Sie nicht, sich zu gabeln und Pull-Requests zu schicken!

Wir brauchen auch Leute, die Pull-Requests testen. Werfen Sie also einen Blick auf die offenen Fragen und helfen Sie, wo Sie können.

Siehe Beitragen für weitere Details.

Schicken Sie uns KEINE Themes

Wir haben (mehr als) genug Themes für den Moment. Bitte fügen Sie Ihr Thema auf der Wiki-Seite für externe Themen hinzu.

Mitwirkende

Oh My Zsh hat eine lebendige Gemeinschaft von glücklichen Benutzern und wunderbaren Mitwirkenden. Ohne die Zeit und die Hilfe unserer Mitwirkenden wäre es nicht so großartig.

Vielen Dank!

Folge uns

Wir sind in den sozialen Medien:

  • @ohmyzsh auf Twitter. Du solltest ihm folgen.
  • FaceBook poke us.
  • Instagram tag us in your post showing Oh My Zsh!
  • Discord to chat with us!

Merchandise

Wir haben Aufkleber, Shirts und Kaffeebecher für dich, um deine Liebe zu Oh My Zsh zu zeigen. Auch hier wirst du zum Stadtgespräch werden!

Lizenz

Oh My Zsh wird unter der MIT-Lizenz veröffentlicht.

Über Planet Argon

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht.