zsh-users / antigen

De plugin manager voor zsh.

Installatie | Documentatie | Bug tracker | Roadmap | Chat | Licentie

Antigen is een kleine set functies die je helpen om je shell (zsh) plugins, bundels genaamd, gemakkelijk te beheren. Het concept is vrijwel hetzelfde als bundels in de atypische vim+pathogen setup. Antigen is voor zsh, wat Vundle is voor vim.

Antigen heeft een zeker niveau van stabiliteit bereikt en wordt al een paar jaar in het wild gebruikt. Als u problemen ondervindt, open dan een issue.

Antigen werkt met zsh versies >= 4.3.11.

Installatie

Installeer Antigen vanuit onze hoofd repository met de laatste stabiele versie beschikbaar:

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

Er zijn verschillende installatie methodes met behulp van uw System Package manager, kijk maar eens op de Installatie wiki pagina.

Nu kunt u naar de Commando’s en Configuratie wiki pagina’s gaan om de functionaliteit en aanpassingen van Antigen beter te begrijpen.

Gebruik

Het gebruik zou heel bekend moeten zijn voor u als u Vundle gebruikt. Een typische .zshrc zou er als volgt uit kunnen zien:

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

Open uw zsh met deze .zshrc en u zou alle bundels die u hier gedefinieerd heeft, geïnstalleerd moeten zien worden. Als dat klaar is, ben je klaar om te beginnen. De complete syntax voor het antigen bundle commando wordt besproken op de Commando’s pagina.

Daarnaast heeft de In the wild wiki sectie meer configuratie voorbeelden. U kunt ook een kijkje nemen op de Show off wiki pagina voor interactief gebruik.

Meta

Motivatie

Als u zsh en oh-my-zsh gebruikt, weet u dat het niet eenvoudig is om veel verschillende plugin’s, die door veel verschillende auteurs zijn ontwikkeld, in een enkele (sub)repo te bewaren. Er zitten echt fantastische plugins en utilities in oh-my-zsh, maar ze allemaal in een enkele repo hebben is niet echt schaalbaar. En ik waardeer robbyrussell’s inspanningen voor het nakijken en samenvoegen van het gigantische aantal pull requests die het project krijgt. We hebben een betere manier nodig om de plugin te beheren.

Dit is besproken op een paar issues, maar het lijkt er niet op dat er enige vooruitgang is geboekt. Dus, ik probeer dit op te starten met Antigen, in de hoop deze situatie te verbeteren. Merk op dat ik geen zsh of anyshell script expert ben (verre van dat).

Geïnspireerd door vundle, kan Antigen oh-my-zsh style plugins uit verschillende githubrepositories halen. U bent niet beperkt tot het gebruik van plugins uit de oh-my-zsh repository en u hoeft niet uw eigen fork te onderhouden en zo nu en dan van upstream te halen. Ik moedig u zelfs aan om plugins en scripts van verschillende bronnen te halen, rechtstreeks van de auteurs, voordat ze het zelfs maar als apull request bij oh-my-zsh indienen.

Antigen laat u ook het prompt thema veranderen met één commando, gewoon zo

antigen theme candy

en uw prompt is veranderd, alleen voor deze sessie natuurlijk (tenzij u deze regel in uw .zshrc zet).

Meehelpen

We zijn altijd op zoek naar nieuwe bijdragers! We hebben een aantal kwesties gemarkeerd als “Hulp gezocht” die goede plaatsen zijn om in te springen en te beginnen. Neem een kijkje op onze Roadmap om toekomstige projecten te zien en ideeën te bespreken.

Bekijk ook onze Contributing richtlijnen om onze workflow te begrijpen, en onze codering conventies.

Feedback

Alle commentaar/suggesties/feedback is echt welkom. Zeg ons alsjeblieft gedag op Gitter. Oropen een issue om iets (iets!) over het project te bespreken ;).

Artikelen

Er zijn veel artikelen geschreven door Antigen gebruikers. Bekijk ze op de Artikelen pagina.

Plugins en Alternatieven

De ontzagwekkende-zsh-plugins lijst is een directory van plugins, thema’s en alternatieven die u nuttig zou kunnen vinden.

Geef een antwoord

Het e-mailadres wordt niet gepubliceerd.