The plugin manager for zsh.

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

Antigen er et lille sæt af funktioner, der hjælper dig med nemt at administrere dine shell (zsh)plugins, kaldet bundles. Konceptet er stort set det samme som bundles i atypisk vim+pathogen opsætning. Antigen er for zsh, hvad Vundle er for vim.

Antigen har nået et vist niveau af stabilitet og er blevet brugt i naturen i omkring et par år. Hvis du støder på problemer, bedes du åbne et problem.

Antigen fungerer med zsh-versioner >= 4.3.11.

Installation

Installer Antigen fra vores hovedarkiv med den seneste stabile version tilgængelig:

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

Der er flere installationsmetoder ved hjælp af din systempakkehåndtering, se blot på installations-wikisiden.

Nu kan du gå videre til wikisiderne Commands and Configuration for yderligere at forstå Antigen’s funktionalitet og tilpasning.

Anvendelse

Brugen burde være meget velkendt for dig, hvis du bruger Vundle. En typisk .zshrckan se således ud:

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

Åbn din zsh med denne .zshrc, og du bør se alle de bundles, du definerede her, blive installeret. Når det er gjort, er du klar til at køre. Den komplette syntaks for antigen bundle-kommandoen er beskrevet på siden Kommandoer.

Den komplette syntaks for antigen bundle-kommandoen er beskrevet på siden Kommandoer.

Dertil kommer, at In the wild wiki-sektionen har flere konfigurationseksempler. Du kan lige så godt tage et kig på Show off-wikisiden for brug af interaktiv tilstand.

Meta

Motivation

Hvis du bruger zsh og oh-my-zsh, ved du, at det ikke er særlig let at vedligeholde at have mange forskellige plugins, der er udviklet af mange forskellige forfattere i et enkelt (sub)repo. Der er nogle virkelig fantastiske plugins og hjælpeprogrammer i oh-my-zsh, men at have dem alle i et enkelt repo er ikke særlig godt til at skalere. Og jeg beundrer robbyrussells indsats for at gennemgå og sammenføje det gigantiske antal pull requests, som projektet får. Vi har brug for en bedre måde at administrere plugins på.

Dette blev diskuteret på et par issues, men det ser ikke ud til, at der blev gjort nogen fremskridt. Så jeg forsøger at starte dette med Antigen, i håb om at forbedre denne situation. Bemærk venligst, at jeg på ingen måde er en zsh eller anyshell script ekspert (langt fra det).

Inspireret af vundle, kan Antigen trække oh-my-zsh style plugins fra forskellige githubrepositories. Du er ikke begrænset til kun at bruge plugins fra oh-my-zsh-repositoriet, og du behøver ikke at vedligeholde din egen fork og trække fra upstream i ny og næ. Jeg opfordrer dig faktisk til at hente plugins og scripts fra forskellige kilder, direkte fra forfatterne, før de overhovedet sender det til oh-my-zsh som apull request.

Antigen lader dig også skifte prompt-tema med én kommando, bare sådan

antigen theme candy

og din prompt er ændret, kun for denne session selvfølgelig (medmindre du sætter denne linje i din .zshrc).

Hjælper til

Vi leder altid efter nye bidragydere! Vi har en række emner markeret som “Hjælp søges”, som er gode steder at hoppe ind og komme i gang. Tag et kig på vores køreplan for at se fremtidige projekter og diskutere ideer.

Sørg for at tjekke vores retningslinjer for bidrag for at forstå vores arbejdsgang og vores kodningskonventioner.

Feedback

Alle kommentarer/forslag/feedback er virkelig velkomne. Sig venligst hej til os på Gitter. Oropen et issue for at diskutere noget (hvad som helst!) om projektet ;).

Artikler

Der er mange artikler skrevet af Antigen-brugere derude. Sørg for at tjekke dem ud på siden Artikler.

Plugins og alternativer

The awesome-zsh-plugins list is a directory of plugins, themes and alternatives thatyou may find useful.