Aprende-Vim/cap22_paquetes_vim.md

134 lines
5.8 KiB
Markdown
Raw Normal View History

# Capítulo 22. El gestor de complementos de Vim \(Packages\)
2020-11-20 20:12:22 +01:00
En los capítulos anteriores, he mencionado el uso de un gestor externo de complementos para instalar complementos. Desde la versión 8, Vim ya incorpora su propio gestor de complementos llamado _packages_. En este capítulo, aprenderás cómo utilizar este gestor para instalar nuevos complementos.
2020-11-20 20:12:22 +01:00
Para ver si la compilación de Vim que usas tiene la posibilidad de utilizar este gestor propio, ejecuta `:version` y busca el atributo `+packages`. De manera alternativa, también puedes ejecutar `:echo has('packages')` \(si esto devuelve un 1, entonces tu Vim viene con su gestor propio incorporado\).
2020-11-20 20:12:22 +01:00
## El directorio de Pack
2020-11-20 20:12:22 +01:00
Comprueba si tienes un directorio llamado `~/.vim/` en la ruta raíz de tu usuario. Si no lo tienes, crealo. Dentro, crea un directorio llamado `pack` \(`~/.vim/pack/)`. Vim de manera automática sabe que tiene que buscar dentro de este directorio para encontrar los paquetes o complementos.
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
## Dos tipos de cargas
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
El gestor de complementos de Vim tiene dos mecanismos de carga: automático y manual.
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
### Carga automática
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
Para cargar complementos de manera automática cuando arranque Vim, necesitas ponerlos dentro del directorio `start/`. La ruta tendía un aspecto similar a este:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
~/.vim/pack/*/start/
```
2021-03-20 19:53:57 +01:00
Ahora podrías preguntar, "¿Qué significa el símbolo `*` entre `pack/` y `start/`?" `*` es un nombre arbitrario y puede ser cualquier cosa que quieras. Vamos a llamarle `packdemo/`:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
~/.vim/pack/packdemo/start/
```
2021-03-20 19:53:57 +01:00
Ten en cuenta que si lo omites y en vez de eso haces algo así:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
~/.vim/pack/start/
```
El sistema del gestor _package_ no funcionará. Es imperativo el poner un nombre entre `pack/` y `start/`.
Para esta demostración, vamos a tratar de instalar el complemento llamado [NERDTree](https://github.com/preservim/nerdtree). Ve directamente al directorio `start/` \(`cd ~/.vim/pack/packdemo/start/`\) y clona el repositorio NERDTree desde GitHub:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
git clone https://github.com/preservim/nerdtree.git
```
2021-03-20 19:53:57 +01:00
¡Eso es todo! Ya está todo listo. La próxima vez que arranques Vim, podrás ejecutar inmediatamente comandos de NERDTree como `:NERDTreeToggle`.
2020-11-20 20:12:22 +01:00
Puedes clonar tantos repositorios de complementos como quieras dentro de la ruta `~/.vim/pack/*/start/`. Vim de manera automática cargará cada uno de ellos. Si quieres eliminar el repositorio clonado \(`rm -rf nerdtree/`\), ese complemento no estará disponible en tu Vim nunca más.
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
### Carga manual
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
Para cargar complementos de manera manual cuando arranca Vim, necesitas ponerlos dentro del directorio `opt/`. De manera similar a la carha automática, la ruta tendrá un aspecto similar a este:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
~/.vim/pack/*/opt/
```
2021-03-20 19:53:57 +01:00
Vamos a utilizar el mismo directorio `packdemo/` que hemos usado antes:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
~/.vim/pack/packdemo/opt/
```
Esta vez, vamos a instalar el juego [killersheep](https://github.com/vim/killersheep) \(esto necesita como mínimo Vim 8.2\). Ve al directorio `opt/` \(`cd ~/.vim/pack/packdemo/opt/`\) y clona el repositorio:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
git clone https://github.com/vim/killersheep.git
```
Arranca Vim. El comando para ejecutar el juego es `:KillKillKill`. Trata de ejecutarlo. Vim te avisará de que ese no es un comando válido del editor. Necesitas primero cargar _manualmente_ el complemento. Vamos a hacer eso:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
:packadd killersheep
```
2021-03-20 19:53:57 +01:00
Ahora trata de ejecutar de nuevo el comando `:KillKillKill`. Ahora el comando debería funcionar.
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
Quizás te preguntes, "¿Por qué iba a querer alguna vez cargar manualmente los complementos? ¿No sería mejor que se cargaran automáticamente todos al inicio?".
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
Buena pregunta. A veces hay complementos que no querrás utilizar todo el tiempo, como el juego KillerSheep. Lo más probable es que no necesites cargar 10 juegos diferentes y ralentizar el arranque de Vim. Sin embargo, de vez en cuando si estás aburrido o aburrida, quizás quieras jugar algún juego en Vim. Utiliza la carga manual para complementos que no sean esenciales.
2020-11-20 20:12:22 +01:00
2021-03-20 19:53:57 +01:00
También puedes utilizar esto para para añadir de manera condicional complementos. Quizás tu usas tanto Neovim como Vim y hay complementos optimizados para Neovim. Puedes utilizar algo como esto en tu vimrc:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
if has('nvim')
packadd! neovim-only-plugin
else
packadd! generic-vim-plugin
endif
```
2021-03-20 19:59:06 +01:00
## Organizando el gestor
2020-11-20 20:12:22 +01:00
2021-03-20 19:59:06 +01:00
Recuerda que el requisito para utilizar el gestor de complementos de Vim es tener:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
~/.vim/pack/*/start/
```
2021-03-20 19:59:06 +01:00
O:
2020-11-20 20:12:22 +01:00
```text
2020-11-20 20:12:22 +01:00
~/.vim/pack/*/opt/
```
El hecho que `*` pueda ser _cualquier_ nombre puede ser utilizado para organizar tus complementos. Supongamos que quieres agrupar tus complementos basados en categorías \(colores, sintaxis y juegos\):
2020-11-20 20:12:22 +01:00
```text
2021-03-20 19:59:06 +01:00
~/.vim/pack/colores/
~/.vim/pack/sintaxis/
~/.vim/pack/juegos/
2020-11-20 20:12:22 +01:00
```
2021-03-20 19:59:06 +01:00
Puedes todavía utilizar `start/` y `opt/` dentro de cada uno de los directorios.
2020-11-20 20:12:22 +01:00
```text
2021-03-20 19:59:06 +01:00
~/.vim/pack/colores/start/
~/.vim/pack/colores/opt/
2020-11-20 20:12:22 +01:00
2021-03-20 19:59:06 +01:00
~/.vim/pack/sintaxis/start/
~/.vim/pack/sintaxis/opt/
2020-11-20 20:12:22 +01:00
2021-03-20 19:59:06 +01:00
~/.vim/pack/juegos/start/
~/.vim/pack/juegos/opt/
2020-11-20 20:12:22 +01:00
```
2021-03-20 20:04:52 +01:00
## Añadiendo complementos de la manera más inteligente
2020-11-20 20:12:22 +01:00
2021-03-20 20:04:52 +01:00
Te podrías preguntar que quizás el gestor de complementos de Vim hará que los gestores de complementos más populares como vim-pathogen, vundle.vim, dein.vim o vim-plug se vuelvan obsoletos.
2020-11-20 20:12:22 +01:00
2021-03-20 20:04:52 +01:00
La respuesta es, como siempre, "depende".
2020-11-20 20:12:22 +01:00
2021-03-20 20:04:52 +01:00
Yo todavía utilizo vim-plug porque hace muy sencillo añadir, eliminar o actualizar complementos. Si utilizas muchos complementos, sería más conveniente utilizar un gestor de complementos porque hace sencillo el actualizar muchos de manera simultánea. Algunos gestores de complementos también ofrecen funcionalidades asíncronas.
2020-11-20 20:12:22 +01:00
Si tu eres minimalista, prueba el gestor de complementos propio de Vim, _Vim packages_. Si utilizas complementos de una manera más intensa, deberías considerar el utilizar un gestor de complementos.