Pluginhanteraren för zsh.

Installation | Dokumentation | Bug tracker | Roadmap | Chat | Licens

Antigen är en liten uppsättning funktioner som hjälper dig att enkelt hantera dina plugins för skalet (zsh), så kallade buntar. Konceptet är i stort sett detsamma som bundles i en atypisk vim+pathogen-uppsättning. Antigen är för zsh vad Vundle är för vim.

Antigen har nått en viss stabilitetsnivå och har använts i det vilda i ungefär ett par år. Om du stöter på några problem kan du öppna ett ärende.

Antigen fungerar med zsh-versioner >= 4.3.11.

Installation

Installera Antigen från vårt huvudförråd med den senaste stabila versionen som finns tillgänglig:

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

Det finns flera olika installationsmetoder med hjälp av din systempakethanterare, titta bara på installationssidan i wiki.

Nu kan du gå till Wikisidorna Kommandon och Konfiguration för att ytterligare förstå Antigens funktionalitet och anpassning.

Användning

Användningen bör vara mycket bekant för dig om du använder Vundle. En typisk .zshrckan se ut så här:

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

Öppna din zsh med denna .zshrc och du bör se alla buntar som du definierat här, bli installerade. När det är gjort är du redo att köra. Den fullständiga syntaxen för kommandot antigen bundle diskuteras på sidan Kommandon.

För övrigt har avsnittet In the wild wiki fler konfigurationsexempel. Du kan också ta en titt på show off-wikisidan för användning av interaktivt läge.

Meta

Motivation

Om du använder zsh och oh-my-zsh vet du att det inte är särskilt lätt att underhålla att ha många olika plugins som är utvecklade av många olika författare i en enda (sub)repo. Det finns några riktigt fantastiska plugins och verktyg i oh-my-zsh, men att ha dem alla i en enda repo är inte särskilt skalbart. Och jag beundrar robbyrussells insatser för att granska och slå samman det gigantiska antal pull-förfrågningar som projektet får. Vi behöver ett bättre sätt att hantera insticksmoduler.

Detta diskuterades i några frågor, men det verkar inte som om det gjordes några framsteg. Så jag försöker starta detta med Antigen i hopp om att förbättra situationen. Observera att jag inte på något sätt är någon zsh- eller anyshellskript-expert (långt därifrån).

Inspirerad av vundle kan Antigen hämta oh-my-zsh-stilplugins från olika githubrepositories. Du är inte begränsad till att enbart använda plugins från oh-my-zsh-repositoriet och du behöver inte underhålla en egen gaffel och hämta från uppströmsförteckningen då och då. Jag uppmuntrar dig faktiskt att hämta plugins och skript från olika källor, direkt från författarna, innan de ens skickar in det till oh-my-zsh som en apull-förfrågan.

Antigen låter dig också byta prompt-tema med ett enda kommando, bara sådär

antigen theme candy

och din prompt är ändrad, bara för den här sessionen förstås (såvida du inte lägger in den här raden i din .zshrc).

Hjälper till

Vi letar alltid efter nya bidragsgivare! Vi har ett antal frågor markerade som ”Help wanted” som är bra ställen för att hoppa in och komma igång. Ta en titt på vår färdplan för att se framtida projekt och diskutera idéer.

Se till att läsa våra riktlinjer för bidrag för att förstå vårt arbetsflöde och våra kodningskonventioner.

Återkoppling

Alla kommentarer/förslag/återkoppling är verkligen välkomna. Säg gärna hej till oss på Gitter. Öppna ett ärende för att diskutera något (vad som helst!) om projektet ;).

Artiklar

Det finns många artiklar skrivna av Antigen-användare där ute. Se till att kolla in dem på sidan Artiklar.

Plugins och alternativ

Listan awesome-zsh-plugins är en katalog över plugins, teman och alternativ som du kan finna användbara.