vim-plug/lang/spanish

English | Español

Un administrador de plugins minimalista para Vim.

Pros.

• Fácil de iniciar: Un único archivo. Sin código repetido.
• Fácil de usar: Conciso, sintaxis intuitiva
• Instalación/actualización en paralelo Super-rapida (con cualquiera de: +job, +python, +python3, +ruby, o Neovim)
• Crea clones simples para minimizar uso de disco y tiempo de descarga
• Carga a demanda con faster startup time
• Puedes revisar y revertir actualizaciones
• Soporte para branch/tag/commit
• Acciones post-actualización
• Soporte para complementos externos

Instalación

Descarga plug.vim y péguelo en el directorio "autoload".

Vim

Unix

curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

Puede automatizar el proceso poniendo el comando en su archivo de configuración de vim, tal como sugerimos aquí.

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
    ni $HOME/vimfiles/autoload/plug.vim -Force

Neovim

Unix, Linux

sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
       https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'

Linux (Flatpak)

curl -fLo ~/.var/app/io.neovim.nvim/data/nvim/site/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
    ni "$(@($env:XDG_DATA_HOME, $env:LOCALAPPDATA)[$null -eq $env:XDG_DATA_HOME])/nvim-data/site/autoload/plug.vim" -Force

Obteniendo ayuda

• Consulte la página tutorial para aprender las bases de vim-plug
• Consulte las paginas tips y FAQ por problemas comunes y preguntas
• Consulte la página [requisitos] para obtener información sobre depuración y configuraciones probadas
• Cree un issue

Uso

Añada una sección para vim-plug en su ~/.vimrc (o stdpath('config') . '/init.vim' para Neovim)

1. Comience la sección con call plug#begin()
2. Liste los plugins con el comando Plug
3. Finalice la sección con call plug#end() para actualizar &runtimepath e inicializar el sistema de plugin
   • Automáticamente ejecuta filetype plugin indent on y syntax enable. Puede revertir estas configuraciones luego del llamado. ej: filetype indent off, syntax off, etc.

Ejemplo

" Especificar un directorio para plugins
"- Para Neovim: stdpath ('data'). '/plugged'
"- Evite el uso de nombres de directorios estándar de Vim como 'plugin'
call plug#begin('~/.vim/plugged')

" Asegúrese de usar comillas simples


" Notación abreviada; busca https://github.com/junegunn/vim-easy-align
Plug 'junegunn/vim-easy-align'

" Se permite cualquier URL de git válida
Plug 'https://github.com/junegunn/vim-github-dashboard.git'

" Se pueden escribir varios comandos Plug en una sola línea utilizando separadores |
Plug 'SirVer/ultisnips' | Plug 'honza/vim-snippets'

" Carga bajo demanda
Plug 'scrooloose/nerdtree', { 'on':  'NERDTreeToggle' }
Plug 'tpope/vim-fireplace', { 'for': 'clojure' }

" Usando una rama no predeterminada
Plug 'rdnetto/YCM-Generator', { 'branch': 'stable' }

" Usando una versión etiquetada; comodín permitido (requiere git 1.9.2 o superior)
Plug 'fatih/vim-go', { 'tag': '*' }

" opciones del plugin 
Plug 'nsf/gocode', { 'tag': 'v.20150303', 'rtp': 'vim' }


" Plugin fuera de ~/.vim/plugged con una acción post-actualización
Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': './install --all' }

"Plugin no administrado (instalado y actualizado manualmente)
Plug '~/my-prototype-plugin'

" Inicializar el sistema de plugins
call plug#end()

Recargue el .vimrc y ejecute :PlugInstall para instalar los plugins

Comandos

Comando	Descripción
PlugInstall [name ...] [#threads]	Instalar plugins
PlugUpdate [name ...] [#threads]	Instalar o actualizar plugins
PlugClean[!]	Remover plugins sin listar
PlugUpgrade	Actualizar vim-plug
PlugStatus	Verificar el estado de los plugins
PlugDiff	Examinar cambios entre la última actualización y los cambios pendientes
PlugSnapshot[!] [output path]	Generar un script para restaurar el snapshot actual de plugins

Opciones Plug

Opcion	Descripción
branch/tag/commit	Branch/tag/commit del repositorio a usar
rtp	Subdirectorio que contiene Vim Plugin
dir	Directorio personalizado para plugins
as	Usar un nombre distinto para el plugin
do	Acciones post-actualización (string o funcref)
on	Carga bajo demanda: Comandos o asignaciones <Plug>
for	Carga bajo demanda: Tipos de archivo
frozen	No se actualizará a menos que se indique explícitamente

Opciones globales

Bandera	Por defecto	Descripción
g:plug_threads	16	Número por defecto de subprocesos a utilizar
g:plug_timeout	60	Tiempo límite de cada tarea en segundos (Ruby & Python)
g:plug_retries	2	Número de reintentos en caso de timeout (Ruby & Python)
g:plug_shallow	1	Usar clon superficial
g:plug_window	vertical topleft new	Comando para abrir la ventana de <Plug>
g:plug_pwindow	above 12new	Comando para abrir la vista previa de PlugDiff
g:plug_url_format	https://git::@github.com/%s.git	printf formato para crear la URL del repositorio (solo se aplica a los comandos Plug subsiguientes)

Atajos de teclado

• D - PlugDiff
• S - PlugStatus
• R - Reintentar actualizaciones o instalaciones fallidas
• U - Actualizar plugins en el rango seleccionado
• q - Cerrar ventana
• :PlugStatus
  • L - Cargar plugin
• :PlugDiff
  • X - Revertir la actualización

Ejemplo: Una pequeña configuration

call plug#begin()
Plug 'tpope/vim-sensible'
call plug#end()

Carga bajo demanda de plugins

" NERD tree será cargado en la primera invocación del comando NERDTreeToggle
Plug 'scrooloose/nerdtree', { 'on': 'NERDTreeToggle' }

" Múltiples comandos
Plug 'junegunn/vim-github-dashboard', { 'on': ['GHDashboard', 'GHActivity'] }

" Cargado cuando se abre un archivo clojure
Plug 'tpope/vim-fireplace', { 'for': 'clojure' }

" Múltiples tipos de archivos
Plug 'kovisoft/paredit', { 'for': ['clojure', 'scheme'] }

"Carga bajo demanda con ambas condiciones
Plug 'junegunn/vader.vim',  { 'on': 'Vader', 'for': 'vader' }

"Código para ejecutar cuando el plugin se carga de forma diferida a pedido
Plug 'junegunn/goyo.vim', { 'for': 'markdown' }
autocmd! User goyo.vim echom 'Goyo is now loaded!'

La opción for generalmente no es necesaria ya que la mayoría de los plugins para tipos de archivos específicos no suelen tener demasiado código en el directorio plugin. Es posible que desee examinar la salida de vim --startuptime antes de aplicar la opción.

Acciónes post-actualizacion

Hay algunos plugins que requieren pasos extra luego de la instalación o actualización. En esos casos, use la opción do para describir la tarea a ser ejecutada

Plug 'Shougo/vimproc.vim', { 'do': 'make' }
Plug 'ycm-core/YouCompleteMe', { 'do': './install.py' }

Si el valor comienza con :, sera considerado como un comando de Vim

Plug 'fatih/vim-go', { 'do': ':GoInstallBinaries' }

Si usted necesita un mayor control, puede pasarle una referencia a una función Vim que tome un solo argumento

function! BuildYCM(info)
  " info es un diccionario con 3 campos 
  " - name:   nombre del plugin
  " - status: 'installed', 'updated', o 'unchanged'
  " - force: configurado en PlugInstall! o PlugUpdate!
  if a:info.status == 'installed' || a:info.force
    !./install.py
  endif
endfunction

Plug 'ycm-core/YouCompleteMe', { 'do': function('BuildYCM') }

Ambas acciones post-actualización se ejecutan dentro del directorio del plugin y solo se ejecutan cuando el repositorio haya cambiado, pero puede obligarlo a ejecutarse incondicionalmente con los comandos: PlugInstall! Y PlugUpdate!.

Asegúrese de evitar las barras y las comillas dobles cuando escriba la opción do en línea, ya que se reconocen erróneamente como separadores de comandos o como el comienzo del comentario final.

Plug 'junegunn/fzf', { 'do': 'yes \| ./install' }

Pero puede evitar el escape si extrae la especificación en línea usando una variable (o cualquier expresión de Vimscript) de la siguiente manera:

let g:fzf_install = 'yes | ./install'
Plug 'junegunn/fzf', { 'do': g:fzf_install }

PlugInstall! y PlugUpdate!

El instalador toma los siguientes pasos cuando se instala o actualiza un plugin

1. git clone o git fetch desde el origen
2. Verifica ramas, tags o commits y opcionalmente git merge ramas remotas
3. Si el plugin fue actualizado (o instalado por primera vez)
   1. actualiza submódulos
   2. Ejecuta acciones post-actualización

Los comandos con el sufijo ! se aseguran que todos los pasos son ejecutados incondicionalmente

Artículos

• Escribiendo mi propio administrador de plugins para vim
• Plugins de vim y tiempo de inicio
• Pensamientos sobre la dependencia en los plugins de Vim
  • El soporte para Plugfile se ha eliminado desde 0.5.0

Colaboradores

• Jan Edmund Lazo - Soporte de ventanas
• Jeremy Pallats - Instalador de Python

Licencia

MIT