En los capitulos anteriores has aprendido sobre como usar el editor de textos VIM. Esto es genial, pero no es todo. Para usar Vim de una manera efectiva, vas a necesitar aprender como configurarlo. El mejor lugar para empezar es tu vimrc. TBC
En los capitulos anteriores aprendiste a usar Vim. En este capítulo, vas a aprender como organizar y configurar vimrc.
El uso convencional de vimrc es agregar el archivo `.vimrc` en la carpeta de usuario `~/.vimrc` (esto puede ser diferente dependiendo del Sistema Operativo).
Cuando inicias Vim, se van a verificar estos 6 lugares en ese orden, buscando el archivo vimrc. El primer lugar con este archivo va a ser usado y los posteriores son ignorados.
Primero Vim va a buscar `$VIMINIT`. Si no hay nada ahí, Vim va a buscar `$HOME/.vimrc`. Si no hay nada ahí, Vim va a buscar `$HOME/.vim/vimrc`. Si Vim lo encuentra va a dejar de buscar y usar `$HOME/.vim/vimrc`.
La primer ubicacion, `$VIMINIT`, es una variable de entorno. No esta definido de manera predeterminada. Se puede usar `~/dotfiles/testvimrc` como variable `$VIMINIT` , puede crearse una variable de entorno con la ubicación de este archivo. Después de ejecutar `export VIMINIT='let $MYVIMRC="$HOME/dotfiles/testvimrc" | source $MYVIMRC'`, Vim va a usar el archivo `~/dotfiles/testvimrc` como su archivo vimrc.
La segunda ubicacion, `$HOME/.vimrc`, es el path usado por muchos usuarios de Vim de manera convencional. `$HOME` es en muchos casos el directorio del usuario (`~`). Si existe `~/.vimrc`, Vim va a usar esta como su archivo vimrc.
El tercer lugar es para `$HOME/.vim/vimrc`, esta alojado dentro del directorio `~/.vim`. You might have the `~/.vim` directory already for your plugins, custom scripts, or View files. Note that there is no dot in vimrc file name (`$HOME/.vim/.vimrc` won't work, but `$HOME/.vim/vimrc` will).
El sexto, `$VIMRUNTIME/defaults.vim` es el predeterminado al compilar Vim. En mi caso, tengo instalado Vim 8.2 usando Homebrew (en MAC), entonces el path es (`/usr/local/share/vim/vim82`). Si Vim, en ninguna de las 5 ubicaciones encuentra el archivo vimrc, entonces usará este archivo.
La respuesta es, "cualquier cosa que quieras". La tentacion de copiar y pegar el vimrc de otras personas es real, pero debes evitar esto. Si insistes en usar el vimrc de alguien más, revisá que sabes lo que esto hace, porqué y cómo él/ella usa esto, y lo más importante, si es relevante para tí. Solo porque alguien mas lo use no quiere decirque tu tambien lo vas a usar.
En los capítulos anteriores, mencionamos diferentes complementos, como ser [fzf.vim](https://github.com/junegunn/fzf.vim), [vim-mundo](https://github.com/simnalamburt/vim-mundo) y [vim-fugitive](https://github.com/tpope/vim-fugitive).
Hace 10 años, manejar los complementos era una pesadilla. Sin embargo, con la llegada de modernos gestores de complementos, instalarlos hoy se puede hacer en segundos. Actualmente utilizo [vim-plug](https://github.com/junegunn/vim-plug) como mi gestor de complementos, por esto lo usaré en esta sección. El concepto es similar al de otros gestores de complementos populares. La recomendación es que revises los disponibles, como ser:
Para agregar nuevos complementos, escriba el nombre del mismo (`Plug 'github-username/repository-name'`) entre las lineas `call plug#begin()` y `call plug#end()`. Por ejemplo, si quiere instalar `emmet-vim` y `nerdtree`, agregue las siguientes lineas en su archivo ~/.vimrc:
En el futuro, si necesita remover los complementos que no utiliza, solo necesita remover el complemento del bloque escrito anteriormente, guardar, releer el archivo de configuracion ( con `:source %} ) y ejecutar el comando `PlugClean` para eliminarlo de su PC.
Vim 8 tiene su propio gestor de paquetes. Puedes consultar la ayuda con `:h packages` para mas información. En el próximo capítulo, vamos a mostrar como usarlo.
Es comun ver muchas opciones que empiezan con `set` en cualquier vimrc. Si ejecutas la linea en el modo linea de comandos, esta configuración no será permanente. Se perderán las mismas al cerrar Vim. Por ejemplo, en vez de ejecutar `:set relativenumber number` desde el modo linea de comandos cada vez que inicias Vim, se puede agregar dentro del archivo .vimrc:
Algunas veces es requerido pasar algún valor, como ser `set tabstop=2`. Revise la página de ayuda para cada configuración para aprender que tipo de valores acepta.
Tambien se puede usar `let` en cambio de `set` (verifique anteponer el mismo con `&`). Con `let`, se puede usar espresiones como un valor. Por ejemplo, para configurar la opción `'dictionary'` a un directorio solo si ese directorio existe:
Si se quiere restringir el número de argumentos, se puede pasar el flag `-nargs`. Use `-nargs=0` para que no se puedan pasar argumentos, `-nargs=1` para pasar un argumento, `-nargs=+` para pasar por lo menos un argumento, `-nargs=*` para pasar cualquier cantidad de argumentos, y `-nargs=?` para pasar 0 ó un argumento. Si quiere pasar n argumentos, use `-nargs=n` (donde `n` es un entero).
`<args>` tiene dos variantes: `<f-args>` y `<q-args>`. El primero es para pasar argumentos a una función VimScript. El ultimo es usado para convertir la entrada del usuario en strings.
En el primero, se mapea la combinacion de teclas `Ctrl-F` para el plugin [fzf.vim](https://github.com/junegunn/fzf.vim) al comando `:Gfiles` (que busca rapidamente por archivos en un repositorio git). En el segundo, se mapea la combinación `<Leader>tn` para llamar a la función personalizada `ToggleNumber` (que cambia entre si las opciones `norelativenumber` y `relativenumber`). La combinación `Ctrl-F` mapea y sobreescribe la función nativa de Vim para moverse en la pantall. El mapeo va a sobreescribir los controles de Vim si entran en conflicto. En mi caso, como nunca uso esta característica, he decidido que es conveniente sobreescribirla.
Por otro lado, a mi personalmente me gusta usar la tecla espaciadora que se escribe como `<Space>` como mi tecla para llamar a estos mapeos, conocida como "leader key" en inglés, para usarla, agregar esto en el archivo vimrc:
Como mínimo, se podría haber usado `nmap` en vez de `nnoremap` (`nmap <silent><C-f> :Gfiles<CR>`). Igualmente, es una buena práctica el usar la variante que no es recursiva para prevenir potenciales loops infinitos al ejecutar el comando.
Esto es lo que podria haber pasado si no se usa el mapeo no recursivo. Supongamos que se quiere agregar el mapeo `B` para agregar el punto y coma (;) al final de la linea, luego, volver una palabra hacia atrás (rellamamos a `B`que en el modo normal vuelve para atrás una palabra tal como necesitamos).
Cuando se presiona `B` ... ouch! Vim agrega de manera descontrolada `;` (se puede interrumpir presionando `Ctrl-C`). ¿Porque pasó esto? Porque en el mapeo `A;<esc>B`, la letra `B` no hace referencia a la función nativa de Vim que es volver una palabra hacia atrás, porque se esta refiriendo a la función mapeada que actualmente es:
Ahora, intente llamar a `B`. Esta vez si va a agregar al final de la linea `;` y volver una palabra antes. El `B` en este mapeo representa al mapeo original de Vim al llamar a la función `B`.
Vim tiene diferentes mapeos para diferentes modos. Si quiere crear un mapeo para el modo de insersión para salir del mismo cuando presiona `jk`:
Los otros modos son: `map` (Normal, Visual, Select, and Operator-pending), `vmap` (Visual y Select), `smap` (Select), `xmap` (Visual), `omap` (Operator-pending), `map!` (Insert y Command-line), `lmap` (Insert, Command-line, Lang-arg), `cmap` (Command-line), and `tmap` (terminal-job). No vamos a cubrirlos en detalle. Para aprender más de ellos ejecute `:h map.txt`.
Puedes separar tu vimrc en multiples archivos usando el comando de Vim `source`. Este comando lee los comandos que hay en el archivo utilizado como argumento.
Vamos a crear dentro del la carpeta `~/.vim`y vamos a llamarla `/settings` (`~/.vim/settings`). El nombre en sí es arbitrario y lo puedes llamar como quieras.
Con esta configuración, facilmente ahora vez a donde hay que ir. Si necesita agregar mapeos, agregarlos en el archivo `/mappings.vim`. En el futuro, siempre se peude agregar mas directorios mientras el archivo vimrc crece. Por ejemplo si se necesita crear una configuracion para el color del tema, se puede agregar al archivo `~/.vim/settings/themes.vim`.
Si la preferencia es tener un solo archivo vimrc para que sea portable, se puede usar el plegado para mantener todo organizado. Agregue esto al inicio de su archivo vimrc:
Vim puede detectar que tipo de archivo hay en el buffer actual (con `:set filetype?` puede comprobarlo). Si este es un archivo del tipo `vim`, se puede usar el método de plegado. El metodo de plegado utiliza `{{{` y `}}}` para indicar el inicio y el final de un grupo que se esta plegando.
Vimrc es un componente importante de la configuración de Vim. Una buena manera de empezar a crear su vimrc es leyendo los vimrcs de otras personas y de manera gradual ir creando el suyo a travéz del tiempo. El mejor vimrc no es el que usa el desarrollador X, es el que esta configurado de la manera que mejor encaja a su pensamiento y a su forma personal de editar.
