O gestor de plugins para zsh.

Instalação | Documentação | Bug tracker | Roadmap | Chat | Licença

Antigen é um pequeno conjunto de funções que o ajudam a gerir facilmente os seus plugins shell (zsh)plugins, chamados bundles. O conceito é praticamente o mesmo que bundles em uma configuração atípica de vim+pathogen. Antigen é para zsh, o que Vundle é para vim.

Antigen atingiu um certo nível de estabilidade e tem sido usado no wildfor por cerca de dois anos. Se você enfrentar algum problema, por favor abra um problema.

Antigen funciona com versões zsh >= 4.3.11.

Instalação

Instalar Antigen do nosso repositório principal com a última versão estável disponível:

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

Existem vários métodos de instalação usando o seu gerenciador de pacotes do sistema, basta olhar na página wiki Instalação.

Agora você pode ir para as páginas wiki de Comandos e Configuração para entender melhor a funcionalidade e personalização do Antigen.

Uso

O uso deve ser muito familiar para você se você usar o Vundle. Um típico .zshrcpode parecer-se com isto:

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

Abra o zsh com isto .zshrc e deverá ver todos os pacotes que definiu em nenhum lugar, ao ser instalado. Uma vez feito isso, você está pronto para rolar. A sintaxe completa para o comando antigen bundle é discutida na página Comandos.

Outras vezes, na seção wiki selvagem tem mais exemplos de configuração. Você pode bem dar uma olhada na página Show off wiki para uso em modo interativo.

Meta

Motivação

Se você usa zsh e oh-my-zsh, você sabe que ter muitos pluginsthat diferentes desenvolvidos por muitos autores diferentes em um único (sub)repo não é veryeasy para manter. Existem alguns plugins e utilitários realmente fantásticos no inoh-my-zsh, mas tê-los todos em um único repo não é realmente uma boa escala. E os esforços de Iadmire Robbyrussell para revisar e fundir o gigantesco número de pedidos que o projeto recebe. Precisamos de uma maneira melhor de gerenciamento de plugins.

Isso foi discutido em algumas questões, mas não parece que houve algum progresso. Então, estou tentando começar isso com o Antigen, esperando melhorar essa situação. Por favor note que eu não sou de forma alguma um especialista em script zsh ou anyshell (longe disso).

Inspirado pelo vundle, Antigen pode puxar plugins estilo oh-my-zsh de vários githubrepositories. Você não está limitado a usar plugins do repositório oh-my-zsh somente e você não precisa manter seu próprio garfo e puxar do upstream everynow e depois. Eu na verdade encorajo você a pegar plugins e scripts de varioussources, diretamente dos autores, antes mesmo de submetê-los ao oh-my-zsh como apull request.

Antigen também permite que você troque o tema do prompt com um comando, assim

antigen theme candy

e seu prompt é alterado, apenas para esta sessão, é claro (a menos que você coloque esta linha no seu .zshrc).

Ajudando

Estamos sempre procurando por novos contribuidores! Temos uma série de questões marcadas como “Ajuda desejada” que são bons lugares para saltar e começar. Dê uma olhada no nosso Roadmap para ver projetos futuros e discutir idéias.

Por favor, certifique-se de verificar nossas diretrizes de contribuição para entender nosso fluxo de trabalho e nossas convenções de codificação.

Feedback

Todos os comentários/sugestões/feedback são realmente bem-vindos. Por favor, diga-nos olá no Gitter. Oropen um número para discutir algo (qualquer coisa!) sobre o projeto ;).

Artigos

Existem muitos artigos escritos por usuários Antigen por aí. Certifique-se de checá-los na página Artigos.

Plugins e Alternativas

A lista de plugins awesome-zsh-plugins é um diretório de plugins, temas e alternativas que você pode achar útil.