Der Plugin-Manager für zsh.

Installation | Dokumentation | Bug tracker | Roadmap | Chat | Lizenz

Antigen ist ein kleiner Satz von Funktionen, die Ihnen helfen, Ihre Shell (zsh)-Plugins, genannt Bundles, einfach zu verwalten. Das Konzept ist so ziemlich das gleiche wie Bundles im atypischen vim+pathogen Setup. Antigen ist für zsh das, was Vundle für vim ist.

Antigen hat ein gewisses Maß an Stabilität erreicht und wird seit ein paar Jahren in der freien Wildbahn eingesetzt. Wenn Sie auf Probleme stoßen, öffnen Sie bitte einen Fehlerbericht.

Antigen funktioniert mit den zsh-Versionen >= 4.3.11.

Installation

Installieren Sie Antigen aus unserem Haupt-Repository mit der neuesten stabilen Version:

curl -L git.io/antigen > antigen.zsh# or use git.io/antigen-nightly for the latest version

Es gibt mehrere Installationsmethoden mit Ihrem System-Paket-Manager, schauen Sie einfach auf der Installations-Wiki-Seite nach.

Nun können Sie die Wiki-Seiten Befehle und Konfiguration besuchen, um die Funktionsweise und Anpassung von Antigen besser zu verstehen.

Verwendung

Die Verwendung sollte Ihnen sehr vertraut sein, wenn Sie Vundle verwenden. Ein typisches .zshrc könnte so aussehen:

source /path-to-antigen/antigen.zsh# Load the oh-my-zsh's library.antigen use oh-my-zsh# Bundles from the default repo (robbyrussell's oh-my-zsh).antigen bundle gitantigen bundle herokuantigen bundle pipantigen bundle leinantigen bundle command-not-found# Syntax highlighting bundle.antigen bundle zsh-users/zsh-syntax-highlighting# Load the theme.antigen theme robbyrussell# Tell Antigen that you're done.antigen apply

Öffne deine zsh mit diesem .zshrc und du solltest sehen, dass alle Bundles, die du hier definiert hast, installiert werden. Sobald das geschehen ist, können Sie loslegen. Die vollständige Syntax für den antigen bundle-Befehl wird auf der Seite Befehle besprochen.

Außerdem gibt es im Wiki-Bereich In the wild weitere Konfigurationsbeispiele. Sie können auch einen Blick auf die Show off wiki Seite für die Verwendung des interaktiven Modus werfen.

Meta

Motivation

Wenn Sie zsh und oh-my-zsh verwenden, wissen Sie, dass es nicht sehr einfach ist, viele verschiedene Plugins, die von vielen verschiedenen Autoren entwickelt wurden, in einem einzigen (Sub-)Repo zu pflegen. Es gibt einige wirklich fantastische Plugins und Utilities in oh-my-zsh, aber sie alle in einem einzigen Repo zu haben, ist nicht wirklich gut skalierbar. Und ich bewundere robbyrussells Bemühungen, die gigantische Anzahl von Pull-Anfragen, die das Projekt erhält, zu überprüfen und zusammenzuführen. Wir brauchen eine bessere Art der Plugin-Verwaltung.

Dies wurde in ein paar Fragen diskutiert, aber es sieht nicht so aus, als ob es irgendwelche Fortschritte gegeben hätte. Daher versuche ich, mit Antigen zu beginnen, in der Hoffnung, diese Situation zu verbessern. Bitte beachten Sie, dass ich keineswegs ein Zsh- oder Shell-Skript-Experte bin (weit davon entfernt).

Inspiriert von vundle, kann Antigen oh-my-zsh-ähnliche Plugins von verschiedenen githubrepositories ziehen. Sie sind nicht darauf beschränkt, nur Plugins aus dem oh-my-zsh-Repository zu verwenden, und Sie müssen nicht Ihren eigenen Fork pflegen und ab und zu von Upstream ziehen. Ich ermutige dich sogar dazu, Plugins und Skripte aus verschiedenen Quellen zu holen, direkt von den Autoren, bevor sie sie überhaupt als apull request bei oh-my-zsh einreichen.

Antigen erlaubt es dir auch, das Prompt-Theme mit einem Befehl zu wechseln, einfach so

antigen theme candy

und dein Prompt ist geändert, natürlich nur für diese Sitzung (es sei denn, du fügst diese Zeile in dein .zshrc ein).

Mithelfen

Wir sind immer auf der Suche nach neuen Mitwirkenden! Wir haben eine Reihe von Themen, die als „Hilfe gesucht“ gekennzeichnet sind, und die eine gute Möglichkeit bieten, mitzumachen und anzufangen. Werfen Sie einen Blick auf unsere Roadmap, um zukünftige Projekte zu sehen und Ideen zu diskutieren.

Bitte schauen Sie sich unsere Richtlinien für die Mitarbeit an, um unseren Arbeitsablauf und unsere Programmierkonventionen zu verstehen.

Feedback

Jede Art von Kommentaren/Vorschlägen/Feedback ist herzlich willkommen. Bitte grüßen Sie uns auf Gitter. Eröffnen Sie ein Thema, um etwas (irgendetwas!) über das Projekt zu diskutieren ;).

Artikel

Es gibt viele Artikel, die von Antigen-Benutzern geschrieben wurden. Schauen Sie sich diese auf der Seite Artikel an.

Plugins und Alternativen

Die awesome-zsh-plugins Liste ist ein Verzeichnis von Plugins, Themes und Alternativen, die Sie vielleicht nützlich finden.