Neovim, Instalación y Configuración Básica

Ubuntu

Para tener la última versión hay que agregar la PPA de Neovim. Ejecuta el siguiente comando en la terminal.

sudo add-apt-repository ppa:neovim-ppa/unstable

Luego, hay que actualizar los paquetes e instalar Neovim.

sudo apt-get update
sudo apt-get install neovim

Fedora

Para instalar la última versión de Neovim en Fedora, ejecuta el siguiente comando.

sudo dnf install neovim

Comprobando la instalación

Para comprobar que todo ha salido bien, en la terminal ejecuta el comando nvim.

nvim

Podrás ver la pantalla de bienvenida de Neovim.

Proveedor de portapapeles

Para que Neovim pueda copiar o pegar desde el portapapeles [8] del sistema operativo, hay que instalar un proveedor.

Existen dos alternativas xclip y xsel, ambas muy buenas. A continuación tienes los comandos para instalar alguna de ellas.

Ubuntu:

sudo apt install xclip

sudo apt install xsel

Fedora:

sudo dnf install xclip

sudo dnf install xsel

Interfaces de Python

Algunos plugins hacen uso de la interfaz de python que Neovim provee.

Se hará la instalación para las dos versiones de Python (2 y 3), aunque es seguro no instalar las interfaces de Python 2, porque todos los plugins que se instalarán usan Python 3.

sudo apt install python3-pip

sudo apt install python-pip

python3 -m pip install neovim

python -m pip install neovim

sudo dnf install python

python3 -m pip install neovim

python -m pip install neovim

Manteniendo las interfaces de Python al día

Es recomendable que cada cierto tiempo actualices las interfaces de Python, así estarás al día con lo último que Neovim ofrece a través de su API.

python3 -m pip install --upgrade neovim

python -m pip install --upgrade neovim

Interfaces de Ruby

Al igual que algunos plugins hacen uso de la interfaz de Python, otros usan la interfaz de Ruby.

sudo apt install ruby
sudo apt install ruby-dev

gem install neovim

sudo dnf install ruby
sudo dnf install ruby-devel
sudo dnf install gcc-c++
sudo dnf install redhat-rpm-config

gem install neovim

Modos

Neovim tiene 3 modos principales:

• Modo normal - Donde todas las teclas son interpretadas como comandos.

• Modo insertar - Donde puedes escribir todo lo que teclees.

• Modo visual - Donde puedes seleccionar bloques de texto.

Para entrar y salir de cada modo:

• Para entrar al modo insertar, presiona i.

• Para salir del modo insertar, presiona Esc

• Para entrar al modo visual, presiona v.

• Para salir del modo visual, presiona Esc

Cuando abres Neovim, el modo por defecto es el normal.

Abrir un archivo

Puedes abrir un archivo desde la terminal con:

nvim mi-archivo.txt

Moviéndote por el editor

Antes había dicho que puedes usar las teclas direccionales para moverte, pero no es lo más eficiente cuando usas Neovim, las teclas direccionales están lejos de tu home row [7]. Puedes usar las siguientes teclas para moverte dentro del modo normal.

• h - izquierda

• j - abajo

• k - arriba

• l - derecha

También puedes usar w y b para moverte entre palabras.

Al principio va a ser duro no hacerlo con las teclas direccionales, intenta practicar hasta que te sientas cómodo, y no llegar a perder la cabeza o las teclas.

Escribir sobre un archivo

Para empezar a escribir debes ingresar al modo insertar con i. Observa como la forma del cursor ha cambiado, ingresa algún texto y cuando termines presiona Esc para volver al modo normal.

Guardar

En modo normal presiona :, escribe w y presiona enter.

Salir

En modo normal presiona :, luego escribe q y presiona enter (para salir sin guardar los cambios, debes escribir q!).

Seleccionar texto

Presiona v para entrar al modo visual, mueve el cursor para realizar la selección. Presiona Esc para regresar al modo normal.

Copiar & pegar

Selecciona un texto usando el modo visual, luego presiona y. Presiona p para pegar después del cursor o P para pegar antes del cursor.

Para copiar una palabra, en modo normal presiona yiw o para copiar la línea actual presiona yy.

Cortar

Selecciona un texto usando el modo visual, luego presiona d. Para cortar una palabra, en modo normal presiona diw o para cortar la línea actual presiona dd.

Para pegar el texto cortado, presiona p.

Copiar y pegar desde el portapapeles

Si intentaste pegar texto fuera de Neovim, o pegar algo que habías copiado al portapapeles, te habrás dado cuenta que no funciona. Para usar el portapapeles debes copiar usando "+y, y para pegar desde el portapapeles "+p.

Deshacer y rehacer

Para deshacer, en modo normal presiona u; y para rehacer Ctrl + r.

Auto completado

Mientras estás en modo insertar, escribe el inicio de una palabra y presiona Crtl + p o Ctrl + n para iterar sobre las sugerencias.

Modo línea de comandos

Neovim tiene otro modo, el modo línea de comandos. Aparece debajo del editor donde puedes ingresar un comando, luego de ejecutarlo (con Enter) el editor retorna al modo normal.

¿Te suena familiar, no?, ¡ya lo has usado para guardar y salir! Para ingresar a este modo teclea : desde el modo normal.

De ahora en adelante cuando veas caracteres precedidos de : sabrás que me refiero a que ejecutes un comando en el modo línea de comandos. Por ejemplo para guardar :w.

Trabajando con varios archivos

Para trabajar con varios archivos solemos usar pestañas, Neovim tiene pestañas, pero no son exactamente lo mismo que en los demás editores [9], en su lugar usaremos buffers.

Podemos abrir varios archivos desde la terminal con:

nvim archivo-uno.txt archivo-dos.txt

O si ya tienes Neovim abierto, puedes usar el comando :e <archivo>, por ejemplo :e archivo-uno.txt.

Podrá parecer que no hay otro archivo abierto, pero lo hay. Puedes listar todos los buffers con :ls; para cambiar al siguiente buffer usa :bnext y para el anterior :bprevious; para cerrar el buffer actual :bdelete.

Buscar

En modo normal presiona /, ingresa la palabra a buscar y presiona Enter. Muévete a la siguiente o anterior coincidencia con n y N.

Obteniendo ayuda

Para obtener ayuda puedes usar el comando :help [tema], por ejemplo :help :w para obtener ayuda sobre el comando :w.

Aprendiendo desde Neovim

Neovim incluye un tutorial interactivo, ejecuta el comando :Tutor para empezarlo.

init.vim

Este archivo se localiza en ~/.config/nvim/init.vim, si no existe, créalo.

cd ~/.config/
mkdir nvim
touch nvim/init.vim

Abre el archivo y agrega la línea:

set number

Para que los cambios tengan efecto debes volver a abrir Neovim, o puedes ejecutar el commando :so ~/.config/nvim/init.vim.

El archivo de configuraciones puede llegar a ser muy grande, así que trata de documentar todo lo que pongas sobre este (puedes agregar comentarios con "), y no copies y pegues cualquier configuración sin entenderla, así tendrás un init.vim ordenado.

A continuación tienes un init.vim con algunas configuraciones mínimas.

Ocultar la barra de menú

La barra de menú que ves es la de tú terminal, no la de Neovim.

Accede al menú Editar y selecciona Preferencias. En la pestaña General desmarca Mostrar la barra de menús en las terminales nuevas por omisión.

Ocultar las barras de scroll

Cuando abres Neovim verás las barras de scroll horizontal y vertical de tu terminal, pero si intentas usarlas, podrás darte cuenta que no funcionan como esperas.

Abre el menú de opciones de tú terminal y ve a Perfiles y a Preferencias del perfil. Dirígete a la pestaña Desplazamiento y desmarca la opción Mostrar barra de desplazamiento.

Tipo y tamaño de letra

Para cambiar el tipo y tamaño de la letra de Neovim, basta con cambiarla en la terminal.

Abre el menú de opciones de tú terminal y ve a Perfiles y a Preferencias del perfil. En la pestaña General marca Tipo de letra personalizado, y selecciona el tipo y tamaño de letra.

Tutoriales online

• Learn vim progressively

• Vim Tips & Tricks

• Learn X in Y minutes

Cheat Sheets

• Graphical vi-vim Cheat Sheet and Tutorial

• A Great Vim Cheat Sheet

Vídeos

• Vim casts

• Vim meetups

Libros

• Vim for humans

• Vim Galore

• Learn Vimscript the Hard Way

Vídeo juegos

• Vim adventures

Artículos

• Moving to Neovim from Vim

Dotfiles

Los dotfiles no son más que archivos de configuración (que usualmente empiezan con un ., de ahí su nombre). En varios dotfiles podrás encontrar configuraciones para Vim/Neovim que podrían serte útiles.

• Dotfiles en GitHub

• Mis dotfiles