diff options
Diffstat (limited to 'vim73/doc/usr_21.esx')
| -rw-r--r-- | vim73/doc/usr_21.esx | 530 |
1 files changed, 530 insertions, 0 deletions
diff --git a/vim73/doc/usr_21.esx b/vim73/doc/usr_21.esx new file mode 100644 index 0000000..902dc4b --- /dev/null +++ b/vim73/doc/usr_21.esx @@ -0,0 +1,530 @@ +*usr_21.esx* Para Vim version 7.3. Último cambio: 9/11/2008 + + MANUAL DE USUARIO DE VIM - por Bram Moolenaar + + Abandonar el editor y volver + + +Esta capítulo versa acerca del uso combinado de otros programas con Vim, +bien ejecutando el programa desde Vim o bien cerrándolo para volver más +tarde. Más aún, esto explica las maneras de recordar el estado de Vim para +restaurarlo más tarde. + +|21.1| Suspender y continuar +|21.2| Ejecutar órdenes de consola +|21.3| Recordar información; viminfo +|21.4| Sesiones +|21.5| Vistas +|21.6| «Modelines» + + Capítulo siguiente: |usr_22.esx| Encontrar el archivo a editar + Capítulo anterior: |usr_20.esx| Teclear con rapidez órdenes de consola +Tabla de contenidos: |usr_toc.esx| + +============================================================================== +*21.1* Suspender y continuar + +Al igual que la mayoría de programas Unix, puede suspender Vim pulsando +CTRL-Z. Esto cierra Vim y le devuelve a la consola desde la cual se +inicio. Puede entonces ejecutar cualquier número de órdenes hasta que se +aburra. Una vez que haya acabado, vuelva a Vim con la orden «fg». + + CTRL-Z + {cualquier secuencia de órdenes de consola} + fg + +Ahora está en el punto en que abandonó Vim, nada ha cambiado. + En caso de que CTRL-Z no funcione, puede también usar «suspend» +¡No se olvide de devolver Vim a primer plano, o perderá todos los cambios +realizados. + +Solo Unix es compatible con esta función. Vim iniciará una consola +en otros sistemas. Esto también tiene la funcionalidad de permitirle +ejecutar órdenes de consola. +Pero esta es una nueva consola, no desde la que inició Vim. + Cuando está ejecutando la interfaz gráfica no puede volver a la consola +desde la que se inició Vim. En esta situación, CTRL-Z minimizará la ventana +de Vim. + +============================================================================== +*21.2* Ejecutar órdenes de consola + +Use «:!{orden}» para ejecutar una sola orden de consola desde Vim. Por +ejemplo, para ver el listado de un directorio: > + + :!ls + :!dir + +El primero es para Unix, el segundo para MS-Windows. + Vim ejecutará el programa. Cuando finalice, obtendrá un dialogo para +pulsar <Intro>. Esto le permite ver la salida de la orden antes de volver +al texto que estaba editando. + El signo «!» también se usa en otros sitios cuando se ejecuta un programa. +Veamos com funciona esto de una manera general. + + :!{programa} execute {programa} + :r !{programa} execute {programa} y lea su salida + :w !{programa} execute {programa} y envíe texto a su entrada + :[range]!{programa} filtra texto a través de {programa} + +Nótese que la presencia de un rango antes de «!{programa}» marca una gran +diferencia. Sin él, ejecuta el programa de manera normal, con el rango se +filtran un número de líneas a través del programa. + +Es imposible ejecutar una fila de programas de esta manera. Pero una consola +es mejor para estas funciones. Puede iniciar una nueva consola de la +siguiente manera: > + + :shell + +Esto es parecido al uso de «CTRL-Z» para suspender Vim. La diferencia es que +se inicia una nueva consola. + +Al usar la GUI, la consola usará la ventana de Vim para entrada y salida. Ya +que Vim no es una terminal, esto no funcionará perfectamente. +Si tiene un problema, pruebe a conmutar la opción 'guipty'. Si esto tampoco +funciona, inicie una nueva terminal para iniciar el intérprete de órdenes. +Por ejemplo, con: +> + :!xterm& + +============================================================================== +*21.3* Recordar información; viminfo + +Tras llevar un rato editando, tendrá texto en los registros, marcas en +varios archivos, y un histórico de la línea de órdenes con órdenes +compuestos cuidadosamente. ¡Todo esto se pierde al cerrar Vim, pero puede +recuperarlo! + +El archivo viminfo está diseñado para almacenar información del estado: + + Histórico de la línea de órdenes y patrones de búsqueda + Texto en registros + Marcas para varios archivos + La lista de búfers + Variables globales + +Cada vez que cierre Vim, este guardará esta información en un archivo, el +archivo viminfo. Cuando inicie Vim otra vez, leerá el archivo viminfo y +restaurará la información. + +La opción 'viminfo' esta configurada por omisión para almacenar un limitado +número de elementos. Puede que desee configurarlo para que recuerde más +información. Esto se hace con la siguiente orden: > + + :set viminfo=string + +La cadena especifica que guardar. La sintaxis de la cadena es un carácter de +opción seguido de un argumento. Las parejas opción/argumento se separan con +comas. + Explore como puede construir su propia cadena viminfo. Primero, la opción +se usa para especificar de cuantos archivos desea guardar marcas (a-z). +Escoja un bonito número par para esta opción (1000, por ejemplo), Ahora, su +orden presenta este aspecto: > + + :set viminfo='1000 + +La opción «f» controla si se guardan las marcas globales (A-Z y 0-9). Si +esta opción es 0, no se guarda nada. Si es 1 o no especificó una opción «f», +las marcas se guardan. Desea esta función, y por ello ahora obtiene esto: > + + :set viminfo='1000,f1 + +La opción «<» define el número de líneas a guardar por cada registro. Por +omisión, todas las líneas se guardan. Si es 0, nada se guarda. Para evitar +que se añadan miles de líneas a su archivo viminfo (que puede que nunca se +usen, y ralenticen el arranque de Vim) puede usar un máximo de 500 líneas: > + + :set viminfo='1000,f1,<500 +< +Otras opciones que puede que desee usar: + : número de líneas a guardar del histórico de la línea + de órdenes + @ número de líneas a guardar de la línea de entrada del + histórico + / número de líneas a guardar de del histórico de búsquedas + r dispositivos extraíbles, del cual no se guardan marcas + (se puede introducir varias veces) + ! variables globales que comienzan con mayúscula y que no + contienen minúsculas + h desactivar el resaltado de 'hlsearch' al inicio + % la lista de búfers (solo se restaura si inicia Vim + sin argumentos de archivo) + c convertir el texto usando 'encoding' + n nombre usado para el archivo viminfo (tiene que ser la + última opción) + +Para más información, véase la opción 'viminfo' y |viminfo-file|. + +Cuando inicia varias instancias de Vim, la última que cierre guardará su +información. Esto puede causar que se pierda información que otras +instancias anteriores guardaron. + + +VOLVER AL PUNTO EN QUE CERRÓ VIM + +Si esta a medio camino de editar un archivo, y llegan las vacaciones, +cierra Vim y disfruta de la vida, olvidando todo lo respectivo al trabajo. +Vuelva a iniciar Vim pasadas un par de semanas, y teclee: +> + '0 + +Y ya está en el punto en que cerró Vim para así volver a su trabajo + Vim crea una marca cada vez que lo cierra. El último es '0. La posición +La posición a la que '0 apuntaba se convierte en '1. Y '1 se convierte en'2, +y así en adelante. La marca '9 se pierde. + La orden |:marks| es útil para ver a donde le llevarían '0 t '9. + + +VOLVER A UN ARCHIVO + +Si desea volver a un archivo que editó recientemente, pero no al cerrar Vim, +hay una manera un tanto más complicada. Puede ver una lista de archivos +tecleando la orden: > + + :oldfiles +< 1: ~/.viminfo ~ + 2: ~/text/resume.txt ~ + 3: /tmp/draft ~ + +Ahora le gustaría editar el segundo archivo, que está en la lista precedido +por «2:». Teclee: > + + :e #<2 + +En lugar de «:e», puede usar cualquier orden que tiene un nombre de archivo +como argumento, el elemento «#<2» funciona en el mismo lugar que «%» (nombre +del archivo actual) y «#» (nombre de archivo alterno). Puede también dividir +la ventana para editar el tercer archivo: > + + :split #<3 + +Usar #<123 es poco complicado cuando solo quiere editar un archivo. +Afortunadamente, hay una manera más simple: > + +:browse oldfiles +< 1: ~/.viminfo ~ + 2: ~/text/resume.txt ~ + 3: /tmp/draft ~ + -- Más -- + +Obtendrá la misma lista de archivos que con |:oldfiles|. Si desea editar +«resume.txt», pulse primero «q» para detener el listado. Obtendrá un +dialogo: + + Teclee el número y pulse <Intro> (vaciar cancelaciones): ~ + +Teclee «2» y pulse <Intro> para editar el segundo archivo. + +Más información en |:oldfiles|, |v:oldfiles| y |c_#<|. + + +MOVER INFO DE UN VIM A OTRO + +Puede emplear las órdenes «:wviminfo» y «:rviminfo» para guardar y restaurar +la información mientras Vim se está ejecutando. Ésto es útil para +intercambiar los contenidos del registro de dos instancias de Vim, por +ejemplo. En el primer Vim, haga: > + + :wviminfo! ~/tmp/viminfo + +Y en el segundo Vim haga : > + + :rviminfo! ~/tmp/viminfo + +Obviamente, «w» significa «write», y «r», «read». + El caracter «!» se usa por «:wviminfo» para forzar la sobreescritura de +un archivo existente. Cuando se omite, y el archivo existe, la información +es fusionada en el archivo. + El caracter «!» usado por «:rviminfo» significa que se usa toda la +información, y esto puede sobreescribir información ya presente. Sin «!» +sólo se usa la información que no estaba definida. + Estas órdenes se pueden usar también para guardar info y usarlo más tarde. +Puede crear un directorio lleno de archivos «viminfo», cada uno con info +dependiendo del propósito. + +============================================================================== +*21.4* Sesiones + +Suponga que ha estado editando, y que el día llega a su final. Desea +finalizar el trabajo, y continuar en el mismo punto el siguiente día. Puede +hacer esto si guarda su sesión de edición para restaurarlo el siguiente día. + Una sesión de Vim contiene toda la información acerca de qué está +editando. Ésto incluye datos como la lista de archivos, disposición +de la ventana, variables globales, opciones y más información. (Lo que se +recuerda se controla mediante la opción 'sessionoptions', descrita más +abajo. + La siguiente orden crea un archivo de sesión: > + + :mksession vimbook.vim + +Puede usar esta orden para restaurar la sesión más tarde: > + + :source vimbook.vim + +Si desea iniciar Vim y restaurar una sesión específica, puede usar la +siguiente orden: > + + vim -S vimbook.vim + +Esto le dice a Vim que lea un archivo en particular al inicio. La «S» +significa sesión (en realidad, puede introducir cualquier script a Vim con +«-S», por ello también puede significar «source», fuente). + +Las ventanas que estaban abiertas se restauran, con la misma posición y +tamaño que antes. Los mapeados y valores de opciones son también las mismas. + Lo que se restaura exactamente depende de la opción 'sessionoptions'. El +valor predeterminado es «blank,buffers,curdir,folds,help,options,winsize». + + blank mantener ventanas vacías + buffers todos los «buffers», no sólo los de una ventana + curdir el directorio actual + folds plegados, también los manualmente creados + help la ventana de ayuda + options todas las opciones y mapeados + winsize tamaño de ventanas + +Modifique esto según su convenienvia. Para también restaurar el tamaño de la +ventana de Vim use, por ejemplo: > + + :set sessionoptions+=resize + + +SESIÓN AQUÍ, SESIÓN ALLÁ + +La manera obvia de usar sesiones es cuando trabaja en diferenes proyetos. +Suponga que guarda sus archivos de sesión en el directorio «~/.vim». Está +trabajando actualmente en el proyecto «secreto» y tiene que cambiar al +proyecto «aburrido»: > + + :wall + :mksession! ~/.vim/secreto.vim + :source ~/.vim/aburrido.vim + +El primero usa «:wall» para escribir en todos los archivos modificados. +Entonces se guarda la sesión actual, usando «:mksession!». Esto sobreescribe +la sesión anterior. La siguiente vez que cargue la sesión «secreto» podrá +continuar en el punto en que lo dejó, y por último carga la sesión +«aburrido». + +Si abre ventanas de ayuda, divide y cierra varias ventanas, y en general +desordena la disposición de la ventana, puede volver a la última sesión +guardada: > + + :source ~/.vim/aburrido.vim + +Por ello, ahora tiene un completo control sobre continuar en el mismo punto +la siguiente vez que lo abra, guardando la configuración actual en una +sesión, o mantener el archivo de sesión como un punto de partida. + Otra manera de usar sesiones es crear una organización de ventana que le +gusta usar, y guardarla en una sesión. Después podrá volver a este orden +siempre que quiera. + Por ejemplo, esta es una bonita organización que puede usar: + + +----------------------------------------+ + | VIM - main help file | + | | + |Desplazarse: Use las teclas de direcció| + |help.txt================================| + |explorer | | + |dir |~ | + |dir |~ | + |file |~ | + |file |~ | + |file |~ | + |file |~ | + |~/=========|[No File]===================| + | | + +----------------------------------------+ + +Ésta tiene una ventana de ayuda en la parte superior, para que pueda leer +este texto. La estrecha ventana vertical a la izquierda contiene un +explorador de archivos. Este es un complemento de Vim que lista los +contenidos de un directorio. Puede seleccionar qué archivos editar ahí. +Más acerca de esto en el siguiente capítulo. + Puede crear esto con una instancia nueva de Vim con: > + + :help + CTRL-W w + :vertical split ~/ + +Puede redimensionar las ventanas a su gusto. Guarde entonces la sesión con: +> + :mksession ~/.vim/mio.vim + +Ahora puede iniciar Vim con este diseño: > + + vim -S ~/.vim/mio.vim + +Pista: Para abrir un archivo que vea listado en la ventana del explorador en +la ventana vacía, mueva el cursor al nombre del archivo y pulse «O». Pulsar +dos veces con el ratón le daría el mismo resultado. + + +UNIX Y MS-WINDOWS + +Hay gente que tiene que trabajar un día con sistemas MS-WINDOWS y con Unix +al siguiente. Si es uno de ellos, considere añadir «slash» y «unix» a +'sessionoptions'. Los archivos de sesión se guardarán en un formato que les +permita ser usados en ambos sistemas. Esta es una orden para poner en su +archivo vimrc: > + + :set sessionoptions+=unix,slash + +Vim usará el formato Unix, porque Vim para MS-Windows puede leer y escribir +archivos de Unix, pero Vim para Unix no puede leer los archivos de sesión +con formato de MS-Windows. De manera similar, Vim para MS-Windows entiene +los nombres de archivo con «/» como diferentes palabras, pero Vim para Unix +no entiende «\». + + +SESIONES Y VIMINFO + +Las sesiones guardan muchas cosas, pero no la posición de las marcas, +contenidos de registros e histórios de la línea de órdenes. Precisa emplear +«viminfo» para estas cosas. + En la mayoría de las situaciones deseará usar sesiones separadas de +viminfo. +Puede emplear esto para pasar a otra sesión, pero manteniendo el histórico +de la línea de órdenes. También puede copiar el texto de los registros de una +sesión, y pegarlos en otra sesión diferente. + Puede que prefiera mantener el información en la sesión. Tendrá que hacer +ésto usted mismo. Ejemplo: > + + :mksession! ~/.vim/secreto.vim + :wviminfo! ~/.vim/secreto.viminfo + +Y para restaurarlo: > + + :source ~/.vim/secreto.vim + :rviminfo! ~/.vim/secreto.viminfo + +============================================================================== +*21.5* Vistas + +Una sesión guarda el aspecto completo de Vim. Cuando desea guardar sólo las +propiedades de una ventana, use una vista. + El uso de una vista es útil cuando desea editar un archivo de una manera +específica. +Por ejemplo, ha activado el número de líneas con la opción 'number' y +definido algunos plegados. Al igual que con las sesiones, puede guardar esta +vista en el archivo y restaurarla más tarde. En realidad, cuando guarda una +sesión, éste guarda la vista de cada ventana. + Hay dos maneras básicas de usar las vistas. La primera es dejar que Vim +escoja el nombre para el archivo de la vista. Puede restaurar la vista +posteriormente cuando edite el mismo archivo. Para guardar la vista de la +ventana actual: > + + :mkview + +Vim decidirá donde guardar la vista. Cuando más tarde edite el mismo archivo +puede recuperar la vista con esta orden: > + + :loadview + +Fácil, ¿no? + Cuando quiere ver el archivo sin la opción 'number' activada, o con todos +los plegados abiertos, puede definir las opciones para que la ventana +presente ese aspecto. Una vez hecho ésto, guarde ésta vista con: > + + :mkview 1 + +Obviamente, puede recuperar ésto con: > + + :loadview 1 + +Ahora puede pasar de una vista a otra del archivo usando «:loadview» con y +sin el argumento «1». De esta forma, puede guardar hasta diez vistas para el +mismo archivo, uno sin numerar y nueve numerados del 1 al 9. + + +UNA VISTA CON NOMBRE + +La segunda manera básica de usar las vistas se puede hacer guardando la vista +en un archivo con un nombre de su elección. Puede cargar esta vista mientras +edita un archivo distinto. Entonces, Vim pasará a editar el archivo +especificado en la vista. Por ello, puede usar ésto para pasar rápidamente +a editar otro archivo, con todas las opciones definidas tal y como las +guardó. + Por ejemplo, para guardar la vista del archivo actual: > + + :mkview ~/.vim/principal.vim + +Puede restaurarla con: > + + :source ~/.vim/principal.vim + +============================================================================== +*21.6* «Modelines» + +Al editar un archivo en particular, puede que defina opciones específicas +para ese archivo. Teclear estas órdenes es aburrido. Usar una sesión o vista +para editar un archivo no funciona cuando comparte el archivo con varias +personas. + La solución para esta situación es añadir un «modeline» al archivo. Éste +es una línea de texto que le dice a Vim los valores de las opciones para su +uso con este archivo en particular. + Un ejemplo típico es un programa en C en el que introduce los tabulados +como múltiplos de 4. Esto requiere que configure la opción 'shiftwidth' a 4. +Este «modeline» hará esta función: + + /* vim:set shiftwidth=4: */ ~ + +Ponga esta línea como uno de las primeras o cinco últimas líneas en el +archivo. Cuando edite el archivo, notará que 'shiftwidth' se ha definido +con valor de cuatro. Cuando edite otro archivo, esta opción será devuelta +a su valor predeterminado de ocho. + Para algunas líneas, el «modeline» encaja en la cabecera, y por ello puede +ponerlo al inicio del archivo. Para los archivos de texto y otros archivos en +los que el «modeline» se interpone en el camino de los contenidos normales, +póngala al final del archivo. + +La opción «modelines» especifica cuantas líneas son inspeccionadas al inicio +y final del archivo en busca de un «modeline». Para inspeccionar diez +líneas: > + + :set modelines=10 + +Puede usar la opción 'modeline' para desactivar ésto. Haga ésto cuando +trabaje como «root» en Unix, o administrador en MS-Windows; o cuando no +confía en los archivos que está editando: > + + :set nomodeline + +Use este formato para el «modeline»: + + any-text vim:set {opción}={valor} ... : any-text ~ + +«any-text» indica que puede introducir texto antes y después de la parte +que Vim usará. Esto permite que presente el aspecto de un comentario, de la +manera en que se hizo antes con /* y */. + La parte de «vim:» es lo que hace que Vim reconozca esta línea. Debe haber +un espacio en blanco antes de «vim», o «vim» ha de estar al inicio de la +línea. Por ello, usar algo como «gvim» no funcionaría. + La parte entre los dos puntos es una orden «:set». Funciona de la misma +manera que teclear la orden «:set», con la excepción de que tiene que +introducir una barra invertida antes de un colon (de no ser así, se vería +como el final de un «modeline»). + +Otro ejemplo: + + // vim:set textwidth=72 dir=c\:\tmp: use c:\tmp here ~ + +Hay una barra invertida extra antes del primer colon, y por ello se incluye +en la orden «:set». Se ignora el texto antes del segundo colon, y por ello +puede introducir aquí un comentario. + +Para más detalles, véase |modeline|. + +============================================================================== + +Siguiente capítulo: |usr_22.esx| Encontrar el archivo a editar + +Copyright: véase |manual-copyright| vim:tw=78:ts=8:ft=help:norl: + +============================================================================== + +Traducción del capítulo: Omar Campagne Polaino + +Proyecto: |vim-doc-es| + |