El gestor de plugins para zsh.

Instalación | Documentación | Bug tracker | Roadmap | Chat |

Antigen es un pequeño conjunto de funciones que te ayudan a gestionar fácilmente tus plugins de shell (zsh), llamados bundles. El concepto es más o menos el mismo que los bundles en la configuración atípica de vim+pathogen. Antigen es a zsh, lo que Vundle es a vim.

Antigen ha alcanzado un cierto nivel de estabilidad y ha sido utilizado en la naturaleza durante un par de años. Si tiene algún problema, por favor, abra una incidencia.

Antigen funciona con las versiones de zsh >= 4.3.11.

Instalación

Instale Antigen desde nuestro repositorio principal con la última versión estable disponible:

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

Hay varios métodos de instalación utilizando el gestor de paquetes de su sistema, sólo tiene que mirar en la página wiki de instalación.

Ahora puede dirigirse a las páginas wiki de Comandos y Configuración para entender mejor la funcionalidad y personalización de Antigen.

Uso

El uso debería ser muy familiar para usted si utiliza Vundle. Un típico .zshrcpodría verse así:

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

Abre tu zsh con este .zshrcy deberías ver todos los bundles que definiste aquí, instalándose. Una vez hecho esto, usted está listo para rodar. La sintaxis completa para el comando antigen bundle se discute en la página de Comandos.

Además, en la sección wiki In the wild hay más ejemplos de configuración. También puedes echar un vistazo a la página wiki Show offpara el uso del modo interactivo.

Meta

Motivación

Si usas zsh y oh-my-zsh, sabes que tener muchos plugins diferentes que son desarrollados por muchos autores diferentes en un solo (sub)repo no es muy fácil de mantener. Hay algunos plugins y utilidades realmente fantásticos en oh-my-zsh, pero tenerlos todos en un único repositorio no es realmente escalable. Y admiro los esfuerzos de robbyrussell por revisar y fusionar el gigantesco número de peticiones de pull que recibe el proyecto. Necesitamos una mejor manera de gestionar los plugins.

Esto se discutió en algunos temas, pero no parece que se haya hecho ningún progreso. Por lo tanto, estoy tratando de iniciar esto con Antigen, con la esperanza de mejorar esta situación. Por favor, tenga en cuenta que no soy de ninguna manera un experto en zsh o cualquier script de shell (ni mucho menos).

Inspirado por vundle, Antigen puede sacar plugins de estilo oh-my-zsh de varios repositorios de github. No estás limitado a usar plugins del repositorio oh-my-zsh solamente y no necesitas mantener tu propio fork y tirar del upstream de vez en cuando. De hecho, le animo a tomar plugins y scripts de varias fuentes, directamente de los autores, antes de que incluso lo envíen a oh-my-zsh como una solicitud apull.

Antigen también le permite cambiar el tema del prompt con un comando, así

antigen theme candy

y su prompt se cambia, sólo para esta sesión, por supuesto (a menos que ponga esta línea en su .zshrc).

¡Ayudando

Siempre estamos buscando nuevos colaboradores! Tenemos una serie de temas marcados como «Se busca ayuda» que son buenos lugares para saltar y empezar. Echa un vistazo a nuestra hoja de ruta para ver los futuros proyectos y discutir ideas.

Por favor, asegúrate de revisar nuestras directrices de contribución para entender nuestro flujo de trabajo, y nuestras convenciones de codificación.

Comentarios

Cualquier comentario/sugerencia/retroalimentación es realmente bienvenida. Por favor, salúdanos en Gitter. Oropen un tema para discutir algo (¡cualquier cosa!) sobre el proyecto ;).

Artículos

Hay muchos artículos escritos por usuarios de Antigen por ahí. Asegúrese de revisarlos en la página de Artículos.

Plugins y Alternativas

La lista de awesome-zsh-plugins es un directorio de plugins, temas y alternativas que puede encontrar útiles.