Le gestionnaire de plugins pour zsh.

Installation | Documentation | Bug tracker | Roadmap | Chat | Licence

Antigen est un petit ensemble de fonctions qui vous aident à gérer facilement vos plugins shell (zsh), appelés bundles. Le concept est à peu près le même que celui des bundles dans la configuration atypique vim+pathogen. Antigen est à zsh, ce que Vundle est à vim.

Antigen a atteint un certain niveau de stabilité et est utilisé dans la nature depuis environ deux ans. Si vous rencontrez des problèmes, veuillez ouvrir un problème.

Antigen fonctionne avec les versions de zsh >= 4.3.11.

Installation

Installer Antigen à partir de notre dépôt principal avec la dernière version stable disponible:

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

Il existe plusieurs méthodes d’installation en utilisant votre gestionnaire de paquets système, il suffit de regarder la page wiki Installation.

Maintenant vous pouvez vous diriger vers les pages wiki Commandes et Configuration pour mieux comprendre la fonctionnallité et la personnalisation d’Antigen.

Utilisation

L’utilisation devrait vous être très familière si vous utilisez Vundle. Un .zshrc typique pourrait ressembler à ceci:

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

Ouvrez votre zsh avec ce .zshrc et vous devriez voir tous les bundles que vous avez définis ici, s’installer. Une fois que c’est fait, vous êtes prêt à rouler. La syntaxe complète de la commande antigen bundle est discutée dans la page Commandes.

En outre, la section In the wild wiki a plus d’exemples de configuration. Vous pouvez aussi bien jeter un coup d’œil à la page wiki Show off pour l’utilisation du mode interactif.

Meta

Motivation

Si vous utilisez zsh et oh-my-zsh, vous savez qu’avoir de nombreux plugins différents qui sont développés par de nombreux auteurs différents dans un seul (sub)repo n’est pas très facile à maintenir. Il y a des plugins et des utilitaires vraiment fantastiques dans oh-my-zsh, mais les avoir tous dans un seul repo n’est pas vraiment évolutif. Et j’admire les efforts de robbyrussell pour réviser et fusionner le nombre gigantesque de demandes d’annulation que le projet reçoit. Nous avons besoin d’une meilleure façon de gérer les plugins.

Cela a été discuté sur quelques questions, mais il ne semble pas qu’il y ait eu de progrès. Donc, j’essaie de commencer cela avec Antigen, en espérant améliorer cette situation. Veuillez noter que je ne suis en aucun cas un expert en script zsh ou anyshell (loin de là).

Inspiré par vundle, Antigen peut tirer des plugins de style oh-my-zsh de divers githubrepositories. Vous n’êtes pas limité à utiliser les plugins du dépôt oh-my-zsh uniquement et vous n’avez pas besoin de maintenir votre propre fork et de tirer de l’amont de temps en temps. En fait, je vous encourage à récupérer des plugins et des scripts à partir de diverses sources, directement auprès des auteurs, avant même qu’ils ne le soumettent à oh-my-zsh en tant que demande apull.

Antigen vous permet également de changer le thème de l’invite avec une commande, juste comme ça

antigen theme candy

et votre invite est modifiée, juste pour cette session bien sûr (sauf si vous mettez cette ligne dans votre .zshrc).

Aider

Nous sommes toujours à la recherche de nouveaux contributeurs ! Nous avons un certain nombre de questions marquées comme « Help wanted » qui sont de bons endroits pour sauter dans et commencer. Jetez un coup d’œil à notre feuille de route pour voir les projets futurs et discuter des idées.

Veuillez vous assurer de consulter nos directives de contribution pour comprendre notre flux de travail, et nos conventions de codage.

Feedback

Tous les commentaires/suggestions/feedback sont vraiment les bienvenus. N’hésitez pas à nous dire bonjour sur Gitter. Oropen une question pour discuter de quelque chose (n’importe quoi !) sur le projet ;).

Articles

Il y a beaucoup d’articles écrits par des utilisateurs d’Antigen là-bas. Assurez-vous de les consulter dans la page Articles.

Plugins et alternatives

La liste awesome-zsh-plugins est un répertoire de plugins, thèmes et alternatives que vous pouvez trouver utiles.