vim
Extendiendo Vim

Observaciones

Cómo funcionan los complementos

Un complemento podría presentarse como un solo archivo que contiene 30 líneas de vimscript o como 20 MB de vimscript / python / ruby ​​/ lo que sea dividido en muchos archivos en una docena de directorios que dependen de una serie de herramientas externas.

El primero es obviamente fácil de instalar y administrar, pero el último podría detener un gran desafío.

El principio

La opción 'runtimepath' le dice a Vim dónde buscar los scripts de tiempo de ejecución. El valor predeterminado hace que Vim busque los scripts en los siguientes directorios en orden :

• en sistemas similares a UNIX

  • $HOME/.vim/
  • $VIM/vimfiles/
  • $VIMRUNTIME/
  • $VIM/vimfiles/after/
  • $HOME/.vim/after/

• en Windows

  • $HOME/vimfiles/
  • $VIM/vimfiles/
  • $VIMRUNTIME/
  • $VIM/vimfiles/after/
  • $HOME/vimfiles/after/

De los directorios anteriores, solo instale los complementos en negrita. Los otros causarán inestabilidad por ninguna buena razón. La instalación de un complemento se reduce a colocar cada uno de sus componentes en el directorio correcto debajo de $HOME/.vim/ o $HOME/vimfiles/ .

El metodo manual

Plugin de un solo archivo

Coloque el archivo en $HOME/.vim/plugin o $HOME/vimfiles/plugin

Esto generaría el complemento en el inicio de Vim. Ahora el usuario podría usar todo lo definido en él. Sin embargo, si el complemento necesita activación, el usuario debe ejecutar el comando cada vez que quiera usarlo o agregar el comando a .vimrc

Haz

Un paquete es una estructura de directorio que utiliza el complemento. Se compone de todos los archivos del complemento en los subdirectorios correspondientes.

Para instalar dicho complemento, los subdirectorios deben fusionarse con sus equivalentes en $HOME/.vim/plugin . Sin embargo, este enfoque conduce a la mezcla de los archivos de diferentes complementos en los mismos directorios y posiblemente podría dar lugar a problemas de espacio de nombres.

Otro enfoque es copiar todo el directorio en $HOME/.vim/bundle .

Al usar este enfoque, debe haber al menos un archivo .vim directorio $HOME/.vim/bundle/autoload . Estos archivos serían originados por vim en el inicio.

Nota: Dependiendo del sistema operativo del usuario, el prefijo de todas las rutas puede ser $HOME/vimfiles . Para más detalles vea cómo funcionan los complementos.

VAM

https://github.com/MarcWeber/vim-addon-manager

Vundle

Vundle es un administrador de plugins para Vim.

Instalando Vundle

(Los detalles completos de la instalación se pueden encontrar en el Inicio rápido de Vundle )

1. Instale Git y clone Vundle en ~/.vim/bundle/Vundle.vim .

2. Configure los complementos agregando lo siguiente en la parte superior de su .vimrc , agregando o eliminando los complementos según sea necesario (los complementos en la lista son meramente ilustrativos)

    set nocompatible              " be iMproved, required
    filetype off                  " required
   
    " set the runtime path to include Vundle and initialize
    set rtp+=~/.vim/bundle/Vundle.vim
    call vundle#begin()
    " alternatively, pass a path where Vundle should install plugins
    "call vundle#begin('~/some/path/here')
   
    " let Vundle manage Vundle, required
    Plugin 'VundleVim/Vundle.vim'
   
    " All of your Plugins must be added before the following line
    call vundle#end()            " required
    filetype plugin indent on    " required
    " To ignore plugin indent changes, instead use:
    "filetype plugin on
   
    "place non-Plugin stuff after this line
   

3. Instalar complementos: iniciando Vim y ejecutando :PluginInstall .

Formatos de complementos compatibles

Los siguientes son ejemplos de diferentes formatos soportados. Mantenga los comandos del complemento entre vundle#begin y vundle#end .

Trabajar en una cuenta compartida, por ejemplo, en el nodo principal del clúster puede generar problemas desde el punto de uso del disco por el directorio .vim . Hay un par de paquetes que ocupan una cantidad considerable de espacio en disco, por ejemplo, YCM . Por lo tanto, elija sabiamente su directorio de complementos de Vundle , y es muy fácil hacerlo configurando rtp . Y también si planea instalar cualquier complemento vim, no haga directamente git clone en el directorio del bundle . Utilice la forma Vundle.

El futuro: los paquetes.

Ver :help packages .

Patógeno

vim-pathogen es un administrador de tiempo de runtimepath creado por Tim Pope para facilitar la instalación de complementos y archivos de tiempo de ejecución en sus propios directorios privados.

Instalación de patógeno

1. Coloque el patógeno en ~/.vim/bundle (aquí con Git, pero no es obligatorio):

   git clone https://github.com/tpope/vim-pathogen.git
   

2. Agrega las siguientes líneas a la parte superior de tu .vimrc :

    " enable vim-pathogen
    runtime bundle/vim-pathogen/autoload/pathogen.vim
    execute pathogen#infect()
   

• la directiva de runtime especifica la ruta al script de carga automática de vim-pathogen ;
• execute pathogen#infect() inicia.

Una vez iniciado, Pathogen iniciará automáticamente un barrido a través de las carpetas en ~/.vim/bundle y cargará el complemento desde cada una de ellas.

Usando patogeno

1. Coloque el directorio de nivel superior de su complemento en ~/.vim/bundle/ para que esté disponible la próxima vez que inicie Vim.
2. Ejecutar :Helptags para indexar la documentación de su nuevo complemento.

Beneficios

• Cada complemento reside en su propio directorio en ~/.vim/bundle/ .
• Su .vimrc mantiene limpio de la configuración necesaria para cargar complementos.

El esfuerzo necesario para "administrar" un complemento se reduce así a:

• ponga su directorio de nivel superior bajo ~/.vim/bundle/ para instalarlo ,
• reemplazar su directorio de nivel superior para actualizarlo ,
• eliminar su directorio de nivel superior para desinstalarlo .

La forma en que realice esas tres acciones (manualmente, a través de una herramienta de automatización, con Git / Svn / Hg / lo que sea ...) depende completamente de usted.