Správce zásuvných modulů pro zsh.

Instalace | Dokumentace | Sledování chyb | Plán | Chat | Licence

Antigen je malá sada funkcí, která vám pomůže snadno spravovat zásuvné moduly shellu (zsh), tzv. balíčky. Koncepce je v podstatě stejná jako u svazků v atypickém nastavení vim+pathogen. Antigen je pro zsh tím, čím je Vundle pro vim.

Antigen dosáhl jisté úrovně stability a používá se ve volné přírodě již přibližně několik let. Pokud narazíte na nějaké problémy, otevřete prosím problém.

Antigen pracuje s verzemi zsh >= 4.3.11.

Instalace

Instalace Antigenu z našeho hlavního repozitáře s poslední dostupnou stabilní verzí:

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

Existuje několik způsobů instalace pomocí správce systémových balíčků, stačí se podívat na stránku Instalace wiki.

Nyní můžete zamířit na wiki stránky Příkazy a Konfigurace, abyste dále pochopili funkčnost a přizpůsobení Antigenu.

Použití

Použití by vám mělo být velmi dobře známé, pokud používáte Vundle. Typické .zshrcmůže vypadat takto:

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

Otevřete zsh s tímto .zshrc a měli byste vidět všechny svazky, které jste zde definovali, jak se instalují. Jakmile je to hotovo, můžete začít pracovat. Kompletní syntaxe příkazu antigen bundle je popsána na stránce Příkazy.

V sekci In the wild wiki jsou navíc další příklady konfigurace. Můžete se také podívat na stránku Show off wiki pro použití v interaktivním režimu.

Meta

Motivace

Pokud používáte zsh a oh-my-zsh, víte, že mít mnoho různých zásuvných modulů vyvinutých mnoha různými autory v jednom (pod)repozitáři není příliš snadné na údržbu. Voh-my-zsh je několik opravdu fantastických zásuvných modulů a nástrojů, ale mít je všechny v jednom repozitáři není moc dobře škálovatelné. A obdivuji robbyrussellovo úsilí při revizi a slučování gigantického počtu žádostí o stažení, které projekt dostává. Potřebujeme lepší způsob správy zásuvných modulů.

Toto se probíralo v několika otázkách, ale nevypadá to, že by došlo k nějakému pokroku. Takže se snažím začít s Antigenem,doufám, že se tato situace zlepší. Upozorňuji, že v žádném případě nejsem odborník na zsh nebo jiné shellové skripty (zdaleka ne).

Inspirován vundle, Antigen umí tahat pluginy ve stylu oh-my-zsh z různých githubrepositářů. Nejste omezeni na používání zásuvných modulů pouze z repozitáře oh-my-zsh a nemusíte udržovat vlastní fork a každou chvíli tahat z upstreamu. Vlastně vám doporučuji, abyste přebírali pluginy a skripty z různýchzdrojů, přímo od autorů, ještě předtím, než je odešlou do oh-my-zsh jako apull request.

Antigen také umožňuje přepínat téma promptů jedním příkazem, jen tak

antigen theme candy

a váš prompt je změněn, samozřejmě jen pro tuto relaci (pokud jste tento řádek nevložili do svého .zshrc).

Pomáháme

Vždy hledáme nové přispěvatele! Máme řadu čísel označenýchjako „Help wanted“, která jsou dobrým místem, kde se můžete zapojit a začít. Podívejte se na náš plán, abyste viděli budoucí projekty a diskutovali o nápadech.

Ujistěte se, že jste si přečetli naše pokyny pro přispěvatele, abyste pochopili náš pracovní postup a naše kódovací konvence.

Zpětná vazba

Jakékoli připomínky/návrhy/zpětná vazba jsou opravdu vítány. Pozdravte nás prosím na Gitteru. Oropen an issue to discuss something (anything!) about the project ;).

Articles

Existuje mnoho článků napsaných uživateli Antigenu. Určitě si je prohlédnětena stránce Články.

Zásuvné moduly a alternativy

Seznam awesome-zsh-plugins je adresář zásuvných modulů, témat a alternativ, které by se vám mohly hodit.