Aprende-Vim/ch20_views_sessions_viminfo.md
2021-03-15 19:17:50 +01:00

13 KiB

Capítulo 20: Vistas, sesiones y Viminfo

Después de haber trabajado en un proyecto durante un tiempo, puedes encontrar que el proyecto de manera gradual va tomando forma con sus propios ajustes, carpetas, buffers, diseños, etc. Es como decorar tu apartamento después de vivir en el durante un tiempo. Es problema es, que cuando cierras Vim, pierdes esos cambios. ¿No sería genial si pudieras mantener esos cambios para que la próxima vez que abras Vim, pareciera que nunca lo hubieras cerrado?

En este capítulo, aprenderás a utilizar las vistas, sesiones y Viminfo para preservar una *instantánea" de tus proyectos.

Vista (View)

Una vista es el subconjunto más pequeño de los tres temas de este capítulo (vista, sesiones, Viminfo). Es una colección de ajustes para una ventana. Si pasas mucho tiempo trabajando en una ventana y quieres preservar los mapas y carpetas, puedes utilizar una vista.

Vamos a crear un archivo llamado foo.txt:

foo1
foo2
foo3
foo4
foo5
foo6
foo7
foo8
foo9
foo10

En este archivo, creamos tres cambios:

  1. En la línea 1, crea un pliegue de texto (fold) manual con zf4j (pliega el contenido de las cuatro líneas siguientes).
  2. Cambia el ajuste de la numeración de las líneas number: setlocal nonumber norelativenumber. Esto eliminará los indicadores de número de la parte izquierda de la ventana.
  3. Crea un mapeado local para bajar dos líneas cada vez que presiones j en vez de solo una línea, mediante :nnoremap <buffer> j jj.

Tu archivo ahora deberá tener un aspecto similar a este:

+-- 5 lines: foo1 -----
foo6
foo7
foo8
foo9
foo10

Configurar los atributos de las vistas

Ejecuta:

:set viewoptions?

De manera predeterminada debería aparecer (aunque tu mensaje podría ser diferente dependiendo de tu archivo vimrc):

viewoptions=folds,cursor,curdir

Vamos a configurar viewoptions. Los tres atributos que quieres mantener son los pliegues de texto (folds), los mapeados y las opciones configuradas de manera local. Si tus ajustes se parecen a los míos, ya tienes la opción folds. Necesitas configurar las vistas para que recuerde las localoptions. Ejecuta:

:set viewoptions+=localoptions

Para aprender qué otras opciones están disponibles para viewoptions, echa un vistazo a :h viewoptions. Ahora si ejecutas :set viewoptions?, deberías ver algo así:

viewoptions=folds,cursor,curdir,localoptions

Guardando las vistas

Con la ventana en la que aparece el archivo foo.txt correctamente plegada y teniendo las opciones de nonumber norelativenumber, vamos a guardas las vistas. Ejecuta:

:mkview

Vim crea un archivo de vistas.

Archivos de vistas

Quizás te preguntes ¿dónde guardó Vim el archivo de las vistas? Para ver donde lo guardó Vim, ejecuta:

:set viewdir?

De manera predeterminada lo hace en esta ruta ~/.vim/view (si tienes un sistema operativo diferente, podría mostrar una ruta diferente. Echa un vistazo a :h viewdir para más información). Si quieres cambiar esa ruta a otro sitio de tu sistema, añade esto en tu archivo de configuración vimrc:

set viewdir=$HOME/tu_ruta/personalizada

Cargando el archivo de vistas

Cierra el archivo foo.txt si todavía no lo has hecho y después vuelve a abrirlo de nuevo. Deberías ver el texto original sin los cambios. Eso es lo esperado.

Para restaurar el estado, necesitas cargar el archivo de vistas. Ejecuta:

:loadview

Ahora en tu archivo deberías ver:

+-- 5 lines: foo1 -----
foo6
foo7
foo8
foo9
foo10

Los pliegues de texto (folds), los ajustes locales y los mapeados locales se han recuperado. Si te das cuenta, también el cursor debería estar en la línea en la que estaba cuando ejecutaste :mkview. Siempre que tengas la opción cursor, las vistas también recuerdan la posición del cursor.

Multiples vistas

Vim te permite guardar hasta un número de 9 vistas (1-9).

Supongamos que quieres hacer un pliegue (fold) adicional (por ejemplo quieres plegar texto de las dos últimas líneas) con :9,10 fold. Vamos a guardar esto como vista 1. Ejecuta:

:mkview 1

Si quieres hacer un pliegue de texto más con :6,7 fold y guardarlo como una vista diferente, ejecuta:

:mkview 2

Cierra el archivo. Cuando vuelvas a abrir foo.txt y quieras cargar la vista 1, ejecuta:

:loadview 1

Para cargar la vista 2, ejecuta:

:loadview 2

Para cargar la vista original, ejecuta:

:loadview

Automatizar la creación de vistas

Una de las peores cosas que te pueden pasar trabajando con Vim es que después de pasar incontables horas organizando un archivo enorme con pliegues de texto, de manera accidental cierres la ventana y pierdas toda la información de los pliegues (folds). Para prevenir esto, quizás quieras crear automáticamente una vista cada vez que cierres un buffer. Para ello añade esto en tu archivo vimrc:

autocmd BufWinLeave *.txt mkview

de manera adicional, podría estar bien el cargar la vista cada vez que abres un buffer:

autocmd BufWinEnter *.txt silent loadview

Ahora no te tienes que preocupar de crear o cargar una vista nunca más cuando estés trabajando con archivos txt. Ten en cuenta que con el paso del tiempo, tu ~/.vim/view podría empezar a acumular muchos archivos de vistas. Es buena idea limpiarlo cada pocos meses.

Sesiones

si una vista guarda los ajustes de una ventana, una sesión guarda la información de todas las ventanas (incluyendo el diseño).

Creando una nueva sesión

Supongamos que estás trabajando con estos 3 archivos en un proyecto llamado foobarbaz:

Dentro de foo.txt:

foo1
foo2
foo3
foo4
foo5
foo6
foo7
foo8
foo9
foo10

Dentro de bar.txt:

bar1
bar2
bar3
bar4
bar5
bar6
bar7
bar8
bar9
bar10

Dentro de baz.txt:

baz1
baz2
baz3
baz4
baz5
baz6
baz7
baz8
baz9
baz10

Vamos a suponer que el diseño de las ventanas es similar al que aparece a continuación (utilizando de manera estratégica para ello split y vsplit):

Session Layout

Para preservar este aspecto, necesitas guardar la sesión. Ejecuta:

:mksession

A diferencia de mkview donde de manera predeterminada guarda la configuración en ~/.vim/view, mksession guarda el archivo de sesión (Session.vim) en el directorio actual. Echa un vistazo al archivo si tienes curosidad de qué guarda dentro Vim.

Si quieres guardar el archivo de sesión en algún otro lugar, puedes pasar un argumento al comando mksession:

:mksession ~/otra/ruta/distinta.vim

Si quieres sobreescribir el archivo de sesión existente, invoca el comando con el símbolo ! (:mksession! ~/otra/ruta/distinta.vim).

Cargando una sesión

Para cargar una sesión existente, ejecuta:

:source Session.vim

¡Ahora Vim vuelve a tener el mismo aspecto que cuando lo cerraste! De manera alternativa también puedes cargar el archivo de sesión desde la terminal:

vim -S Session.vim

Configurando atributos de la sesión

Puedes configurar los atributos que se guardan de las sesiones. Para ver qué es lo que actualmente se está guardando, ejecuta:

:set sessionoptions?

En mi caso aparece lo siguiente:

blank,buffers,curdir,folds,help,tabpages,winsize,terminal

Si no quieres guardar la terminal cuando guardes una sesión, elimina esta opción de la sesión, para ello, ejecuta:

:set sessionoptions-=terminal

Si quiere añadir las options cuando guardes una sesión, ejecuta:

:set sessionoptions+=options

Estos son algunos de los atributos que sessionoptions pueden gestiona:

  • blank almacena las ventanas vacía
  • buffers almacena los buffers
  • folds almacena los plegados de textos
  • globals almacena variables globales (debe comenzar con una letra mayúscula y contener al menos una letra minúscula)
  • options almacena las opciones y mapeados
  • resize almacena las líneas y columnas de las ventanas
  • winpos almacena la posición de las ventanas
  • winsize almacena los tamaños de las ventanas
  • tabpages almacena las pestañas
  • unix almacena archivos en formato Unix

Para consultar la lista completa, echa un vistazo a :h 'sessionoptions'.

Las sesiones son una herramienta útil para preservar los atributos externos de tu proyecto. Sin embargo, algunos atributos internos no se guardan en las sesiones, como las marcas locales, registros, historiales, etc. Para guardarlos, ¡necesitas utilizar Viminfo!

Viminfo

Quizás has notado, que después de copiar una palabra al registro a y salir de Vim, la próxima vez que abras Vim verás que el texto permanece almacenado en el registro. Esto es gracias al trabajo de Viminfo. Sin este, Vim no recordaría el registro después de haber cerrado Vim.

Si utilizas la versión 8 o superior de Vim, este habilita Viminfo de manera predeterminada, ¡así que has estado utilizando Viminfo todo este tiempo sin saberlo!

Quizás te preguntes: "¿Qué guarda Viminfo? ¿Qué tiene de diferente con las sesiones?"

Para utilizar Viminfo, primero necesita tener la funcionalidad +viminfo disponible (:version). Viminfo almacena:

  • El historial de la línea de comando
  • El historial de búsqueda de cadenas de texto
  • El historial de línea de entrada
  • El contenido de los registros no vacíos
  • Las marcas de diversos archivos
  • El archivo de marcas, apuntando a la ubicación en los archivos
  • El último patrón de búsqueda/sustitución (para 'n' y '&').
  • La lista de *buffer
  • Las variables globales

En general, las sesiones almacenan los atributos "externos" y Viminfo los atributos "internos".

a diferencia de las sesiones en donde tenías un archivo de sesión por proyecto, normalmente usarás el archivo Viminfo por equipo. Viminfo es independiente del proyecto.

La ubicación predeterminada para Viminfo en sistemas basados en Unix es $HOME/.viminfo (~/.viminfo). Si utilizas un sistema operativo diferente, la ubicación de Viminfo podría ser diferente. Echa un vistazo a :h viminfo-file-name. Cada vez que haces cambios "internos", como copiar un texto a un registro, Vim automáticamente actualiza el archivo Viminfo.

Asegúrate que tienes activada la opción nocompatible (set nocompatible), de otro modo tu Viminfo no funcionará.

Writing And Reading Viminfo

Although you will use only one Viminfo file, you can create multiple Viminfo files. To write a Viminfo file, use the :wviminfo command (:wv for short).

:wv ~/.viminfo_extra

To overwrite an existing Viminfo file, add a bang to the wv command:

:wv! ~/.viminfo_extra

By default Vim will read from ~/.viminfo file. To read from a different Viminfo file, run :rviminfo, or :rv for short:

:rv ~/.viminfo_extra

To start Vim with a different Viminfo file from the terminal, use the i flag:

vim -i viminfo_extra

If you use Vim for different tasks, like coding and writing, you can create a Viminfo optimized for writing and another for coding.

vim -i viminfo_writing

vim -i viminfo_coding

Starting Vim Without Viminfo

To start Vim without Viminfo, you can run from the terminal:

vim -i NONE

To make it permanent, you can add this in your vimrc file:

set viminfo="NONE"

Configuring Viminfo Attributes

Similar to viewoptions and sessionoptions, you can instruct what attributes to save with the viminfo option. Run:

:set viminfo?

You will get:

!,'100,<50,s10,h

This looks cryptic. Let's break it down:

  • ! saves global variables that start with an uppercase letter and don't contain lowercase letters. Recall that g: indicates a global variable. For example, if at some point you wrote the assignment let g:FOO = "foo", Viminfo will save the global variable FOO. However if you did let g:Foo = "foo", Viminfo will not save this global variable because it contains lowercase letters. Without !, Vim won't safe those global variables.
  • '100 represents marks. In this case, Viminfo will save the local marks (a-z) of the last 100 files. Be aware that if you tell Viminfo to save too many files, Vim can start slowing down. 1000 is a good number to have.
  • <50 tells Viminfo how many maximum lines are saved for each registers (50 in this case). If I yank 100 lines of text into register a ("ay99j) and close Vim, the next time I open Vim and paste from register a ("ap), Vim will only paste 50 lines max. If you don't give maximum line number, all lines will be saved. If you give it 0, nothing will be saved.
  • s10 sets a size limit (in kb) for a register. In this case, any register greater than 10kb size will be excluded.
  • h disables highlighting (from hlsearch) when Vim starts.

There are other options that you can pass. To learn more, check out :h 'viminfo'.

Using Views, Sessions, And Viminfo The Smart Way

Vim has View, Session, and Viminfo to take different level of your Vim environment snapshots. For micro projects, use Views. For larger projects, use Sessions. You should take your time to check out all the options that View, Session, and Viminfo offers.

Create your own View, Session, and Viminfo for your own editing style. If you ever need to use Vim outside of your computer, you can just load your settings and you will immediately feel at home!