You are on page 1of 90

Manual de Kate

Anders Lund Seth Rothberg Dominik Haumann Traductor: Pablo de Vicente Traductor: Miguel Revilla Rodrguez Traductor: Marcos Fouces Lago Traductor: Santiago Fernndez Sancho

Manual de Kate

ndice general
1. Introduccin 2. Los fundamentos 2.1. Iniciando Kate . . . . . . . . . . . . . . . . . . . . 2.1.1. Desde el men . . . . . . . . . . . . . . . 2.1.2. Desde la lnea de rdenes . . . . . . . . . 2.1.2.1. Opciones de la lnea de rdenes 1 2 2 2 2 2 3 4 4 4 6 6 7 7 7 8 8 8 9 9 10 11 11 12 12 13 13 14 14 14

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

2.1.3. Arrastrar y soltar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2. Trabajando con Kate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2.1. Inicio rpido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2.2. Accesos rpidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3. Utilizar sesiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.1. Restaurar el comportamiento de Kate del estilo antiguo . . . . . . . . . . . . 2.4. Obteniendo ayuda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.4.1. En Kate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.4.2. Con sus archivos de texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. Trabajando con KateMDI 3.1. Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.1.1. La ventana principal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.2. 3.3. 3.4. 3.5. El rea del editor . . . . . . . . . . La lista de documentos . . . . . . . El selector de archivos . . . . . . . El emulador de terminal integrado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.6. Herramientas externas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. Trabajando con el editor de Kate 4.1. Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.2. Navegar por el texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3. Trabajando con la seleccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3.1. Uso de la seleccin de bloque . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.3.2. Utilizando la seleccin de sobreescribir . . . . . . . . . . . . . . . . . . . . . 4.3.3. Uso de selecciones persistentes . . . . . . . . . . . . . . . . . . . . . . . . . .

Manual de Kate

4.4. Copiando y pegando texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.5. Buscando y reemplazando texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.5.1. Las barras de bsqueda y reemplazo . . . . . . . . . . . . . . . . . . . . . . . 4.5.2. Bsqueda de texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.5.3. Sustitucin de texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.6. Utilizando los marcadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.7. Ajuste automtico del texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.8. Uso del sangrado automtico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. Trabajando con extensiones 6. Herramientas de edicin avanzadas 6.1. Comentar/descomentar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.2. El componente de la lnea de rdenes del editor . . . . . . . . . . . . . . . . . . . . 6.2.1. rdenes estndar de la lnea de rdenes . . . . . . . . . . . . . . . . . . . . . 6.2.1.1. 6.2.1.2. 6.2.1.3. rdenes para congurar el editor . . . . . . . . . . . . . . . . . . . rdenes para la edicin . . . . . . . . . . . . . . . . . . . . . . . . . Opciones para navegar . . . . . . . . . . . . . . . . . . . . . . . . .

15 15 15 16 16 17 17 18 19 20 20 20 21 21 22 25 26 26 26 27 33 34 34 35 37 37 38 39 41 42 43 44 45 45 46 46 46 47 48

6.3. Utilizar plegado de cdigo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.4. Scripts en el componente de edicin con Javascript . . . . . . . . . . . . . . . . . . . 6.4.1. Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.4.2. El API JavaScript de Kate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.4.2.1. Juntar todo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7. Entradas de men 7.1. El men Archivo . . . 7.2. El men Editar . . . . 7.3. El men Documento . 7.4. El men Ver . . . . . . 7.5. El men Marcadores . 7.6. El men Herramientas 7.7. El men Sesiones . . . 7.8. El men Preferencias . 7.9. El men Ventana . . . 7.10. El men Ayuda . . . . 8. Conguracin de Kate

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

8.1. Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.2. El dilogo principal de conguracin . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3. Conguracin de la aplicacin Kate . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.1. La pgina general . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.2. La pgina de sesiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.3. La pgina Lista de documentos . . . . . . . . . . . . . . . . . . . . . . . . . 4

Manual de Kate

8.3.4. La pgina Extensiones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.5. La pgina Selector de archivos . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.6. La pgina Terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.7. Herramientas externas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.4. La conguracin del componente de edicin . . . . . . . . . . . . . . . . . . . . . . 8.4.1. Aspecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.4.2. Tipos de letra y colores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.4.2.1. 8.4.2.2. 8.4.2.3. 8.4.2.4. 8.4.3. Edicin 8.4.3.1. 8.4.3.2. 8.4.3.3. 8.4.3.4. 8.4.4.1. 8.4.4.2. 8.4.4.3. Colores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tipo de letra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Estilos de texto normal . Estilos de texto resaltado . . . . . . . . . . . . . . . . General . . . . . . . . . . Cursor y seleccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

48 48 48 49 50 50 51 51 51 52 52 52 52 53 54 55 55 55 55 56 56 57 57 57 61 63

Sangrado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Autocompletado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Avanzado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modos y tipos de archivos . . . . . . . . . . . . . . . . . . . . . . .

8.4.4. Abrir y guardar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8.4.5. Accesos rpidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.4.6. Complementos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.5. Conguracin con variables de documentos . . . . . . . . . . . . . . . . . . . . . . 8.5.1. Cmo usa kate las variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. Crditos y licencia A. Trabajo con resaltado de sintaxis A.1. Introduccin . . . . . . . . . . . . . . . . . . A.2. El sistema de resaltado de sintaxis de Kate . A.2.1. Cmo funciona . . . . . . . . . . . . A.2.2. Reglas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

63 64 64 65 65 65 66 66 67 69 69 70 73

A.2.3. Estilos y palabras clave del contexto . . . . . . . . . . . . . . . . . . . . . . . A.2.4. Estilos predeterminados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A.3. El formato XML de denicin de resaltados A.3.1. Introduccin . . . . . . . . . . . . . . A.3.2. Las secciones al detalle . . . . . . . . A.3.3. Estilos predeterminados disponibles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A.4. Reglas de deteccin del resaltado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A.4.1. Las reglas al detalle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A.4.2. Trucos tiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Manual de Kate

B. Expresiones regulares B.1. Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B.2. Patrones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B.2.1. Escape de caracteres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B.2.2. Clases de caracteres y abreviaturas . . . . . . . . . . . . . . . . . . . . . . . . B.2.3. Alternativas: coincidencias con uno de . . . . . . . . . . . . . . . . . . . . B.2.4. Subpatrones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B.2.4.1. Especicacin de alternativas . . . . . . . . . . . . . . . . . . . . . B.2.4.2. Captura del texto coincidente (retroreferencias) . . . . . . . . . . . B.2.4.3. Declaraciones de anticipacin . . . . . . . . . . . . . . . . . . . . . B.2.5. Caracteres con un signicado especial dentro de los patrones. . . . . . . . . B.3. Cuanticadores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B.3.1. Codicia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B.3.2. Ejemplos en contexto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B.4. Declaraciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C. Instalacin D. ndice alfabtico

75 75 76 76 76 78 78 78 78 79 79 79 80 80 81 82 83

B.2.2.1. Caracteres con signicado especial dentro de las clases de caracteres 78

Resumen Kate es un editor de texto para KDE 4 y superiores. Este manual documenta la versin 3.4.0 de Kate

Manual de Kate

Captulo 1

Introduccin
Bienvenido a Kate, un editor de texto para programadores para versiones de KDE 4 o superior. Entre sus muchas caractersticas, Kate incluye el resaltado congurable de sintaxis para lenguajes de programacin como C, C++, HTML e incluso guiones de bash, la posibilidad de crear y mantener proyectos, una interfaz de mltiples documentos (MDI), y un emulador de terminal autocontenido. Pero Kate es ms que un editor para programadores. Su capacidad de abrir varios archivos simultneamente es ideal para editar muchos archivo de conguracin de UNIX. Este documento est escrito con Kate.

Editando este manual...

Manual de Kate

Captulo 2

Los fundamentos
Traductor: Marcos Fouces Lago Si alguna vez ha utilizado un editor de texto, no tendr problema al utilizar Kate. En las siguientes dos secciones, Iniciando Kate y Trabajando con Kate, le mostraremos todo lo que necesita para iniciarse y trabajar rpidamente.

2.1.

Iniciando Kate

Puede iniciar Kate desde el men K o desde la lnea de rdenes.

2.1.1.

Desde el men

Abra el men de programas de KDE pulsando sobre la gran K en la barra de herramientas de la parte inferior izquierda de su pantalla. Al hacerlo aparecer el men de programas. Mueva el cursor hasta el elemento Utilidades Kate - Editor de texto avanzado. A no ser que congure Kate para lo contrario, se cargarn los ltimos archivos que usted edit. Consulte Congurando Kate para saber como activar/desactivar esta caracterstica.

2.1.2.

Desde la lnea de rdenes

Puede iniciar Kate introduciendo su nombre en la lnea de rdenes. Si adems introduce un nombre de archivo, como en el ejemplo de ms abajo, abrir o crear dicho archivo.
%kate miarchivo . txt

Si dispone de una conexin activa, y permiso, puede beneciarse de la transparencia de red de KDE para abrir archivos en Internet.
%kate ftp :// ftp . kde . org / pub / kde / README

2.1.2.1.

Opciones de la lnea de rdenes

Kate acepta las siguientes opciones de la lnea de rdenes: kate --help Muestra una lista de las opciones bsicas disponibles en la lnea de rdenes. 2

Manual de Kate

kate --help-qt Muestra las opciones disponibles para modicar el modo en el que Kate interacta con Qt. kate --help-kde Muestra las opciones disponibles para modicar el modo en el que Kate interacta con KDE. kate -s --start nombre Inicie kate con el nombre de sesin. Si la sesin no existe se crear. Si ya exista una instancia de Kate ejecutndose, se cargarn los archivos correspondientes en esa instancia. Cuando se utiliza la opcin --use, tambin se utilizar una sesin en esta instancia. kate -u --use URL Hace que Kate utilice una instancia existente si existe. Si desea que todos los documentos se abran en una instancia de kate, puede aadir esta opcin a la orden predeterminada en la conguracin de su aplicacin kde, o crear un alias en su intrprete de rdenes si es que lo soporta. kate -p --pid PID Solo reutiliza una instancia con el PID especco (ID del proceso). Se utiliza con la opcin --use. kate -e --encoding codificacin URL Utiliza la codicacin especicada para el documento. kate -l --line lnea URL Se desplaza a la lnea especicada despus de abrir el documento. kate -c --column columna URL Se desplaza a la columna especicada despus de abrir el documento. kate -i --stdin Lee el contenido del documento desde STDIN. Es similar a las opcin - utilizada en muchos programas de lnea de rdenes, y le permite redirigir la salida de las rdenes a Kate. kate --tempfile Desde Kate 2.5.1 est soportada esta opcin estndar de KDE. Cuando se utiliza, los archivos especicados se tratarn como archivos temporales y se borrarn (si son archivos locales y se tiene los permisos sucientes) cuando lo cierre, a menos que se modiquen despus de abrirse. kate --help-all Muestra todas las opciones de la lnea de rdenes. kate --author Muestra una lista de los autores de Kate en la ventana del terminal. kate -v --version Lista la informacin de la versin para Qt, KDE, y Kate. kate --license Muestra informacin de la licencia.

2.1.3.

Arrastrar y soltar

Kate utiliza el protocolo de KDE para arrastrar y soltar. Los archivos pueden arrastrarse y soltarse en Kate desde el escritorio, desde Dolphin o algn ftp remoto abierto en una ventana de Dolphin.

Manual de Kate

2.2.

Trabajando con Kate

El Inicio rpido le mostrar como activar y desactivar cuatro opciones sencillas que le permiten congurar algunas de las propiedades ms potentes de Kate. Accesos rpidos muestra algunos de los accesos rpidos del teclado predeterminados para aquellos que no pueden o no quieren utilizar el ratn.

2.2.1.

Inicio rpido

Esta seccin describir algunos de los elementos en el men de Conguracin de modo que usted puede congurar rpidamente Kate para que trabaje como usted desea. Cuando inicie Kate por primera vez ver dos ventanas con fondo blanco. Por encima de las ventanas hay una barra de herramientas con los iconos etiquetados de la forma habitual. Y por encima de ella, una barra de men. La ventana a la izquierda es una barra lateral que combina las ventanas Documentos y Selector de archivos. Cambie de una a otra pulsando las pestaas a la izquierda de la ventana. Si ha iniciado Kate con un archivo, la ventana de la derecha le mostrar el archivo que est editando, y la de Documentos en la barra lateral, el nombre del archivo. Utilice la ventana Selector de archivos para abrir estos. Puede activar o desactivar las ventanas Documentos y Selector de archivos desde el men Ventana+Vistas de herramientas. Este men le ofrece una primera idea de la potencia y exibilidad de Kate. En esta seccin nos detendremos en tres elementos: Ocultar documentos Muestra u oculta la lista de archivos. Si la ventana de Documentos/Selector de archivos no est abierta, Kate hace aparecer la barra lateral como una ventana independiente. Para anclarla, tome las dos lneas paralelas nas sobre las pestaas pulsando sobre ellas con el botn izquierdo del ratn, y mantngalo pulsado. Arrastre la ventana dentro de la de edicin de Kate y suelte el botn cuando haya posicionado la ventana Documentos/Selector de archivos en el lugar que desee.

SUGERENCIA
Si ha tomado las dos lneas paralelas de modo correcto el puntero de su ratn se convertir en unas echas cruzadas mientras est arrastrando la ventana.

Mostrar navegador del sistema de archivos Muestra u oculta el selector de archivos. Este elemento es el mismo que Mostrar documentos con una diferencia. Al activarlo inicia una ventana con el selector de archivos en la parte superior. Mostrar terminal Muestra u oculta un emulador de consola en la parte inferior de la ventana de Kate. En otras palabras, le ofrece una entrada de lnea de rdenes dentro de la aplicacin.

2.2.2.

Accesos rpidos

Las pulsaciones de teclas (accesos rpidos) de Kate son congurables a travs del men Conguracin. De forma predeterminado Kate soporta las siguientes asociaciones de teclas.

Manual de Kate

Insertar

Flecha izquierda Flecha derecha Flecha arriba Flecha abajo Pgina arriba Pgina abajo Retroceder Inicio Fin Suprimir

Maysculas+Intro

Maysculas+flecha izquierda Maysculas+flecha derecha F1 Maysculas+F1 Ctrl+F F3 Ctrl+B Ctrl+C Ctrl+N Ctrl+P Ctrl+Q Ctrl+R Ctrl+S Ctrl+V Ctrl+X Ctrl+Z Ctrl+Maysculas+Z

Pasa de modo insercin a modo sobreescritura. Cuando est en modo insercin el editor aadir cualquier caracter introducido al texto y empujar los caracteres previamente introducidos a la derecha del cursor de texto. El modo de sobreescritura hace que la entrada de cada caracter elimine el caracter inmediatamente a la derecha del cursor de texto. Mueve el cursor un carcter a la izquierda Mueve el cursor un carcter a la derecha Mueve el cursor una lnea arriba Mueve el cursor una lnea abajo Mueve el cursor una pgina hacia arriba Mueve el cursor una pgina hacia abajo Borra el carcter a la izquierda del cursor Mueve el cursor al comienzo de la lnea Mueve el cursor al final de la lnea Borra el carcter a la derecha del cursor (o cualquier texto seleccionado) Inserta un fin de lnea, con los caracteres de la lnea que no son letras y nmeros delante. Esto es til, por ejemplo, para escribir comentarios al cdigo: Al final de la lnea // un texto pulse este atajo y la siguiente ya empezar con //. As, no necesitar introducir los caracteres de comentario al inicio de cada nueva lnea para comentarios. Marca el texto un carcter a la izquierda Marca el texto un carcter a la derecha Ayuda Qu es esto? Buscar Repetir la bsqueda Insertar un marcador Copiar el texto marcado al portapapeles. Nuevo documento Imprimir Salir - cerrar la copia activa del editor Reemplazar Guardar su archivo. Pegar. Borrar el texto marcado y copiarlo al portapapeles. Deshacer Rehacer

Manual de Kate

2.3.

Utilizar sesiones

Las sesiones es la forma en que Kate le permitir mantener ms de una lista de archivos y conguraciones de interfaz. Puede tener tantas sesiones como desee, y puede utilizar sesiones con nombre o annimas para los archivos que solo desee utilizar una vez. En estos momentos Kate puede guardar la lista de archivos abiertos, y la conguracin de la ventana general en la sesin. En futuras sesiones de Kate se aadirn ms caractersticas que se guardarn en las sesiones. Con la introduccin de sesiones, Kate tambin le permite abrir cualquier nmero de instancias de la aplicacin en lugar de solo una tal y como aparece en el comportamiento predeterminado. Las sesiones se soportan en tres reas: Opciones de lnea de rdenes que le permitir seleccionar e iniciar sesiones cuando inicia kate desde la lnea de rdenes. El men sesiones que le permite cambiar, guardar, iniciar y administrar sus sesiones Opciones de conguracin que le permite decidir cuntas sesiones se deberan utilizar. Cuando se inicia una sesin nueva, se carga la interfaz de conguracin de la Sesin predeterminada. Para guardar la conguracin de la ventana en la sesin predeterminada, necesitar activar el guardado de la conguracin de la ventana en la pgina de conguracin de sesiones del dilogo de conguracin y cargar la sesin predeterminada, pudiendo congurar la ventana nuevamente de acuerdo a sus gustos y guardando nuevamente la sesin. Cuando se cargue una determinada sesin, Kate mostrar el nombre de la sesin al inicio del ttulo de la ventana, que tendr la estructura Nombre de la sesin: Nombre del documento o URL - Kate Cuando se abren archivos desde la lnea de rdenes con la opcin --start nombre o si se ha seleccionado una sesin con el selector de sesiones, se cargar la sesin antes que los archivos especicados en la lnea de rdenes. Para abrir archivos desde ella en una nueva sesin sin nombre, congure kate para iniciar una nueva sesin predeterminada en la pgina de sesin del dilogo de conguracin o utilice --start con una cadena vaca . Desde Kate 2.5.1 el PID de la instancia actual se exporta a la variable de entorno KATE_PID. Cuando se abren archivos desde un terminal Kate seleccionar automticamente la instancia actual si no se indica otra cosa.

2.3.1.

Restaurar el comportamiento de Kate del estilo antiguo

Con la introduccin del uso de sesiones esperamos haber introducido una herramienta sencilla y eciente para trabajar en diferentes reas. Sin embargo, si preere el antiguo comportamiento de Kate (una instancia para abrir todos los archivos), puede utilizar esta estrategia: Haga que kate se inicie siempre con el parmetro --use aadindolo a la orden en las preferencias de la aplicacin, o utilizando un alias de la shell. Congure Kate para cargar la ltima sesin utilizada al inicio. Congurar Kate para guardar la lista de archivo cuando cierre una sesin.Congurar Kate para guardar la lista de archivo cuando cierre una sesin. Cargue la sesin predeterminada una vez

Manual de Kate

2.4.
2.4.1.

Obteniendo ayuda
En Kate

Este manual Ofrece documentacin detallada sobre todas las rdenes de men, opciones de conguracin, herramienta, dilogos, extensiones, etc. as como descripciones de la ventana de Kate, el editor y varios conceptos utilizados en la aplicacin. Press F1 o use el men Ayuda Manual de Kate para ver este manual. Ayuda Qu es esto Qu es esto? ofrece ayuda inmediata sobre elementos aislados de las ventanas grcas, tales como botones u otras reas de ventana. Intentamos proporcionar ayuda del tipo Qu es esto? para cualquier elemento que tenga sentido. Est disponible a travs del dilogo de conguracin, as como de muchos otros dilogos. Para emplear la ayuda Qu es esto?, pulse Maysculas-F1 o utilice la Ayuda Qu es estopara activar el modo Qu es esto. El cursor se transformar en una echa con una interrogacin, de forma que pueda pulsar sobre cualquier elemento de la ventana para leer la ayuda Qu es esto para ese elemento, siempre y cuando est disponible. Botones de ayuda en los dilogos Algunos dilogos tienen un botn Ayuda. Pulsndolo se iniciar KHelpCenter y se abrir la documentacin correspondiente.

2.4.2.

Con sus archivos de texto

Kate no proporciona (todava!) una forma de leer la documentacin asociada a un documento. Dependiendo del archivo que est editando, puede que encuentre til el emulador de terminal para ver pginas de manual de UNIX o la documentacin (info) relacionada, o puede utilizar Konqueror.

Manual de Kate

Captulo 3

Trabajando con KateMDI


Anders Lund Traductor: Marcos Fouces Lago Traductor: Santiago Fernndez Sancho

3.1.

Introduccin

Ventana, Vista, Documento, Marco, Editor... Qu signican en la terminologa de Kate, y como extraer de ellos el mximo rendimiento? Este captulo explicar todo esto y alguna cosa ms.

3.1.1.

La ventana principal

La ventana principal de Kate es una ventana de programa estndar de KDE, con el aadido de barras laterales que contienen vistas de herramientas. Tiene una barra de mens con todos los mens comunes y alguno ms, y una barra de herramientas que proporciona acceso a las rdenes ms usadas. La parte ms importante de la ventana es el rea de edicin, que de forma predeterminada muestra un nico componente de edicin, en el que puede trabajar con sus documentos. Las posibilidades de anclaje de las ventanas se utilizan con las ventanas de herramientas: La lista de documentos El selector de archivos El emulador de terminal integrado Y posiblemente cualquier otra ventana de herramientas, como las que, por ejemplo, proporcionan las extensiones. Las ventanas de herramientas se puede situar en cualquier barra lateral, para mover una herramienta pulse sobre ella y seleccinela en el men del botn derecho Una ventana de herramientas puede marcarse como Persistente en el men del botn derecho de este botn de la barra lateral. La barra lateral puede contener ms herramientas al mismo tiempo, de forma que mientras una herramienta sea persiste se pueden mostrar otras herramientas de manera simultnea.

Manual de Kate

3.2.

El rea del editor

Kate es capaz de tener ms de un documento abierto al mismo tiempo, y tambin es capaz de dividir el rea de edicin en varios marcos, de forma similar a como lo hacen, por ejemplo, Konqueror o el popular editor de textos emacs. De esta forma puede ver varios documentos al mismo tiempo, o incluso varias sesiones del mismo documento, lo que es til, por ejemplo, si su documento contiene deniciones al principio a las que se reere habitualmente a lo largo del texto. O puede ver el cdigo fuente de un programa en un marco, mientras edita el archivo de implementacin en otro. Cuando un documento est disponible en ms de un editor, los cambios hechos en uno de ellos sern reejados en los otros inmediatamente. Esto incluye el cambio de texto, as como su seleccin. Las operaciones de bsqueda o de movimiento del cursor, slo tienen lugar en el editor actual. En este momento no es posible tener abiertas varias sesiones de un mismo documento con la intencin de que los cambios que se produzcan en una no afecten a las dems. Al dividir un editor en dos marcos, ambos son del mismo tamao y muestran el documento que est siendo editado en ese momento. El nuevo marco estar la parte inferior (en el caso de una divisin horizontal) o en la parte derecha (si la divisin es vertical). El nuevo marco estar activo, lo que se representa visualmente por un pequeo indicador verde en dicho marco.

3.3.

La lista de documentos

La lista de archivos muestra una lista de todos los documentos abiertos en Kate. Los archivos modicados tendrn un pequeo icono de un disquete a su izquierda, para indicar su estado. Si hay dos o ms archivos con el mismo nombre abiertos (que pertenezcan a directorios diferentes), al nombre del segundo se le antepondr un <2> y as sucesivamente. La ventana de informacin de archivo mostrar su nombre completo, incluyendo la ruta, permitiendo as que usted elija el archivo que desee. Para mostrar un documento en el marco activo, pinche en la lista el nombre del documento. Puede ordenar la lista de diferentes formas pulsando el botn derecho en la lista y seleccionando la deseada del men Ordenar por. Las opciones son Orden de apertura Muestra los documentos en el orden de apertura Nombre del documento Muestra los documentos por orden alfabtico segn su nombre. URL Muestra los documentos por orden alfabtico segn su URL. Personalizar Personalizar signica que puede arrastrar y soltar elementos en la lista de documentos para ordenarlos manualmente. La lista de documentos mostrar de forma predeterminada su historial, sombreando las entradas de los documentos ms recientes. Si el documento fue editado, se utilizar una combinacin de colores. Los documentos ms recientes tendrn colores ms intensos, de forma que pueda encontrar ms fcilmente los documentos con los que est trabajando. Esta caracterstica se puede desactivar en la pgina Lista de documentos en el dilogo de conguracin. La posicin predeterminada de la lista de documentos en la ventana de Kate es a la izquierda del rea de edicin.

Manual de Kate

3.4.

El selector de archivos

El selector de archivos es un visor de carpetas, que le permite abrir archivos desde la carpeta mostrarda en el marco actual. De arriba hacia abajo, el selector de archivos consta de los siguientes elementos: Una barra de herramientas Contiene los botones de navegacin estndar: Directorio padre Esto hace que la vista de directorios cambie al directorio inmediatamente superior al actual, si es posible. Retroceder Hace que la vista de directorios cambie al directorio mostrado anteriormente. Si no hubiese directorio anterior, este botn permanece desactivado. Adelante Hace que la vista de directorios cambie al siguiente directorio en el historial. Si no hubiese directorio siguiente, este botn permanece desactivado. Inicio Al pulsarlo se situar en su directorio de inicio. Vista resumida Muestra solo los nombres de archivo. Vista detallada Muestra el Nombre, Fecha, Tamao y Tipo de los archivos. Vista de rbol ??? Marcadores Abre un submen para editar o aadir marcadores, y para aadir una carpeta de estos. Directorio del documento activo Este botn har que la vista de directorio cambie al directorio del documento activo si fuera posible. Este botn est desactivado si el documento es nuevo, es un archivo sin guardar, o no se puede decidir el directorio en el que se sita. Una entrada URL Aqu puede teclear la ruta del directorio que desee explorar. La entrada URL mantiene una lista de las rutas introducidas anteriormente. Para elegir una, utilice el botn de la echa que se encuentra en la parte derecha.

SUGERENCIA
La entrada URL completa automticamente los nombres de los directorios. Se puede establecer el mtodo a utilizar pulsando con el botn derecho sobre el texto introducido.

Una vista de directorios Esta es la vista de directorios estndar de KDE. Una entrada para ltros La entrada para ltros permite introducir ltros para los archivos a mostrar en la vista de directorios. El ltro utiliza comodines estndar, los patrones deben estar separados por un espacio en blanco. Ejemplo: *.cpp *.h *.moc Para mostrar todos los archivos, introduzca un solo asterisco *. La entrada para ltros almacena los 10 ltimos ltros introducidos entre las distintas sesiones. Para utilizar uno, pulse el botn de la echa que se encuentra a la derecha y seleccione el ltro deseado. 10

Manual de Kate

3.5.

El emulador de terminal integrado

El emulador de terminal es una copia de la aplicacin de terminal Konsole de KDE, para que su uso le resulte ms cmodo. Est disponible en el men Vistas Vistas de herramientas Mostrar terminal , y pasar a ser la ventana activa cuando se muestre. Adems, si activa la opcin Sincronizar emulador de terminal con el documento activo cuando sea posible cambiar al directorio del documento actual al mostrarse o cambiar este. La posicin predeterminada en la ventana de Kate es en la parte inferior, bajo el rea de edicin. Puede congurar Konsole utilizando su men botn derecho. Para ms informacin consulte el manual de Konsole.

3.6.

Herramientas externas

En el men Herramientas encontrar un submen llamado Herramientas externas. Estas herramientas invocan aplicaciones externas con datos relacionados con el documento actual, como su URL, directorio, texto o seleccin. Las herramientas externas son denidas por el usuario, que puede aadirlas, editarlas o eliminarlas utilizando el panel de conguracin Herramientas externas.

11

Manual de Kate

Captulo 4

Trabajando con el editor de Kate


Anders Lund Dominik Haumann Traductor: Marcos Fouces Lago Traductor: Santiago Fernndez Sancho

4.1.

Introduccin

El editor de Kate es el rea de edicin de la ventana de Kate. Este editor tambin es utilizado por KWrite, y se puede utilizar en Konqueror para mostrar archivos de texto desde su computadora local, o desde la red. El editor est compuesto de los siguientes componentes: El rea de edicin Este es el lugar donde se ubica el texto de su documento. Las barras de desplazamiento Las barras de desplazamiento indican la posicin de la parte visible del documento de texto, y se pueden utilizar para moverse por el documento. Arrastrar las barras de desplazamiento no ocasionar que el cursor de insercin se mueva. Las barras de desplazamiento se muestran y se ocultan segn sea necesario. El borde del icono El borde del icono es un pequeo panel en el lado izquierdo del editor, que muestra un pequeo icono cercano a las lneas marcadas. Puede poner o eliminar un marcador en una lnea visible pulsando con el botn izquierdo del ratn sobre el borde del icono cercano a esa lnea. El borde del icono se puede mostrar/ocultar utilizando el men Ver Mostrar borde de icono. El panel de los nmeros de lneas El panel de los nmeros de lneas muestra los nmeros de lneas de todas las lneas visibles en el documento. El panel de los nmeros de lneas se puede mostrar/ocultar utilizando el men Ver Mostrar nmeros de lnea. El panel de plegado El panel de plegado le permite contraer o expandir los bloques de lneas plegables. El clculo de las regiones plegables se realiza de acuerdo con las reglas de la denicin de la sintaxis de resaltado para el documento. 12

Manual de Kate

TAMBIN EN ESTE CAPTULO : Navegar por el texto Trabajar con la seleccin Copiar y pegar texto Buscar y reemplazar texto Utilizar los marcadores Ajustar texto automticamente Uso del sangrado automtico

4.2.

Navegar por el texto

Moverse por el texto en Kate se realiza de forma similar al resto de editores grcos. Puede desplazar el cursor utilizando las teclas con las echas y las teclas RePg, AvPg, Inicio y Fin en combinacin con los modicadores Ctrl y Maysculas. La tecla Maysculas se utiliza siempre para generar un seleccin, mientras que la tecla Ctrl tiene diferentes efectos en funcin de las teclas: Para las teclas Arriba y Abajo signica desplazamiento y no movimiento del cursor. Para las teclas Izquierda y Derecha signica saltar palabras en lugar de caracteres. Para las teclas RePg y AvPg signica moverse al borde visible de la vista y no del selector. Para las teclas Inicio y Fin signica moverse al principio o al nal del documento en lugar de al principio y al nal de la lnea. Kate tambin le proporciona una forma de ir rpidamente a la pareja de un corchete o parntesis: Site el cursor dentro de un parntesis o corchetes, y pulse Ctrl+6 para ir al parntesis o corchete que hace de pareja. Tambin puede utilizar los marcadores para saltar rpidamente a la posicin para la que lo deni.

4.3.

Trabajando con la seleccin

Hay dos modos bsicos de seleccin de texto en Kate: utilizando el ratn y utilizando el teclado. Para seleccionar usando el ratn, mantenga pulsado el botn izquierdo del ratn mientras arrastra el cursor del ratn desde donde debe comenzar la seleccin, hasta donde desee. El texto se selecciona mientras usted arrastra. Pulsando dos veces sobre una palabra selecciona dicha palabra. Con una triple pulsacin del ratn sobre una lnea, se selecciona sta entera. Si se mantiene pulsada la tecla Maysculas mientras se pulsa con el ratn, se seleccionar el texto: Si no hay nada seleccionado, desde la posicin del cursor hasta la posicin del ratn. Si ya hay una seleccin, desde e incluyendo esa seleccin hasta la posicin del ratn.

13

Manual de Kate

NOTA
Cuando se selecciona texto arrastrando el ratn, el texto seleccionado se copia al portapapeles, y se puede pegar pulsando el botn central del ratn en el editor, o en cualquier otra aplicacin en la que desee pegar el texto.

Para seleccionar usando el teclado, mantenga pulsada la tecla Maysculas mientras utiliza las de navegacin (las teclas de las echas, AvPag, RePag, Inicio y Fin, posiblemente combinadas con Ctrl para extender el movimiento del cursor de texto). Consulte tambin la seccin Navegando por el texto en este mismo captulo. Para Copiar la actual seleccin, utilice el men Editar Copiar o los accesos rpidos del teclado (de forma predeterminada Ctrl+C). Para deseleccionar la actual seleccin, utilice el men Editar Deseleccionar o los accesos rpidos del teclado (De forma predeterminada Ctrl+A), o pulse con el botn izquierdo del ratn en el editor.

4.3.1.

Uso de la seleccin de bloque

Cuando se activa la seleccin de bloque, puede realizar selecciones verticales en el texto, lo que signica que puede seleccionar un nmero determinado de columnas en varias lneas a la vez. Esto es til si trabaja con, por ejemplo, lneas separadas por tabuladores. La seleccin de bloque se puede conmutar en el men Editar Cambiar modo de seleccin de bloque. El atajo de teclado predeterminado es Ctrl+Maysculas+B.

4.3.2.

Utilizando la seleccin de sobreescribir

Si la opcin Sobreescribir selecciones est activada, al escribir o pegar texto sobre una seleccin, esta ser reemplazada. Si no est activado, el nuevo texto se aadir en la posicin del cursor. Sobreescribir selecciones est activado de forma predeterminada. Para modicar esta opcin, utilice la pginaCursor y seleccin del dilogo de conguracin.

4.3.3.

Uso de selecciones persistentes

Si se activan las Selecciones persistentes, el teclear o mover el cursor no provocar que desaparezca la seleccin. Esto signica que puede mover el cursor fuera de la seleccin y escribir. Las selecciones persistentes estn desactivadas de forma predeterminada. Las selecciones persistentes se pueden activar en la pginaCursor y seleccin del dilogo de conguracin.

AVISO
Si estn activadas tanto las selecciones persistentes como la opcin de sobreescribir las selecciones, el escribir o pegar texto cuando el cursor se encuentra dentro de la seleccin, provocar que sta sea reemplazada y deseleccionada.

14

Manual de Kate

4.4.

Copiando y pegando texto

Para copiar texto, utilice la opcin Editar Copiar. Adems el hecho de seleccionar texto con el ratn, provoca que ste sea copiado al portapapeles. Para pegar el texto que se encuentra en el portapapeles, utilice Editar Pegar. Adems, el texto seleccionado con el ratn se puede pegar pulsando el botn central del ratn en la posicin deseada.

SUGERENCIA
Si est usando el escritorio KDE, puede recuperar texto copiado anteriormente en cualquier aplicacin usando el icono de Klipper del rea de noticacin.

4.5.
4.5.1.

Buscando y reemplazando texto


Las barras de bsqueda y reemplazo

Kate posee una barra de bsqueda incremental y otra de bsqueda y reemplazo que permite introducir una cadena de reemplazo, adems de ciertas opciones adicionales. Las barras contienen las siguientes opciones comunes: Buscar Aqu es donde se introduce la cadena de bsqueda. La interpretacin de la cadena depende de algunas de las opciones descritas a continuacin. Resaltar todo Si se habilita, se resaltarn todas las coincidencias en el documento. Distinguir maysculas/minsculas Si se activa, los resultados se reducirn a los que coincidan en la capitalizacin (maysculas o minsculas) de cada carcter del patrn de bsqueda. Desde el cursor Si est marcado, la bsqueda comenzar desde la posicin del cursor, en otro caso lo har desde el principio del documento. La barra de bsqueda y reemplazo ofrece algunas opciones adicionales: Texto plano Encaja con cualquiera coincidencia en la cadena de bsqueda. Solo palabras completas Si est activado, la bsqueda solo ser positiva si hay un lmite de palabra en ambos extremos de la cadena coincidente, no siendo ste un carcter alfanumrico sino otro carcter visible o un n de lnea. Secuencias de escape Si est seleecionado, se activar el botn Aadir y podr aadir secuencias de escape a un patrn de bsqueda a partir de una lista predenida.

15

Manual de Kate

Expresin regular Si est activado, la cadena de bsqueda se interpreta como una expresin regular. Se activar el botn Aadir y podr aadir expresiones regulares al patrn de bsqueda a partir de una lista predenida. Vea expresiones regulares para obtener ms informacin al respecto. Texto seleccionado Si se activa, la bsqueda y reemplazo se realizar solo dentro del texto seleccionado.

4.5.2.

Bsqueda de texto

Para buscar texto, lance la barra de bsqueda incremental mediante Ctrl+F o desde el men Editar Buscar.... Esto abrir la barra de bsqueda incremental en la parte inferior de la ventana de edicin. En el lado izquierdo de la barra hay un icono para cerrarla, seguido de una pequea caja de texto para introducir el patrn de bsqueda. Cuando empiece a introducir caracteres del patrn, la bsqueda se iniciar automticamente. Si hay una coincidencia en el texto, se resaltar y el color de fondo del campo de entrada pasar a ser verde claro. Si la bsqueda no coincide con ninguna cadena en el texto, se indicar con un fondo de color rojo y mostrando No se encontr en el lado derecho de la barra. Utilice los botones Siguiente o Anterior para saltar a la ocurrencia siguiente o anterior en el documento. Puede modicar el comportamiento de la bsqueda seleccionando las diferentes Opciones arriba descritas. Haga clic en la echa verde en el lado derecho de la barra de bsqueda incremental para cambiar a la de bsqueda y reemplazo. Para repetir la ltima operacin de bsqueda, si la hubo, sin mostrar la barra de bsqueda incremental, utilice Editar Buscar siguiente (F3) o Editar Buscar anterior (Maysculas+F3).

4.5.3.

Sustitucin de texto

Para reemplazar texto, lance la barra de bsqueda y reemplazo usando la orden Editar Reemplazar o pulse Ctrl+R. En la parte superior izquierda de la barra hay un icono para cerrarla, seguido de una pequea caja de texto donde introducir el patrn de bsqueda. Puede controlar el modo de bsqueda mediante las opciones Texto plano, Palabras completas, Secuencias de escape o Expresin regular arriba descritas. Utilice los botones Siguiente o Anterior para saltar a la ocurrencia siguiente o anterior en el documento. Introduzca el texto a reemplazar en la caja de texto Texto de reemplazo y pulse el botn Reemplazar para reemplazar solo el texto resaltado, o Reemplazar todo para reemplazar el texto a buscar en todo el documento. Si activa la opcin Usar contenedores, puede aadir elementos especiales al texto de reemplazo pulsando el botn Aadir. Puede modicar el comportamiento de la bsqueda y reemplazo seleccionando las diferentes opciones en el lado derecho de la barra. Haga clic en la echa verde en el lado derecho de la barra de bsqueda y reemplazo para cambiar a la de bsqueda incremental.

16

Manual de Kate

SUGERENCIA
Si est utilizando una expresin regular para buscar el texto a sustituir, puede utilizar retroreferencias para reutilizar el texto capturado en subpatrones de la expresin que estn entre parntesis. Consulte apndice B para obtener ms informacin.

SUGERENCIA
Puede utilizar nd, replace y ind (bsqueda incremental) desde la lnea de rdenes.

4.6.

Utilizando los marcadores

La caracterstica de los marcadores le permite marcar ciertas lneas y poder volver a encontrarlas de una forma sencilla. Puede establecer o eliminar un marcador de una lnea de dos maneras: Moviendo el cursor a esa lnea y activando la opcin Marcadores Fijar marcador (Ctrl+B). Pulsando en el siguiente borde de iconos junto a esa lnea. Los marcadores estn disponibles en el men Marcadores. Los marcadores individuales estn disponibles como elementos del men, etiquetados con el nmero de lnea del marcador o los primeros caracteres del texto de la lnea. Para mover el cursor al principio de una lnea marcada, abra el men y seleccione el marcador. Para moverse rpidamente entre marcadores o para ir al siguiente/anterior marcador, utilice Marcadores Siguiente (Ctrl+AvPg) o Marcadores Anterior (Ctrl+RePg).

4.7.

Ajuste automtico del texto

Esta opcin le permite dar un formato sencillo al texto: el texto ser cortado, de forma que ninguna lnea exceda un nmero de caracteres determinado, salvo que haya una cadena ms larga que no contenga espacios en blanco. Para activar o desactivar esta opcin, active/desactiva el Ajuste de lnea esttico en la pgina Edicin del dilogo de conguracin. Para establecer la anchura mxima de la lnea (mximo de caracteres por lnea), utilice la opcin Ajustar lnea a en la pgina Edicin del dilogo de conguracin. Si est activado, tiene los siguientes efectos: Al escribir, el editor insertar automticamente un salto de lnea despus del ltimo carcter de espacio en una posicin anterior a que se alcance el ancho mximo de la lnea. Mientras se carga un documento, el editor procesar el texto de una manera similar, de forma que ninguna lnea supere en longitud al mximo establecido, siempre que contenga un espacio en blanco que lo permita.

NOTA
En este momento no hay forma de establecer el ajuste de lnea slo para algunos documentos concretos o para algunos tipos de documentos. Este problema ser solucionado en futuras versiones de Kate

17

Manual de Kate

4.8.

Uso del sangrado automtico

El componente de edicin de Kate soporta una variante de los modos de sangrado automtico, diseado para diferentes formatos de texto. Puede seleccionar uno de los modos disponibles utilizando el men Herramientas Sangrado. El mdulo de sangrado automtico tambin proporciona la funcin Herramientas Alinear que recalcular el sangrado del texto seleccionado o de la lnea actual. De esta forma puede volver a establecer el sangrado completo de su documento seleccionando todo el texto y activando esta accin. Todos los modos de sangrado utilizan el sangrado de las preferencias congurado para el documento activo.

SUGERENCIA
Puede congurar la ordenacin de todas las variables de conguracin, incluyendo aquellas relativas al sangrado, utilizando Variables de documento y Tipos de archivo.

M ODOS DE SANGRADO AUTOMTICO DISPONIBLES Ninguno Seleccionando este modo se desactiva completamente el sangrado automtico. Normal Este sangrado simplemente mantiene un sangrado similar al de la lnea anterior con cualquier contenido diferente de un espacio en blanco. Puede combinar ste con las acciones sangrar y borrar sangrado segn sus gustos. Estilo C Es un sangrado para los lenguajes C y similares, como C++, C#, java, javascript, etc. Este sangrado no funcionar con lenguajes de script como Perl o PHP. Haskell Un sangrado especco para el lenguaje de programacin funcional Haskell. Lilypond Un sangrado especco para el lenguaje de notacin musical Lilypond. Lisp Un sangrado especco para el lenguaje de script Lisp y sus dialectos. Python Un sangrado especico para el lenguaje de script python.

18

Manual de Kate

Captulo 5

Trabajando con extensiones


Anders Lund Traductor: Marcos Fouces Lago Kate utiliza dos formas diferentes de extensiones, llamadas extensiones para la aplicacin Kate y extensiones para el componente de edicin de Kate. Posteriormente estarn disponibles para cualquier aplicacin que utilice el componente editor, tales como KDevelop, Quanta, Kile, Kwrite y muchos otros, mientras que las extensin de la aplicacin son especcas de la aplicacin Kate. Puede activar ambos tipos de extensin en el dilogo de conguracin, que tambin proporcionan acceso a las opciones de conguracin adicional para las extensiones que lo precisen. Existen muchas extensiones con diferentes propsitos disponibles en el mdulo kdeaddons, y podr encontrar ms en la web. Algunas extensiones se suministran con el componente de edicin, para hacer completado de palabra, marcadores automticos, insertar archivos, thesaurus, comprobacin de palabras y bsqueda incremental.

19

Manual de Kate

Captulo 6

Herramientas de edicin avanzadas


Anders Lund Dominik Haumann Traductor: Pablo de Vicente Traductor: Marcos Fouces Lago Traductor: Santiago Fernndez Sancho

6.1.

Comentar/descomentar

Las rdenes Comentar y Descomentar, disponibles en el men Herramientas le permiten aadir o eliminar marcas de comentario de la seleccin, o en su defecto, de la lnea actual. El formato de los comentarios depende del formato del texto que est escribiendo. Las reglas que determinan cmo deben ser los comentarios se establecen en las deniciones de sintaxis, as que si no se utiliza el resaltado de sintaxis, no ser posible la realizacin automtica de comentarios. Algunos formatos denen marcas de comentarios de una sola lnea, otros de varias lneas y otros utilizan ambas posibilidades. Si no estn disponibles los comentarios de varias lneas, ser imposible comentar una seleccin cuya ltima lnea no est incluida por completo. Si est disponible una marca de comentario de una sola lnea, es preferible comentar las lneas individualmente, ya que as se evitan problemas de comentarios anidados. Al eliminar las marcas de comentario, se debe seleccionar el texto no comentado. Al eliminar marcas de comentario multilnea de una seleccin, se ignorar cualquier espacio en blanco que quede fuera de las marcas de comentario. Para colocar marcas de comentario, utilice Herramientas Comentar o el acceso directo de teclado correspondiente, que de forma predeterminada es Ctrl+#. Para eliminar marcas de comentario, utilice el elemento de men Herramientas Descomentar o el acceso directo de teclado correspondiente, que de forma predeterminado es Ctrl+Maysculas+#.

6.2.

El componente de la lnea de rdenes del editor

El editor Kate tiene un componente que es una lnea de rdenes interna, y le permitir llevar a cabo diversas acciones desde un interfaz mnimo. La lnea de rdenes es una entrada de texto en la parte inferior del rea de edicin, y para mostrarlo solo tendr que seleccionar Ver Cambiar a lnea de rdenes o utilizar el acceso rpido (de forma predeterminada es F7). El editor proporciona un conjunto de rdenes como las que se documentan a continuacin, as como aquellos otros que se suministren a partir de extensiones. 20

Manual de Kate

Para ejecutar una orden, teclela y pulse la tecla entrar. La lnea de rdenes indicar si ha tenido xito, posiblemente mostrando un mensaje. Si entra en la lnea de rdenes pulsando F7 se ocultar automticamente despus de unos segundos. Para borrar el mensaje e introducir una nueva orden, pulse F7 de nuevo. La lnea de rdenes tiene un sistema de ayuda integrado, escriba la orden help para iniciarlo. Para ver una lista de todas las rdenes disponibles escriba help list, para ver ayuda especica para una orden especca, escriba help orden. La lnea de rdenes tiene integrado un historial, por tanto podr reutilizar las rdenes ya tecleadas. Para navegar a travs del historial, utilice las teclas Arriba y Abajo. A la vez que se muestran las rdenes del historial, se seleccionar la parte del argumento, permitiendo cambiarlos fcilmente, sobreescribiendo los argumentos.

6.2.1.
6.2.1.1.

rdenes estndar de la lnea de rdenes


rdenes para congurar el editor

Estas rdenes son las que proporciona el componente del editor, y le permite congurar nicamente el documento activo y la vista. Esto es especialmente prctico si desea utilizar una conguracin diferente de la predeterminada, por ejemplo para el sangrado. T IPOS DE ARGUMENTOS BOOLEAN Se utilizan con rdenes que activan o desactivan opciones. Los valores aceptados son: on, off, true, false, 1 o 0 INTEGER Un nmero entero STRING Una cadena set-tab-width [INTEGER ancho] Establece la tabulacin con el valor de ancho set-indent-width [INTEGER ancho] Establece el sangrado con el valor de ancho. Solo se utiliza si se est sangrando con espacios. set-word-wrap-column [INTEGER ancho] Establece el ancho de lnea para el ajuste de lnea con el valor de ancho. Esto se utiliza si se tiene activado el ajuste de lnea del documento. set-icon-border [BOOLEAN enable] Congura la visibilidad del borde de iconos. set-folding-markers [BOOLEANO activar] Congura la visibilidad del panel de marcas plegables. set-line-numbers [BOOLEAN activar] Congura la visibilidad de los nmeros de lnea del panel. set-replace-tabs [BOOLEAN enable] Si est activado, se sustituyen los espacios de tabulador por espacios normales a medida que escribe.

21

Manual de Kate

set-remove-trailing-space [BOOLEAN enable] Si est activo, las espacios en blanco de marca se eliminan en el momento en el que el cursor salga de la lnea. set-show-tabs [BOOLEAN activar] Si est activado, los caracteres de tabulacin y espacios en blanco de marca se visualizarn como un puntito. set-indent-spaces [BOOLEAN activar] Si est activado, el editor har un sangrado con indent-width espacios para cada nivel de sangrado, en lugar de con un caracter de tabulacin. set-mixed-indent [BOOLEAN activar] Si est activado, kate utilizar una mezcla de tabuladores y espacios para el sangrado. Cada nivel de sangrado tendr indent-width de ancho, y los diferentes niveles de sangrado se optimizarn utilizando los mximos caracteres de tabulacin posibles. Cuando se ejecuta, esta orden activar el sangrado con espacios, y si no se especica el ancho se asignar una valor igual a la mitad de tab-width para el documento en tiempo de ejecucin. set-word-wrap [BOOLEAN activar] Activa el ajuste de lnea dinmico de acuerdo con el valor de activar set-replace-tabs-save [BOOLEAN enable] Cuando est activo, los tabuladores se reemplazan con espacios en blanco al guardar el documento. set-remove-trailing-space-save [BOOLEAN activar] Cuando est activo, se eliminan las marcas de los espacios de cada lnea al guardar el documento. set-indent-mode [nombre] Asigna el modo de sangrado automtico a nombre. si nombre es desconocido, el modo seleccionado es none. Los modos vlidos son cstyle, csands, xml, python, varindent y none. set-highlight [resaltado] Asigna el sistema de resaltado de sintaxis al documento. El argumento debe ser un nombre de resaltado vlido, como aquellos que se pueden ver en el men Herramientas Resaltado. Esta orden proporciona una lista de autocompletado para los argumentos. 6.2.1.2. rdenes para la edicin

Estas rdenes modican el documento actual. indent Sangrado de texto en la lnea actual. unindent Elimina el sangrado de las lneas seleccionadas o de la lnea actual. cleanindent Borra el sangrado de las lneas seleccionadas o de la lnea actual de acuerdo con la conguracin del sangrado que tenga el documento. comment Inserta marcas de comentario haciendo que la seleccin, las lneas seleccionadas o la lnea actual sean un comentario de acuerdo con el formato de texto que se haya denido en la sintaxis de resaltado para el documento. 22

Manual de Kate

uncomment Elimina la etiqueta de comentario de la seleccin, de las lneas seleccionadas o de la lnea actual, de acuerdo con las reglas sintcticas de resaltado del documento. kill-line Borra la lnea actual. replace [patrn] [reemplazo] Reemplaza el texto que coincida con patrn con el valor de reemplazo. Si desea incluir espacios en blanco en el patrn, deber entrecomillar tanto el patrn como el reempl azo con comillas simples o dobles. Si los argumentos no van entrecomillados, la primera palabra se utilizar como patrn y el resto como reemplazo. Si reemplazo est vaco, cada aparicin de patrn se borra. Puede asignar parmetros para congurar la bsqueda aadiendo dos puntos, seguidos de una o ms letras cada una de las cuales representa una conguracin, quedando de la forma replace:opciones patrn reemplazo. Las opciones disponibles son: b Buscar hacia atrs. c Buscar desde la posicin del cursor. e Buscar slo en el texto seleccionado. r Busca utilizando una expresin regular. Si est asignado, puede utilizar \N donde N es un nmero que representa capturas en la cadena de reemplazo. s Bsqueda distinguiendo maysculas y minsculas. p Pide permiso para reemplazar la siguiente aparicin. w Encontrar slo palabras completas. date [formato] Inserta una cadena de fecha/hora denida de acuerdo a formato, o si ste no se especica se utiliza el formato aaaa-MM-dd hh:mm:ss. La interpretacin del formato ser la siguiente: El da como nmero sin ceros a la izquierda (1-31). El da como un nmero a dos dgitos (01-31). La abreviatura del nombre del da segn la localizacin (ejem: Lun...Dom). El nombre completo del da segn la localizacin (ejem: Lunes...Domingo). El mes como un nmero sin ceros a la izquierda (1-12). El mes como un nmero a dos dgitos (01-12). La abreviatura del nombre del mes segn su localizacin (p.ej: Ene..Dic). El ao como un nmero de dos dgitos (00-99). Ao a cuatro dgitos (1752-8000). La hora sin ceros a la izquierda (0..23 o 1..12 si se muestra AM/PM). 23

d dd ddd dddd M MM MMM yy yyyy h

Manual de Kate

hh m mm s ss z zzz AP ap

La hora a dos dgitos (00..23 o 01..12 si se muestra AM/PM). Los minutos sin ceros a la izquierda (0..59). Los minutos a dos dgitos (00..59). Los segundos sin ceros a la izquierda (0..59). Los segundos a dos dgitos (00..59). Los milisegundos sin ceros a la izquierda (0..999). Los milisegundos a tres dgitos (000..999). Se utiliza para mostrar AM/PM. AP se reemplazar por AM o PM. Se utiliza para mostrar am/pm. ap se reemplazar por am o pm.

char [identicador] Esta rden le permite insertar caracteres literales por su identicador numrico, en formato decimal, octal o hexadecimal. Para utilizarlo inicie el dilogo de edicin de rdenes y teclee char: [nmero] en la casilla de entrada, despus pulse Aceptar. Example 6.1 Ejemplos de char Entrada: char:234 Salida: Entrada: char:0x1234 Salida: ju s///[ig] %s///[ig] Esta orden ejecuta una operacin de bsqueda/sustitucin similar a las de sed en la lnea actual o en todo el archivo ( %s///). Brevemente, se busca en el texto alguna cadena que coincida con el patrn de bsqueda, la expresin regular entre la primera y la segunda barra, y cuando se encuentra una coincidencia, la parte coincidente del texto es sustituida por la expresin contenida entre las barras central y ltima de la cadena. Los parntesis en el patrn de bsquedas crean retroreferencias, es decir, que la orden recuerda qu parte de la coincidencia se encontraba entre los parntesis; estas cadenas se pueden reutilizar en el patrn de sustitucin, reriendose a ellas como \1 como el primer conjunto de parntesis, \2 como el segundo y as sucesivamente. Para hacer una bsqueda literal de ( o ), debe escapar el carcter utilizando una barra invertida: \(\) Si coloca una i al nal de la expresin, las coincidencias son sensibles a maysculas y minsculas. Si coloca una g al nal, se reemplazarn todas las apariciones del patrn, en cualquier otro caso se reemplazar nicamente la primera aparicin. Example 6.2 Sustitucin de texto en la lnea actual Su buen amigo el ordenador se ha detenido, diciendo que la clase myClass, mencionada en la lnea 3902 del archivo fuente no est denida. Vaya por Dios! pensar usted, es que se trataba de MyClass. Se desplaza a la lnea 3902 y en vez de intentar buscar la palabra en el texto, abre el dilogo de la orden de edicin, introduce s/ myclass/MyClass/i, pulsa el botn Aceptar, guarda el archivo y vuelve a compilar esta vez sin ningn error.

24

Manual de Kate

Example 6.3 Sustitucin de texto en todo el archivo Imagine que tiene un archivo, en el que menciona a Seorita Jensen varias veces, cuando resulta que alguien viene y le dice que se acaba de casar con Seora Jones. Usted querr, desde luego, sustituir cada aparicin de Seorita Jensen por Seora Jensen. Inicie la lnea de rdenes y teclee la orden %s/Seorita Jones/Seora Jones/ , y una vez que haya pulsado entrar habr terminado.

Example 6.4 Un ejemplo ms avanzado Este ejemplo hace uso de referencias anteriores as como de una clase de caracteres (si no sabe lo que es esto, por favor consulte la documentacin citada ms adelante). Suponga que tiene la siguiente lnea:
void MyClass :: DoStringOps ( String , int &b ) &foo , String & bar String *p , int &a

Pero usted se da cuenta de que ese cdigo no est bien, y decide que quiere utilizar la palabra clave const en todos los argumentos address of, que se caracterizan por tener un operador & delante del nombre del argumento. Tambin desea simplicar el espacio en blanco, de forma que slo haya uno entre cada palabra. Abra el dilogo de edicin de rdenes, e introduzca: s/\s+(\w+)\s+(&)/ const \1 \2/ g, despus pulse el botn Aceptar. La g al nal de la expresin hace que la expresin regular recompile cada coincidencia para guardar las retroreferencias. Salida: void MyClass::DoStringOps( const String &foo, const String &bar String *p, co nst int &a, const int &b ) Misin completada. Ahora, qu ha ocurrido? Bien, hemos buscado algn espacio en blanco (\ s+) seguido de uno o ms caracteres alfabticos (\w+) seguidos de ms espacio en blanco (\s+) seguido del smbolo &, y en el proceso hemos guardado el bloque alfabtico y el & para reutilizarlos en la operacin de sustitucin. Entonces hemos sustituido la parte coincidente de nuestra lnea por un espacio en blanco seguido de const seguido de un espacio en blanco seguido de nuestro bloque alfabtico (\1) seguido de un espacio en blanco seguido de nuestro & almacenado (\2) En algunos casos el bloque alfabtico era String, en otros int, as que la clase de caracteres \w y el cuanticador + nos han servido de gran ayuda.

6.2.1.3.

Opciones para navegar

goto [INT lnea] Esta orden va a la lnea especicada. find [patrn] Esta orden navega hasta la primera aparicin del patrn de acuerdo con la conguracin. Las siguientes apariciones se pueden encontrar utilizando Editar Buscar siguiente (el acceso rpido predeterminado es F3). La orden nd puede congurarse aadiendo dos puntos seguidos de una o ms opciones, el formato es find:opciones patrn. Estn soportadas las siguientes opciones: b Buscar hacia atrs. c Buscar desde la posicin del cursor. e Buscar slo en el texto seleccionado. 25

Manual de Kate

r Busca utilizando una expresin regular. Si est asignado, puede utilizar \N donde N es un nmero que representa capturas en la cadena de reemplazo. s Bsqueda distinguiendo maysculas y minsculas. w Encontrar slo palabras completas. ifind [patrn] Esta orden proporciona bsqueda como-teclee. Puede congurar el comportamiento o la bsqueda aadiendo dos puntos seguidos de una o ms opciones, de forma similar a: ifind:opciones patrn. Las opciones permitidas son b r s Bsqueda distinguiendo maysculas y minsculas. c Buscar desde la posicin del cursor. Buscar hacia atrs. Buscar mediante expresiones regulares.

6.3.

Utilizar plegado de cdigo

El plegado de cdigo le permite ocultar partes de un documento en el editor, haciendo sencilla la visin general de los documentos. En Kate las regiones plegables se calculan utilizando reglas denidas en las deniciones de resaltado de sintaxis, y por tanto solo est disponible en algunos formatos (suelen ser cdigo fuente de programas, tales como XML). La mayor parte de las deniciones de resaltado soportan plegado de cdigo y tambin le permiten denir manualmente regiones plegables, generalmente utilizando las palabras clave BEGIN y END. Para utilizar la caracterstica del plegado de cdigo, active los marcadores de plegado, si no estn visibles, mediante el elemento de men Ver Plegado de cdigo. El panel de marcadores de plegado a la izquierda de la pantalla muestra una vista grca de las regiones plegables, con los signos +/- para indicar la posible operacin en una regin dada: un tringulo invertido indica que la regin est expandida, pulsndolo se contraer la regin y se mostrar un tringulo derecho. Se proporcionan cuatro rdenes para manipular el estado las regiones plegables, vea el la documentacin del men. Si no desea utilizar el plegado de cdigo, puede desactivar la opcin Mostrar marcadores de plegado (si est disponible) en la pgina de aspecto del editor de conguracin.

6.4.
6.4.1.

Scripts en el componente de edicin con Javascript


Introduccin

Comenzando con la versin 2.5, el componente de edicin de Kate soporta la creacin de scripts con ECMA, y tambin conoce JavaScript. Los scripts se pueden utilizar nicamente a travs de la lnea de rdenes. Los requisitos son que el script se siten en la carpeta en la que Kate pueda encontrarlos, junto con un archivo opcional .desktop que dene la propiedades relacionadas. La carpeta vlida se debe llamar ka tepart/scripts y debe estar en las carpetas de datos de KDE. Puede encontrar las carpetas de datos ejecutando la orden kde4-cong --path data Como norma general tendr disponibles una carpeta de sistema y otra de datos personales. Por supuesto, los scripts la carpeta de datos del sistema estar disponible para todos los usuarios del sistema, mientras que los de la carpeta personal solo estarn disponibles para usted. 26

Manual de Kate

NOTA
Esta caracterstica es experimental y tendr cambios durante su futuro desarrollo. Sabemos que muchos de ustedes estarn desilusionados porque no pueden aadir sus propios scripts en el men o asignarles accesos rpidos. Lo sentimos, pero esperamos que en el futuro sea posible. Todava no es posible pasar argumentos a sus scripts. Tenga paciencia, y puede que se aadan en un futuro brillante ;)

6.4.2.

El API JavaScript de Kate

Aqu se lista el conjunto completo de funciones y propiedades disponibles en los objetos document y view. Tambin puede utilizar todos los objetos estndar como Math, String Regex y as sucesivamente. Cuando se ejecute un script, el objeto document es el documento actual, y el objeto view es la vista actual.

NOTA
Por supuesto, los tipos de argumentos no se utilizan en JavaScript, slo existen para indicar qu tipo de valores esperan las funciones.

F UNCIONES GLOBALES debug( (cadena, ) [funcin]debug( cadena) [funcin])


PARMETROS

cadena es la cadena de salida

Hace que las salidas se dirijan a STDERR utilizando kDebug(). Se utiliza un rea dedicada para la salida, y comenzar por Kate (KJS Scripts): E L API D O C U M E N T document.attribute( (lnea , , columna ); [funcin]) PARMETROS
uint lnea La lnea de la posicin para la que se buscar elatributo. uint columna La columna de la posicin para la que se buscar el atributo.

Devuelve el ID numrico del atributo para la posicin del documento [lnea,columna]. El atributo representa el aspecto visual o estilo del texto, y tambin puede utilizarse para calcular el resaltado de sintexis para una parte especca del texto, como en los formatos HTML o PHP. document.canBreakAt( (Char c, , uint atributo ); [funcin]) PARMETROS
c El caracter a comprobar atributo El atributo en la poscin de c.

El valor devuelto indica si est permitido dividir la lnea en un caracter c con un atributo atributo. El resultado se decide haciendo preguntando al atributo propietario del resaltado que caractes pueden dividir la lnea. document.canComment( (uint atributo_inicio, , uint atributo_fin ); [funcin]) PARMETROS
atributo_inicio El atributo al inicio del rango que se convertir en un comentario.

27

Manual de Kate

atributo_fin El atributo al nal del rango que se se convertir en un comentario.

El valor devuelto indica si atributo_inicio y atributo_n pertenecen al mismo sistema resaltado de sintaxis. Si lo son es correcto. Example 6.5 utilizando canComment
if ( document . canComment ( document . attribute (1 ,0) , document . attribute (5 ,0) ) ) { // 1 ,0 y 5 ,0 pertenecen al mismo sistema de resaltado de sintaxis }

document.clear(); [funcin] Borra el documento. document.commentStart( (uint atributo, ); [funcin]document.commentStart( uint at ributo ); [funcin]) PARMETROS
atributo El atributo del texto para el que se obtendr la cadena commentStart.

Devuelve la cadena requerida para iniciar un comentario multilnea para un texto con atributo, o una cadena vaca si el comentario multilnea no est soportado para este texto. document.commentMarker( (uint atributo, ); [funcin]document.commentMarker( uint atributo ); [funcin]) PARMETROS
atributo El atributo del texto para el que se ha obtenido la cadena commentMarker

Devuelve la cadena utilizada para marcar el resto de la lnea como un comentario para un texto con atributo o una cadena vaca sino estn soportados los comentarios de una solo lnea. document.commentEnd( (uint atributo ); [funcin]) PARMETROS
atributo El atributo del texto para el qeu se obtuvo la cadena commentEnd

Devuelve la cadena requerida al nal de un comentario multilnea para un texto con atributo, o una cadena vaca si los comentarios multilnea no estn soportados parar este texto. document.editBegin(); [funcin] Inicia un grupo de edicin. Todas las acciones realizadas hasta que se llame a editEnd() se agruparn como una accin para deshacer. document.editEnd(); [funcin] Finaliza un grupo de edicin. document.highlightMode; [propiedad:slo lectura] El nombre del modo de resaltado del documento, tal como JavaScript o C++. Sino hay modo de resaltado de sintaxis seleccionado para el documento, el valor es None (ninguno). Tenga en cuenta que necesitar utilizar un nombre en ingls en aquellos casos en que diera del traducido. document.indentMode; [propiedad:slo lectura] El nombre del modo de sangrado del documento, como por ejemplo normal o cstyle. Recuerde que sino hay modo de sangrado seleccionado, el valor ser none.

28

Manual de Kate

document.indentWidth; [propiedad:slo lectura] El ancho de sangrado asignado al documento. Se utiliza si el sangrado con espacios est activado. document.insertLine( (uint lnea, , string texto ); [funcin]) PARMETROS
lnea nmero de lnea del documento texto texto a insertar

Inserta una lnea nueva con el texto texto en la lnea lnea document.insertText( (uint lnea, , uint columna, , string texto ); [funcin]) PARMETROS
lnea el nmero de lnea columna la columna texto el texto que se insertar

Inserta el texto texto en la lnea lnea y la columna columna. document.length(); [funcin] Devuelve el tamao del documento en bytes. document.lines(); [funcin] Devuelve el nmero de lneas en el documento. document.mixedIndent; [propiedad:slo lectura] Un propiedad booleana que indica que el sangrado mezclado est activado para el documento. Si es as, el sangrado est optimizado para contener una mezcla de tabuladores y espacios similares a los utilizados por el editor Emacs. document.removeLine( uint lnea ); [funcin] PARMETROS
lnea nmero de lnea

Elimina la lnea lnea del documento. document.removeText( (uint lneaInicio, , uint columnaInicio, , uint lneaFin, , ui
nt columnaFin ); [funcin])

PARMETROS
lneaInicio especica la lnea de inicio columnaInicio especica la columna de inicio lneaFin especica la lnea de n columnaFin especica la columna de n

Elimina el texto desde la lnea lneaInicio y columna columnaFin hasta la lnea lneaFin y columna columnaFin. document.setText( (string texto ); [funcin]) PARMETROS
texto texto del documento

Asigna el contenido del documento completo a text.Asigna el contenido del documento completo a text. document.spaceIndent; [propiedad:slo lectura] Es una propiedad booleana que indica si el sangrado con espacios est activado para el documento. De esta forma los niveles del documento se sangrarn con espacios, en caso contrario se utilizarn los tabuladores. 29

Manual de Kate

document.textFull(); [funcin] Devuelve el texto del documento completo. Si el texto se ocupa varias lneas el caracter de salto de lnea es \n. document.textLine( uint lnea ); [funcin] PARMETROS
lnea la lnea

Devuelve el texto de la lnea lnea. document.textRange( (uint lineaInicio, , uint columnaInicio, , uint lineaFin, , uin
t columnaFin ); [funcin])

PARMETROS
lneaInicio especica la lnea de inicio columnaInicio especica la columna de inicio lneaFin especica la lnea de n columnaFin especica la columna de n

Devuelve el texto del rango especicado. Si el rango ocupa varias lneas el caracter de salto de lnea es \n. E L API DE V I E W view.clearSelection(); [funcin] Deseleccionar todo el texto. view.cursorColumn(); [funcin] Devuelve la columna del cursor actual (los caracteres TAB se expanden).Devuelve la columna del cursor actual (los caracteres TAB se expanden). view.cursorColumnReal(); [funcin] Devuelve la columna del cursor real actual (los caracteres TAB se cuentan como uno). view.cursorLine(); [funcin] Devuelve la lnea actual del cursor. view.hasSelection(); [funcin] Devuelve true (verdadero) si la vista contiene texto seleccionado, en otro caso devuelve false (falso). view.removeSelectedText(); [funcin] Elimina el texto seleccionado, si la vista tiene una seleccin. view.selectAll(); [funcin] Delecciona todo el texto. view.selection(); [funcin] Devuelve el texto seleccionado. Si la seleccin incluye varias lneas el caracter de salto de lnea ser \n. view.selectionEndColumn; [propiedad:slo lectura] Devuelve la columna nal de la seleccin. view.selectionEndLine; [propiedad:slo lectura] Devuelve el nal de la lnea de la seleccin. view.selectionStartColumn; [propiedad:slo lectura] Devuelve la columna de inicio de la seleccin.

30

Manual de Kate

view.selectionStartLine; [propiedad:slo lectura] Devuelve la lnea de inicio de la seleccin. view.setCursorPosition( (uint lnea, , uint columna ); [funcin]) PARMETROS
lea Especica la lnea para el cursor. columna Especica la columna para el cursor.

Asigna la posicin de entrada del cursor en la vista a [lnea, columna]. Asigna la posicin del cursor de forma visual, esto es el caracter TAB se desplaza anchotabulador dependiendo de la posicin dentro de la lnea. La posicin del cursor se ha hecho visible. Tanto la lnea y la columna tienen base cero. view.setCursorPositionReal( (uint lnea, , uint columna ); [funcin]) PARMETROS
lea Especica la lnea para el cursor. columna Especica la columna para el cursor.

Asigna la posicin de entrada del cursor a [lnea, columna]. sto asigna la posicin de la cadena, los caracteres TAB se cuentan como 1. La posicin del cursor se hace visible. Tanto la lnea como la columna tienen base cero. view.setSelection( (uint lineaInicio, , uint columnaInicio, , uint lneaFin, , uint columnaFin ); [funcin]) PARMETROS
lneaInicio especica la lnea de inicio columnaInicio especica la columna de inicio lneaFin especica la lnea de n columnaFin especica la columna de n

Asigna una seleccin desde la lnea uint lineaInicio y columna columnaInicio hasta la lnea lneaFin y columna columnaFin.

31

Manual de Kate

Example 6.6 Un script de muestra Como ejemplo crearemos un pequeo script que cambia a maysculas la seleccin. Lo primero que necesitaremos es comprobar que la seleccin existe, obtener el texto, cambiar las minsculas y reemplazarlas con las maysculas. Una implementacin podra parecerse a esto:
if ( view . hasSelection () ) { // seleccin para maysculas columna = view . selectionStartColumn ; linea = view . selectionStartLine ; seleccion = view . selection () . toUpperCase () ; document . editBegin () ; view . removeSelectedText () ; document . insertText ( linea , columna , seleccion ); document . editEnd () ; }

Para agrupar esta accin y que se revierta con una simple activacin de Deshacer deber encapsular las lneas
view . removeSelectedText ()

y
document . insertText ()

con un
document . editBegin ()

y un
document . editEnd ()

Example 6.7 Un archivo .desktop de muestra Veamos una archivo de muestra que acompaa al script anterior.
# Ejemplo de un archivo . desktop [ Desktop Entry ] Encoding =UTF -8 Name = Mayusculas JavaScript Kate Part Comment = Script para convertir a maysculas la seleccin X - Kate - Command = uppercase - selection X - Kate - Help =<p > Uso : <code > uppercase - selection </ code > </p >

Como puede ver puede denir la codicacin, asignar un nombre, un comentario, un texto de ayuda utilizando X-Kate-Help y la lnea de rdenes a travs de X-Kate-Command. Las entradas nombre, comentario y X-Kate-Help se traducen automticamente a otros idiomas por parte de los equipos de traduccin de KDE, si los archivos se encuentran en el repositorio SVN de KDE.

32

Manual de Kate

6.4.2.1.

Juntar todo

Kate buscar las carpetas de guiones (vea anteriores) para los archivos *.js. Para cada archivo comprueba si existe el correspondiente archivo .desktop, as por ejemplo para maysculas.js podra ser maysculas.desktop. Si un archivo .desktop no puede encontrarse el script se registrar en la lnea de rdenes de katepart con el nombre de archivo sin la nalizacin .js, por tanto en nuestro ejemplo podra ser mayusculas.si el nombre de la orden est anada y no necesita las caractersticas extra que proporciona el archivo .desktop, no necesitar ningn archivo .desktop. Si existe un archivo .desktop katepart leer el nombre bajo el que el script se registrar desde el .desktop-entry X-Kate-Command, por ejemplo sera X-Kate-Command=uppercase-selection.

33

Manual de Kate

Captulo 7

Entradas de men
Traductor: Marcos Fouces Lago Traductor: Santiago Fernndez Sancho

7.1.

El men Archivo

Archivo Nuevo (Ctrl+N) Esta orden inicia un nuevo documento en la ventana de edicin. En la Lista de archivos de la izquierda el nuevo archivo se denomina Sin ttulo. Archivo Abrir... (Ctrl+O) Inicia el dilogo de abrir archivo de KDE para permitirle abrir uno o ms archivos. Archivo Abrir reciente Esta orden le permite abrir un archivo desde un submen que contiene una lista de los archivos recientemente editados. Archivo Abrir con Este submen presenta una lista de aplicaciones conocidas para manejar el tipo mime de su documento actual. Activar una entrada abrir el documento actual con esta aplicacin. Adems, una entrada Otro... inicia un cuadro de dilogo de apertura de archivos para seleccionar otra aplicacin para abrir el archivo activo. Su archivo adems quedar abierto en Kate. Archivo Guardar (Ctrl+S) Esta orden guarda su archivo. Utilcelo con frecuencia. Si el archivo no tiene ttulo, Guardar se transforma en Guardar como. Archivo Guardar como... Nombre y renombre archivos con esta orden. Inicia el cuadro de dilogo de guardar. Este dilogo funciona como un cuadro de dilogo de apertura de archivos. Puede utilizarlo para navegar por su sistema de archivos, previsualizar archivos existentes, o ltrar su vista de archivos con mscaras. Introduzca el nombre que quiere dar al archivo que est guardando en el cuadro de direccin y pulse el botn Aceptar. Archivo Guardar todo (Ctrl+L) Esta orden guarda todos los archivos abiertos modicados.

34

Manual de Kate

Archivo Recargar (F5) Recarga el archivo activo. Esta orden es prctica si otro programa o proceso ha cambiado el archivo mientras lo tena abierto en Kate Archivo Recargar todo Recarga todos los archivos abiertos. Archivo Imprimir... (Ctrl+P) Imprime el archivo activo. Archivo Exportar como HTML... Exporta su archivo en formato HTML de forma que su documento pueda verse como una pgina web. Archivo Correo... Abre su cliente de correo y adjunta el archivo al correo. Este elemento slo se muestra cuando el complemento Enviar archivos por correo est cargado en las preferencias de Kate. Archivo Cerrar (Ctrl+W) Esta orden cierra el archivo activo. Si ha hecho cambios que no hayan sido guardados, se le solicitar guardar el archivo antes de que Kate lo cierre. Archivo Cerrar todos Esta orden cierra todos los archivos que usted tenga abiertos en Kate. Archivo Cerrar otros Cierra otros documentos abiertos Archivo Salir (Ctrl+S) Esta orden cierra Kate y cualquier archivo que usted estuviera editando. Si usted ha realizado cambios en alguno de los archivos que estaba editando y que an no han sido guardados, se le preguntar si desea guardarlos.

7.2.

El men Editar

El men Editar contiene una variedad de rdenes, todas ellas para trabajar con el documento activo. E NTRADAS DE MEN Editar Deshacer (Ctrl+Z) Deshace la ltima orden de edicin (escribir, copiar, cortar, etc..)

NOTA
Si se activa el deshacer agrupado, se pueden deshacer varias rdenes de edicin de forma simultnea, como por ejemplo el tecleo de caracteres.

Editar Rehacer (Ctrl+Maysculas+Z) Rehace el ltimo paso deshecho. Editar Cortar (Ctrl+X) Elimina el texto seleccionado, si lo hay, y coloca una copia de dicho texto en el portapapeles. Editar Copiar (Ctrl+C) Copia el texto seleccionado (si existiera) al portapapeles 35

Manual de Kate

Editar Copiar como HTML Copia el texto seleccionado con el resaltado de sintaxis como texto HTML. Editar Pegar (Ctrl+V) Copia el primer elemento del portapapeles al editor situndolo en la posicin del cursor.

NOTA
Si la seleccin sobreescribir est activada, el texto pegado sobreescribir la seleccin, si la hubiera.

Editar Seleccionar todo (Ctrl+A) Selecciona todo el texto en el editor. Editar Deseleccionar (Ctrl+Maysculas+A) Deselecciona el texto seleccionado en el editor (si lo hubiera). Editar Modo de seleccin de bloque (Ctrl+Maysculas+B) Cambia el modo de seleccin. Cuando el modo de seleccin sea BLOQUE, podr hacer selecciones verticales, como seleccionar las columna 5 a 10 en las lneas 9 a 15. La barra de estado muestra el estado actual del modo de seleccin, bien LNEA o BLOQUE. Editar Modo sobreescritura (Ins) Conmuta los modos de insercin/sobrescritura. En el modo INS, los caracteres se insertan donde est el cursor. En el modo SOBR, los caracteres escritos reemplazarn a los actuales si el cursor est situado antes de cualquier carcter. La barra de estado muestra el estado de sobrescritura actual, INS o SOBR. Editar Buscar en archivos... Inicia el dilogo de bsqueda para permitir buscar texto en los archivos de texto de un directorio. Editar Buscar... (Ctrl+F) Lanza la bsqueda incremental para permitirle buscar texto en el documento editado. Editar Buscar siguiente (F3) Va hacia delante hasta la siguiente concordancia del ltimo texto o expresin regular que se haya buscado, comenzando desde la posicin del cursor. Editar Buscar anterior (Maysculas+F3) Va hacia atrs hasta la siguiente concordancia del ltimo texto o expresin regular que se haya buscado, comenzando desde la posicin del cursor. Editar Reemplazar... (Ctrl+R) Inicia la funcin de buscar y reemplazar para sustituir una o ms ocurrencias de un texto dado por algo diferente. Editar Encontrar seleccionado (Ctrl+H) Busca la siguiente ocurrencia del texto seleccionado. Editar Encontrar seleccionado hacia atrs (Ctrl+Maysculas+H) Busca la anterior ocurrencia del texto seleccionado. Editar Ir a lnea... (Ctrl+G) Inicia el dilogo Ir a lnea, permitiendo introducir el nmero de lnea a buscar en el documento

36

Manual de Kate

7.3.

El men Documento

El men Documento proporciona una entrada de men para cada documento abierto. Pulsando una de ellas activar el documento deseado. Si tiene varios marcos, se mostrar un editor para ese documento en el marco activo. Adems, se proporcionan una serie de rdens para desplazarse a travs de los documentos abiertos: E LEMENTOS DE MEN Documento Atrs (Alt+Izquierda) Esto activar el documento anterior en la pila. Si tiene mltiples marcos, se mostrar un editor del documento en el marco actualmente activo. El orden es el de los documentos segn se han ido abriendo, en vez de un historial lgico. Este comportamiento cambiar en futuras versiones de Kate. Documento Adelante (Alt+Derecha) Esto activar el documento siguiente en la pila. Si tiene mltiples marcos, se mostrar un editor del documento en el marco actualmente activo. El orden es el de los documentos segn se han ido abriendo, en vez de un historial lgico. Este comportamiento cambiar en futuras versiones de Kate.

7.4.

El men Ver

El men Ver le permite administrar opciones especcas del editor activo, y gestionar marcos. E LEMENTOS DE MEN Ver Cambiar a lnea de rdenes (F7) Esta orden mostrar la lnea de rdenes. Ver Esquema Este men lista los esquemas disponibles. Puede cambiar el esquema para la vista actual aqu. Para cambiar el predeterminado debe utilizar la pgina Tipos de letra y colores del dilogo de conguracin. Ver Ajuste de lnea dinmico (F10) Cambia el ajuste de lnea dinmico en la vista actual. El ajuste de lnea dinmico hace que todo el texto se muestre en la vista visible sin necesidad de desplazamiento horizontal para visualizar una lnea en ms lneas siempre que sea necesario. Ver Indicadores de ajuste de lnea dinmico (F10) Selecciona cundo y cmo se muestran los indicadores de ajuste de lnea dinmico. Solo estar disponible cuando se active la opcin Ajuste de lnea dinmico. Ver Mostrar marcador de ajuste de lnea esttico Muestra/oculta una lnea vertical indicativa de la posicin del ancho ajustado tal y como se congur en el dilogo de conguracin. Esta caracterstica necesita que utilice un tipo de letra de ancho jo. Ver Mostrar borde de iconos (F6) Este elemento es un conmutador. Al marcarlo se har visible el borde de icono en la parte izquierda del editor activo, y viceversa. Ver Mostrar nmeros de lneas (F11) Este elemento es un conmutador. Si est activado aparecer un panel en el borde izquierdo del editor activo, en el que se mostrarn los nmero de lnea, y viceversa. 37

Manual de Kate

Ver Mostrar marcadores de barras de desplazamiento Muestra y oculta los marcadores (y otras marcas) en la barra de desplazamiento vertical. Cuando se activa, las marcas se representan con una lnea na del color de la marca en la barra de desplazamiento. Haciendo clic con el botn central en las lneas se desplazar la vista a la posicin ms cercana a la marca. Ver Mostrar marcadores plegables (F9) Muestra u oculta el panel de marcadores plegables en la parte izquierda de la vista. Vea utilizar plegado de cdigo. Plegado de codigo Contraer nivel superior (Ctrl+Maysculas+-) Contrae todas las regiones del nivel superior del documento. Expandir nivel superior (Ctrl+Maysculas++) Expandir todas las regiones del nivel superior del documento. Contraer un nivel local (Ctrl+-) Contrae la regin ms prxima al cursor. Expandir un nivel local (Ctrl++) Expande la regin ms prxima al cursor.

7.5.

El men Marcadores

El men Marcadores le permite trabajar con los marcadores en el documento activo actualmente. Debajo de las entradas descritas aqu, habr disponible una entrada por cada marcador en el documento activo. El texto estar formado por las primeras palabras de la lnea marcada. Elija un elemento para mover el cursor al comienzo de la lnea. El editor se desplazar hasta que la lnea sea visible. E LEMENTOS DE MEN Marcadores Fijar marcador (Ctrl+B) Aade o elimina un marcador de la lnea actual del documento activo (si est se elimina, si no est se activa). Marcadores Borrar todos los marcadores Elimina todos los marcadores del documento activo. Marcadores Anterior (Alt+RePg) Desplazar el cursor al principio de la primera lnea con un marcador. El texto del elemento del men incluir el nmero de lnea y la primera parte del texto de la lnea. Este elemento solo estar disponible cuando exista marcador en una lnea anterior a la del cursor. Marcadores Siguiente (Alt+AvPg) Desplazar el cursor al principio de la siguiente lnea con un marcador. El texto del elemento del men incluir el nmero de lnea y la primera parte del texto de la lnea. Este elemento solo estar disponible cuando exista marcador en una lnea posterior a la del cursor.

38

Manual de Kate

7.6.

El men Herramientas

Herramientas Redirigir a la consola Enva el texto seleccionado al emulador de terminal. No se aadir una nueva lnea despus del texto. Herramientas Sincronizar el terminal con el documento actual Provoca que el terminal empotrado ejecute un cd a la carpeta del documento activo, cuando se lance y cuando un nuevo documento obtenga el foco. Herramientas Enfocar/desenfocar terminal Cambia el foco del documento actual al terminal y viceversa. Herramientas Modo de solo lectura Asigna el documento actual al modo de solo lectura. Esto evita que se pueda aadir texto o cambios en el formato del documento. Herramientas Tipo de archivo Elija el esquema de tipo de archivo que preera para el documento activo. Este sobreescribir el modo del tipo de archivo global congurado en Preferencias Congurar Kate... en la pestaa del tipo de archivo, solo para el documento actual. Herramientas Resaltado Elija el esquema resaltado que preera para el documento activo. Esto sobreescribir el modo de resaltado global congurado en Preferencias Congurar editor.... Herramientas Sangrado Elija el estilo de sangrado que desee para su documento actual. sto sobreescribir el modo de sangrado global congurado en Preferencias Congurar editor... para su documento actual nicamente. Herramientas Codicacin Puede sobreescribir la conguracin predeterminada congurada en Preferencias Congurar editor... en la pestaa Abrir/Guardar para asignar una codicacin diferente para su documento actual. La codicacin que asign aqu solo ser vlida para su documento actual. Herramientas Fin de lnea Elija su modo de n de lnea preferido para su documento activo. Esto sobreescribe el n de lnea global congurado en Preferencias Congurar editor... solo para su documento actual. Herramientas Invocar la terminacin de cdigo (Ctrl+Espacio) Invoca manualmente el completado de rdenes, normalmente mediante un atajo vinculado a esta accin. Herramientas Ortografa... Inicia el programa de correccin ortogrca (un programa diseado para ayudar al usuario a corregir errores ortogrcos). Pulsando en esta entrada se iniciar el corrector y aparecer un dilogo mediante el que podr controlar el proceso. Existen cuatro conguraciones alineadas verticalmente en el centro del dilogo, con sus correspondientes etiquetas a la izquierda. Comenzando por arriba son: Palabra desconocida: Aqu el corrector ortogrco indica la palabra que est bajo consideracin. Esto sucede cuando se encuentra una palabra que no est en este diccionario (un archivo con una lista de palabras correctas contra las que comparar cada palabra del editor).

39

Manual de Kate

Reemplazar con: Si el corrector encuentra alguna palabra similar en su diccionario la primera de ellas se lista aqu. El usuario puede aceptar la segerencia, escribir su propia correccin, o elegir una sugerencia diferente del siguiente cuadro de texto. Idioma: Si ha instalado varios diccionarios, aqu podr seleccionar que diccionario/idioma debera utilizarse. En la parte derecha del cuadro de dilogo hay 6 botones que permiten al usuario controlar el proceso de correccin ortogrca. Son: Aadir al diccionario Al pulsar este botn aadir la Palabra desconocida al diccionario del corrector lo que signica que, en el futuro, el corrector considerar siempre esta palabra como correcta. Sugerir El corrector listar aqu una serie de posibles reemplazos para la palabra que se est considerando. Al pulsar en una de las sugerencias, esta palabra se introducir en el anterior cuadro Reemplazar. Reemplazar Este botn hace que el corrector reemplace la palabra que se est considerando en el documento con la palabra del campo Reemplazar con. Reemplazar todo Este botn har que el corrector reemplace no solo la Palabra desconocida actual, sino tambin que se sustituya automticamente cualquier otra aparicin de la misma en el documento. Ignorar Activar este botn har que el corrector contine sin realizar cambios. Ignorar todo Este botn le indica al corrector que no haga nada con la actual Palabra desconocida y que ignoer cualquier aparicin de la misma en el resto del documento.

NOTA
Solo se aplicar a la correcin de ortografa que se est realizando. Si se ejecuta de nuevo el corrector se detendr en la misma palabra.

Existen tres botones ms situados horizontalmente a lo larga de la parte inferior del dilogo de correccin ortogrca. Son: Ayuda Llama al sistema de ayuda de KDE inicindolo en las pginas de ayuda de Kate (este documento). Finalizado Este botn naliza el proceso de correccin ortogrca, y vuelve al documento. Cancelar Este botn cancela el proceso de correccin ortogrca, anulando todas las modicaciones, y volviendo al documento actual. Herramientas Correccin ortogrca (desde el cursor)... Esto inicia el programa de correccin ortogrca pero comenzando en la posicin actual del cursor en lugar de desde el inicio del documento. Herramientas Correccin ortogrca de la seleccin... Realiza la correccin ortogrca de la seleccin actual. 40

Manual de Kate

Herramientas Sangrar (Ctrl+I) Incrementa el sangrado del prrafo un nivel. El tamao del nivel depende de la conguracin del sangrado. Herramientas Desangrar (Ctrl+Maysculas+I) Reduce el sangrado del prrafo un nivel. El tamao del nivel depende de la conguracin del sangrado. Herramientas Borrar sangrado Elimina el sangrado para la seleccin actual o para la lnea en la que se encuentre el cursor. Borrar el sangrado asegura que todo el texto seleccionado siga el modo de sangrado que haya elegido. Herramientas Alinear Provoca la realineacin de la lnea actual o de las lneas seleccionadas utilizando el modo de sangrado y la conguracin de sangrado del documento. Herramientas Comentar (Ctrl+D) Aade un espacio al principio de la lnea en la que est el cursor de texto o al inicio del conjunto de las lneas seleccionadas. Herramientas Descomentar (Ctrl+Maysculas+D) Elimina un espacio (si existe) del principio de la lnea en la que est situado el cursor de texto o del inicio del conjunto de las lneas seleccionadas. Herramientas Maysculas (Ctrl+U) Cambia el texto seleccionado o la letra despus del cursor a maysculas. Herramientas Minsculas (Ctrl+Maysculas+U) Cambia el texto seleccionado o la letra despus del cursor a minsculas. Herramientas Capitalizar (Alt+Ctrl+U) Capitaliza el texto seleccionado o la palabra actual. Herramientas Unir lneas (Ctrl+J) Une las lneas seleccionadas, o la lnea actual y la lnea anterior con un espacio en blanco como separador. Se eliminarn los espacios en blanco sobrantes en las lneas afectadas. Herramientas Ajuste de lnea del documento Aplica el ajuste de lnea esttico en todo el documento. Esto signica que se iniciar automticamente una nueva lnea de texto cuando la lnea exceda la longitud especicada por el ajuste de lnea: opcin en la pestaa de edicin en Preferencias Congurar editor... Herramientas Herramientas externas Este submen contiene todas las herramientas externas que haya congurado. Los elementos del men para los complementos se muestran al nal de este men

7.7.

El men Sesiones

Este men contiene entradas para el uso y administracin de las sesiones de Kate. Para obtener ms informacin, lea utilizar sesiones. Sesiones Nueva Crea una nueva sesin vaca. Todos los archivos actualmente abiertos se cerrarn. 41

Manual de Kate

Sesiones Abrir... Abre una sesin existente. El dilogo de seleccin de sesiones se muestra para dejar elegir uno. Sesiones Apertura rpida Este submen le permite abrir una sesin existente. Sesiones Guardar Guarda la sesin actual. Si la sesin es annima, se le pedir un nombre para la sesin. Sesiones Guardar como... Guarda la sesin actual con un nombre nuevo. Se le pedir el nombre a utilizar. Sesiones Guardar como predeterminada... Guardar la sesin actual como predeterminada. Sesiones Administrar... Muestra el dilogo de administracin de sesiones que le permitir renombrar y borrar sesiones.

7.8.

El men Preferencias

El men Preferencias le permite cambiar las propiedades de la ventana principal, como la presencia o no de las barras de herramientas y cuadros, y proporciona acceso a los dilogos de conguracin. Preferencias Mostrar barra de herramientas Cuando est marcada, muestra una barra de herramientas movible que contiene botones usados para iniciar las rdenes ms usadas. Si no est marcada, la barra de herramientas est oculta. Preferencias Mostrar barra de estado Cuando est marcada, se muestra una pequea barra en la parte inferior del editor con informacin sobre el estado del documento actual. Si no est marcada, la barra de estado est oculta. Preferencias Mostrar ruta Cuando est seleccionada, la ruta del documento actual (su ubicacin en el sistema de archivos) se muestra en la barra de ttulo. Si no est marcada, la ruta est oculta. Preferencias Congurar accesos rpidos Muestra el habitual dilogo de conguracin de accesos rpidos del teclado de KDE. Preferencias Congurar barras de herramientas Muestra el habitual dilogo de conguracin de la barra de herramientas de KDE. Preferencias Congurar Kate... Inicia el dilogo principal de conguracin

42

Manual de Kate

7.9.

El men Ventana

Ventana Nueva ventana Abre otra instancia de Kate. Esta nueva instancia ser idntica a la instancia previa. Ventana Dividir en vertical (Ctrl+Maysculas+L) Esta opcin dividir el marco (que puede ser el rea de edicin principal) en dos marcos del mismo tamao, el nuevo a la izquierda del actual. El nuevo marco ser el activo, y mostrar el mismo documento que el marco original. Vea tambin Trabajando con Kate MDI. Ver Dividir en horizontal (Ctrl+Maysculas+T) Divide el marco actual (que puede ser el rea principal de edicin) en dos marcos de igual tamao, el nuevo en la parte inferior. El nuevo marco se activa, y muestra el mismo documento que el antiguo. Vea tambin Trabajando con Kate MDI. Ver Cerrar actual (Ctrl+Maysculas+R) Cierra el marco activo. Esta opcin estar desactivada si slo hay un marco (el rea principal de edicin). Al cerrarse un marco nunca se cierra un documento, sino que permanece disponible en el men Documento, as como en la lista de archivos. Vea tambin Trabajando con Kate MDI. Ventana Siguiente vista (F3) Activa la vista siguiente del documento, si tiene dividido el rea de edicin en ms vistas. Ventana Vista previa (Maysculas+F8) Activa la vista anterior del documento, si tiene dividido el rea de edicin en ms vistas. Ventana Vistas de herramientas Ventana Vistas de herramientas Mostrar barras laterales (Ctrl+Alt+Maysculas+F) Muestra u oculta la la de botones de la barra lateral. Esta orden no afecta a los componentes del contenido de la barra lateral, cualquier barra lateral que sea visible permanecer visible, y si asigna accesos rpidos a las rdenes anteriores, funcionarn. Ventana Vistas de herramientas Mostrar documentos Muestra u oculta la lista de documentos de Kate. Ventana Vistas de herramientas Mostrar buscar en archivos Muestra u oculta la herramienta de Buscar en archivos de Kate. Ventana Vistas de herramientas Mostrar selector de archivos Muestra u oculta el selecctor de archivos de Kate. Ventana Vistas de herramientas Mostrar terminal Muestra u oculta el emulador de terminal integrado. Al activarse la primera vez, se crear el terminal. Cuando se muestra el emulador de terminal, su ventana ser la activa, de modo que usted pueda comenzar a introducir rdenes inmediatamente. Si la opcin Sincronizar automticamente la terminal con documento activo cuando sea posible est activada en la Pgina general del dilogo principal de conguracin la sesin del intrprete de ordenes se situar en el directorio del documento activo, si ste es un archivo local. Ventana Modo de pantalla completa (Ctrl+Maysculas+F) Activa o desactiva el modo de pantalla completa.

43

Manual de Kate

7.10.

El men Ayuda

Adems de los elementos de men estndar de la Ayuda de KDE que se describen a continuacin, habr una entrada en el men para mostrar los manuales de usuario de las extensiones. Ayuda Manual de Kate (F1) Inicia el sistema de ayuda de KDE mostrando las pginas de ayuda sobre Kate (este documento). Ayuda Qu es esto? (Maysculas+F1) Modica la forma del puntero transformndola en una combinacin de echa e interrogacin. Al pulsar sobre los elementos que hay dentro de Kate se abrir una ventana de ayuda (si existe para cada caso particular) con una descripcin de la funcin de dichos elementos. Ayuda Informar de fallo... Abre un cuadro de dilogo para informar de fallos donde puede noticar un fallo o solicitar una mejora o nueva propiedad deseable. Ayuda Cambiar el idioma de la aplicacin... Abre un dilogo donde puede modicar el Idioma principal de esta aplicacin y el Idioma al que recurrir en caso de que el principal no est disponible. Ayuda Acerca de Kate Muestra informacin sobre la versin de la aplicacin y su autor. Ayuda Acerca de KDE Muestra la versin de KDE y otra informacin bsica.

44

Manual de Kate

Captulo 8

Conguracin de Kate
Anders Lund Traductor: Pablo de Vicente Traductor: Marcos Fouces Lago Traductor: Santiago Fernndez Sancho

8.1.

Introduccin

Kate ofrece varias formas de congurar la aplicacin para que se comporte como se desea. Los ms importantes son: El dilogo de conguracin Es la principal herramienta de conguracin, que le permite congurar Kate, el componente de edicin y el uso de extensiones. El men Opciones Le permite cambiar opciones utilizadas frecuentemente, e iniciar los dilogos de conguracin. El men Ver Le permite dividir el marco actual, as como mostrar los iconos y el panel con los nmeros de lnea para el documento actualmente editado. El terminal empotrado utiliza la conguracin denida en Preferencias del sistema, y puede ser congurado pulsando el botn derecho del ratn para mostrar un men contextual.

45

Manual de Kate

8.2.

El dilogo principal de conguracin

El dilogo de conguracin de Kate muestra un rbol de temas en la parte izquierda, y una pgina de conguracin correspondiente al tema seleccionado en la parte derecha. La conguracin est dividida en dos grupos llamados Conguracin de la aplicacin Conguracin del componente de edicin

8.3.

Conguracin de la aplicacin Kate

Este grupo contiene pginas para congurar la aplicacin principal de Kate

8.3.1.

La pgina general

Esta seccin contiene unas pocas opciones globales para Kate Comportamiento Advertir de los archivos modicados por procesos externos Cuando est activada, Kate le avisar cuando aplicaciones externas modiquen los archivos una vez que reciba el foco. Podr trabajar con varios archivos modicados a la vez, podr recargar, guardar o descartar los archivos cambiados en grupos. Sino est activado, Kate le preguntar que desea hacer cuando ser produzca una modicacin externa del archivo y la aplicacin reciba el foco. Meta-informacin

46

Manual de Kate

Mantener metainformacin entre sesiones Cuando se active, Kate guardar los metadatos tales como marcadores y conguracin de sesin incluso cuando cierre sus documentos. Los datos utilizarn si el documento se vuelve a abrir sin cambios. Eliminar meta informacin no utilizada despus de Asigna el nmero mximo de das para mantener meta informacin de los archivos no abiertos. sto le ayuda a mantener la base de datos de meta informacin en un tamao razonable.

8.3.2.

La pgina de sesiones

Esta seccin contiene opciones relativas a utilizar sesiones. Elementos de las sesiones Incluir conguracin de ventana Si est activada, Kate guardar la conguracin de la ventana con cada sesin. Comportamiento al iniciar la aplicacin Seleccione el comportamiento que desee para Kate al iniciarse. Esta conguracin se puede cambiar especicando qu hacer en la lnea de rdenes. Iniciar nueva sesin Con esta opcin, Kate iniciar una nueva sesin sin nombre al iniciarse. Cargar la ltima sesin utilizada Kate utilizar la sesin ms recientemente abierta al inicio. sto es bueno si desea utilizar siempre el mismo nombre de sesin o cambiarlo en contadas ocasiones. Elegir una sesin de forma manual Kate mostrar un pequeo dilogo que le permitir elegir su sesin preferida. Este es el comportamiento predeterminado. Es adecuado si utiliza muchas sesiones diferentes con frecuencia. Comportamiento al salir de la aplicacin o al cambiar de sesin No guardar la sesin Los cambios de los datos de la sesin (abrir archivos y si est activado, la ventana de conguracin) no se guardarn. Por supuesto, se le preguntar en el caso de que tenga archivos sin guardar. Con esta opcin, puede congurar sus sesiones una vez, y no tendr que preocuparse por cerrar los archivos que haya abierto y que no desee ver la siguiente vez que utilice la sesin. Guardar sesin Kate guardar los datos de la sesin, excepto si esta no tiene nombre. Con esta opcin, sus sesiones se restaurarn siempre donde las dej. ste es el comportamiento predeterminado. Preguntar al usuario Se le preguntar si desea guardar la sesin cada vez que se cierre una sesin con nombre.

47

Manual de Kate

8.3.3.

La pgina Lista de documentos

Sombrear el fondo Esta seccin le permitir activar o desactivar la visualizacin del sombreado del fondo de su actividad reciente, y seleccionar qu colores se utilizarn si est activado.Vea la seccin sobre La lista de documentos para obtener ms informacin sobre esta caracterstica. Ordenar por Congura la forma en que se ordenar la lista de documentos. Tambin se puede congurar congurar desde el men que aparece al utilizar el botn derecho en la lista de documentos.

8.3.4.

La pgina Extensiones

Esta pgina proporciona una lista de las extensiones instaladas para Kate. Cada extensin est representada por su nombre y una pequea descripcin. Puede marcar la casilla de un elemento para activar la extensin que representa. Si una opcin tuviera opciones de conguracin, aparecer una seccin para poder congurarla.

8.3.5.

La pgina Selector de archivos

Barra de herramientas Congura los botones en la barra de herramientas del selector de archivos de sistema moviendo moviendo aquellos que desea activar a la lista Acciones seleccionadas, y ordnelos utilizando los botones con las echa en el lateral de la lista. Autosincronizacin Puede hacer que el selector de archivos vaya automticamente al directorio del documento actual con ciertos eventos: Cuando un documento se haga activo. Cuando el selector de archivos se haga visible. Aunque decida no utilizar esta caracterstica, puede sincronizar manualmente su navegador con el documento actual pulsando el botn Directorio del documento actual de la barra de herramientas. Recordar ubicaciones Seleccione el tamao del historial. El navegador slo recuerda ubicaciones individuales y los duplicados se eliminan. Recordar ltros Seleccione cuntos ltros desea recordar. Slo se recuerdan ltros individuales distintas, los duplicados se elimina. Sesin Especica si el selector de archivos debera recordar su ubicacin y el ltimo ltrado de las sesiones.

8.3.6.

La pgina Terminal

Sincronizar automticamente el terminal con el documento actual cuando sea posible Esto har que el terminal cambie al directorio del documento activo al iniciarse y cuando un documento obtenga el foco. Si no est activado, tendr que navegar por su cuenta con el terminal. 48

Manual de Kate

8.3.7.

Herramientas externas

Esta pgina se mostrar si las Herramientas externas estn seleccionadas en la pgina Complementos. En este caso, en el men Herramientas encontrar un submen Herramientas externas, que invoca aplicaciones externas con datos relativos al documento actual, como su URL, directorio, texto o seleccin. Esta pgina le permitir administrar el men y editar, eliminar o aadir nuevas herramientas. Cada herramienta externa es una orden de consola que contiene macros que representan los datos del documento. Cuando se activan, las macros se substituyen con datos del documento activo. P ROPIEDADES DE LAS HERRAMIENTAS EXTERNAS Etiqueta Una etiqueta para la herramienta externa en el men. Script El script que se ejecutar cuando la herramienta se active. Antes de pasar el script al intrprete se sustituirn las siguientes macros: %URL La URL completa del documento actual, o una cadena vaca si el documento no se ha guardado. %URLs Una lista de las URL de todos los documentos abiertos (excepto aquellos que no se han guardado), separadas por espacios. %directory El directorio que forma parte de la URL del documento actual o una cadena vaca si el documento actual no ha sido guardado. %lename El nombre del archivo del documento actual sin la ruta, o una cadena vaca sino se ha guardado el documento actual. %line El nmero de lnea en la que se encuentra el cursor dentro del documento actual. %column El nmero de columna en la que se encuentra el cursor en el documento actual. %selection El texto seleccionado en el documento actual, o una cadena vaca si no hay texto seleccionado. %text El texto completo del documento actual. Tenga cuidado ya que esto puede hacer que se supere el tamao mximo de orden permitido por su sistema. Utilcelo con cuidado. Ejecutable El ejecutable principal en el script. Es obligatorio, y se utiliza para comprobar si la rden puede ser ejecutada o no. Se permite una ruta completa en el caso de que el ejecutable no est en su variable PATH. Tipos MIME Una lista separada por dos puntos con los tipos mime para los que esta orden debera estar disponible. Actualmente est en desuso. Guardar Opcionalmente puede decidir guardar el documento actual o todos los documentos antes de ejecutar el script. Es prctico si su script lee el archivo del disco. Nombre de la lnea de rdenes Si rellena esto, la herramienta estar disponible en los editores de la lnea de rdenes como exttool-Nombre de la lnea de rdenes (la cadena que introduzca aqu precedida de exttool-). 49

Manual de Kate

8.4.

La conguracin del componente de edicin

Este grupo contiene todas las pginas relacionadas con el editor de Kate. La mayor parte de las conguraciones que se encuentran aqu son las predeterminadas, y pueden ser sobreescritas por deniciones de tipos de archivo, por variables de documento o por cambios en el propio documento durante la edicin.

8.4.1.

Aspecto

Ajuste de lnea Ajuste de lnea dinmico Si esta opcin est marcado, las lneas de texto se ajustarn al borde de la vista en la pantalla. Indicadores del ajuste de lnea dinmico (si es aplicable) Indica cundo se mostrarn los indicadores del ajuste de lnea dinmico. Alinear las lneas justicadas dinmicamente al nivel de sangrado: Activa el inicio del ajuste dinmico de las lneas para que se ajusten verticalmente al sangrado de la primera lnea, que puede ayudarle a crear cdigo y marcas ms legibles. Adems, le permite congurar el ancho mximo de la pantalla, como un porcentaje, despus del que las lneas ajustadas dinmicamente no se alinearn verticalmente. Por ejemplo, al 50 %, a las lneas cuyos niveles de indentacin sean mayores del 50 % del ancho de la pantalla no se les aplicar la alineacin vertical a las siguientes lneas ajustadas. Bordes Mostrar marcadores plegables (si estn disponibles) Si est marcada esta opcin, la vista actual mostrar marcas para el plegado de cdigo, si el plegado de cdigo est disponible. Mostrar borde de iconos Si est marcado, ver un borde de icono en la parte izquierda. El borde de icono muestra smbolos de marcadores, por ejemplo. Mostrar nmeros de lneas Si est marcado, ver los nmeros de lnea en la parte izquierda. Mostrar marcas de barras de desplazamiento Si est marcada esta opcin la vista actual mostrar marcas en la barra de desplazamiento vertical. Estas marcas por ejemplo, mostrarn los marcadores. Ordenar men de marcadores Por posicin Los marcadores se ordenarn por los nmeros de lnea en la que se siten. Por creacin Cada marcador nuevo se aadir a la parte superior, independientemente del lugar en el que est colocado en el documento. Avanzado Activar el modo Usuario Avanzado (modo KDE 3) Esta opcin no tiene efecto en Kate. Mostrar lneas de sangrado Si est marcada, el editor mostrar lneas verticales para ayudarle a identicar el sangrado de las lneas. Resaltar espacio entre los parntesis seleccionados Si se activa, se resaltar el espacio entre el par de parntesis seleccionado. 50

Manual de Kate

8.4.2.

Tipos de letra y colores

Esta seccin del dilogo le permite congurar todos los tipos de letra y colores de cualquier esquema de color que tenga, as como crear nuevos esquemas o borrar los existentes. Cada esquema tiene conguraciones para los colores, tipos de letra y resaltado de estilos de texto. Kate preseleccionar el esquema activo por usted, pero si desea trabajar con un esquema diferente seleccinelo en el desplegable Esquema. Con los botones Nuevo y Eliminar puede crear un nuevo esquema o borrar los ya existentes. En la parte inferior de la pgina puede seleccionar el Esquema predenido para Kate. 8.4.2.1. Colores

rea de fondo de texto Texto normal Este es el fondo predeterminado para el rea de edicin, ser el color dominante en el rea de edicin. Texto seleccionado Es el fondo para el texto seleccionado. El valor predeterminado es el color de la seleccin global, tal y como est congurado en las preferencias de color de KDE. Lnea actual Congura el color para la lnea actual. Esta conguracin es un poco diferente del fondo de texto normal y le ayudar a mantener el foco en la lnea actual. Marcador Esta lista desplegable le permite congurar un revestimiento para los diferentes tipos de marcador. El color se mezcla con el color del fondo de una lnea marcada, de forma que una lnea con varios marcadores o si una lnea marcada tiene el mismo color del fondo se crea una mezcla de colores. Los colores de las marcas tambin se utilizan si activa mostrar marcas de barras de desplazamiento. Elementos adicionales Fondo del borde izquierdo Este color se utiliza para los marcadores, nmeros de lnea y bordes de los marcadores del plegado de cdigo situados en la parte izquierda de la vista de edicin cuando stos se muestren. Nmeros de lnea Este color se utiliza para dibujar los nmeros de lnea en la parte izquierda cuando se muestren. Resaltado con corchetes Este color se utiliza para dibujar el fondo de los corchetes emparejados. Marcadores de ajuste de lnea Este color se utiliza para dibujar un patrn a la izquierda de las lneas ajustadas dinmicamente cuando est alineados verticalmente, y tambin para los marcadores de ajuste de lnea estticos. Marcadores de tabulador Este color se utiliza para dibujar los indicadores de espacios en blanco cuando estn activados. 8.4.2.2. Tipo de letra

Aqu podr seleccionar el tipo de letra del esquema. Puede seleccionar cualquier tipo de letra disponible en su sistema, y congurar el tamao predeterminado. Se mostrar un texto de muestra en la parte inferior del dilogo para que pueda ver el resultado de su eleccin. 51

Manual de Kate

8.4.2.3.

Estilos de texto normal

Los estilos de texto normal se heredan de los estilos de texto resaltado, y permiten al editor presentar texto de forma consistente, por ejemplo, un comentario utiliza el mismo estilo en la mayor parte de los formatos que Kate puede resaltar. El nombre en la lista de estilos utiliza el estilo congurado para el elemento, proporcionndole un vista previa cuando est congurando un estilo. Cada estilo le permite seleccionar atributos comunes tales como los colores del fondo y del primer plano. Para deseleccionar un color de fondo, pulse con el botn derecho para utilizar el men contextual. 8.4.2.4. Estilos de texto resaltado

Aqu puede editar los estilos de texto utilizados por una denicin de resaltado especca. El editor preselecciona el resaltado utilizado por su documento actual. Para trabajar con un resaltado diferente, seleccione uno en el desplegable Resaltado sobre la lista de estilo. El nombre en la lista de estilos utiliza el estilo congurado para el elemento, proporcionndole un vista previa cuando est congurando un estilo. Cada estilo le permite seleccionar atributos comunes tales como los colores del fondo y del primer plano. Para deseleccionar un color de fond, pulse con el botn derecho para utilizar el men contextual. Adems podr ver si un estilo es igual al estilo predeterminado para el elemento, y asignarlo si no lo es. Tenga en cuenta que muchos resaltados contienen otros resaltados representados por grupos en la lista de estilo. Por ejemplo, la mayor parte de los resaltados incluyen el resaltado Alerta, y muchos de los formatos de cdigo fuente incluyen el resaltado Doxygen. Editar colores en estos grupos solo afectar a los estilos cuando se utilicen en el formato de edicin de resaltado.

8.4.3.
8.4.3.1.

Edicin
General

Tabuladores Inserta espacios en lugar de tabuladores Cuando est activado, el editor insertar un nmero de espacios calculado de acuerdo a la posicin en el texto y al ancho del tabulador congurado cuando se pulse la tecla Tab. Mostrar tabuladores Cuando se active, Kate mostrar un pequeo punto como representacin visual de los caracteres de tabulacin.

NOTA
Esto tambin har que se dibujen puntos para indicar los espacios en blanco nales. Esto se corregir en una futura versin de Kate

Anchura del tabulador Si la opcin Usar espacios en lugar de tabuladores est seleccionada, esta entrada determinar el nmero de espacios con los que reemplazar de forma automtica los tabuladores. Ajuste de lnea esttico El ajuste de lnea es una caractersticas que hace que el editor inicie automticamente una nueva lnea de texto y mueva (ajuste) el cursor al inicio de la nueva lnea. Kate iniciar automticamente una nueva lnea cuando la actual alcance la longitud especicada por la opcin Ajustar lneas a. 52

Manual de Kate

Activar ajuste de lnea esttico Activa o desactiva el ajuste esttico de lnea. Muestra marcadores de ajuste de lnea esttico (si son aplicables) Si esta opcin est marcada, se dibujar una lnea vertical en la lnea de ajuste tal y como se deniera en Preferencias Congurar editor... en la pestaa edicin. Tenga en cuenta que el marcador de ajuste de lnea solo se dibujar si utiliza un tipo de letra de tamao jo. Ajustar lnea a: Si la opcin Ajuste de lnea esttico est seleccionada, esta entrada determina la longitud (en caracteres) tras la que el editor iniciar una nueva lnea de forma automtica. Varios Eliminar espacios al nal Kate eliminar automticamente los espacios adicionales al nal de la lnea de texto. Resaltar espacios al nal Kate resaltar automticamente los espacios adicionales al nal de la lnea de texto. Auto parntesis Cuando el usuario teclee un parntesis izquierdo ([, (, o {) Kate introducir automticamente los parntesis derechos (}, ), o ]) a la derecha del cursor. 8.4.3.2. Cursor y seleccin

Movimiento de cursor de texto Inicio y n inteligentes Cuando se seleccione, pulsando la tecla inicio har que el cursor salte los espacios en blanco y vaya al inicio de una lnea de texto. Ajustar cursor Cuando se activa, mover la insercin del cursor utilizando las teclas izquierda y derecha ir a la lnea anterior/siguiente al principio/nal de la lnea, como en la mayor parte de los editores. Cuando est desactivado, la insercin del cursor no se mover al inicio de la lnea, sino al nal de la lnea, lo que puede ser muy prctico para los programadores. Cuando se seleccione esta opcin, mover el cursor con la reclas de las echas har que al nal de la lnea el cursor vaya al principio de la siguiente lnea. Asimimo cuando el cursor se mueva ms all del principio de la lnea (a la izquierda) saltar al nal de la lnea anterior. Cuando no se haya seleccionado esta opcin, mover el cursor ms all del nal de la lnea har que contine horizontalmente en la misma lnea, en cambio moverse ms all del principio no har nada. AvPg/RePg mueve el cursor Esta opcin cambia el comportamiento del cursor cuando el usuario pulsa las teclas RePg o AvPg. Si no est seleccionado el cursor mantendr su posicin relativa dentro del rea de texto visible en Kate cuando aparezca nuevo texto como resultado de la operacin. As, si el cursor est en el centro del texto visible cuando se ejecute la operacin, seguir ah (excepto cuando se supere el principio o el nal). Cuando est seleccionada esta opcin, pulsar estas teclas har que el cursor se desplace a la parte superior o inferior del texto visible cuando se muestre la nueva pgina de texto. Cursor autocentrado (lneas): Congura el nmero de lneas que se mantendrn visibles sobre y bajo el cursor siempre que sea posible. Modo de seleccin de texto

53

Manual de Kate

Normal Las selecciones se sobreescribirn tecleando texto y se perdern al mover el cursor. Persistente Las selecciones se mantendrn incluso aunque se mueva el cursor o se teclee texto. 8.4.3.3. Sangrado

Modo de sangrado por defecto: Seleccione el modo de sangrado automtico que desee utilizar de manera predeterminada. Se recomienda utilizar Ninguno o Normal, y utilizar las conguraciones del tipo de archivo para asignar otros modos de sangrado para formatos como cdigo C/C++ o XML. Propiedades de sangrado Anchura de sangrado: El ancho de la sangra es el nmero de espacios usados para sangrar una lnea. Si la opcin Usar espacios en lugar de tabuladores en la pestaa General de la pgina Edicin est deshabilitada, se inserta un carcter Tab si el sangrado es divisible por la anchura del tabulador. Mantener espacios extra Si deshabilita esta opcin, al cambiar el nivel de sangrado se alinea una lnea a un mltiplo del ancho especicado en la Anchura de sangrado.. Ajustar el sangrado de cdigo pegado desde el portapapeles Si selecciona esta opcin, el cdigo pegado del portapapeles ser sangrado. Activando la accin Deshacer se eliminar el sangrado. Acciones de sangrado Quitar sangrado con tecla retroceso cuando est en un espacio en blanco al inicio Si selecciona esta opcin, la tecla Retroceso disminuir un nivel el sangrado si el cursor est posicionado en los espacios en blanco al inicio de una lnea. Modo de tecla de tabulador (si nada est seleccionado) Si desea que Tab alinee la lnea actual de su bloque de cdigo igual que en emacs, haga que Tab sea un atajo a la accin Alinear. Avanzar siempre hasta la siguiente posicin de tabulacin Si selecciona esta opcin, la tecla Tab siempre insertar espacios en blanco hasta alcanzar la siguiente posicin de tabulacin. Si la opcin Insertar espacios en lugar de tabulaciones en la pestaa General de la pgina Editor est activada se insertarn espacios, en caso contrario se insertar una sola tabulacin. Aumentar siempre el nivel de sangrado Si selecciona esta opcin, la tecla Tab sangrar siempre la lnea actual el nmero de posiciones especicado en Anchura de sangrado. Aumentar nivel de sangrando cuando est sobre un espacio en blanco al inicio Si esta opcin est seleccionada, la tecla Tab realiza un sangrado de la lnea actual o avanza a la siguiente posicin de tabulacin. Si el punto de insercin est en o antes del primer carcter distinto de un espacio de la lnea, o si existe una seleccin, se realiza un sangrado de la lnea actual con el nmero de posiciones de caracteres especicado en Anchura del sangrado. Si el punto de insercin est situado despus del primer carcter distinto de un espacio de la lnea y no existe seleccin, se insertarn espacios en blanco hasta alcanzar la siguiente posicin de tabulacin: si est activada la opcin Insertar espacios en vez de tabuladores en la pestaa General de la pgina Edicin, se insertarn espacios; en caso contrario, se insertar un nico tabulador. 54

Manual de Kate

8.4.3.4. General

Autocompletado

Autocompletado activado Cuando est activado, el editor calcular el nmero de espacios hasta la siguiente posicin de tabulacin, denida en el ancho de esta, y los insertar en lugar de un carcter Tab.

8.4.4.
8.4.4.1.

Abrir y guardar
General

Formato de archivo Codicacin: Establece la codicacin predeterminada de caracteres para sus archivos. Fin de lnea: Establece el nal de lnea preferido para su documento activo. Puede elegir entre UNIX, DOS/Windows o Macintosh. Deteccin automtica de n de lnea Mrquelo si desea que el editor detecte automticamente el nal del tipo de lnea. El primer nal de lnea encontrado se utilizar para el archivo completo. Limpieza automtica al cargar/guardar Eliminar espacios al nal El editor eliminar automticamente los espacios extras al nal de las lneas de texto al cargar/guardar el archivo. 8.4.4.2. Avanzado

Archivo de conguracin de carpeta Profundidad de bsqueda del archivo de conguracin: El editor buscar el archivo de conguracin de Kate en el nmero dado de niveles de carpeta hacia arriba y cargar las preferencias desde l. Copia de seguridad al guardar Los archivos de copia de seguridad harn que Kate copie el archivo a <prejo><nombrearchivo><sujo> antes de guardar los cambios. Por defecto, el sujo es ~ y el prejo es el vaco. Archivos locales Mrquela si desea realizar copias de seguridad de los archivos locales al guardar. Archivos remotos Marque esto si desea realizar copias de seguridad de los archivos remotos al guardar. Prejo Introduzca el prejo que preceder al nombre de los archivos de copia de seguridad. Sujo Introduzca el sujo que seguir al nombre de los archivos de copia de seguridad. 55

Manual de Kate

8.4.4.3.

Modos y tipos de archivos

Esta pgina le permitir sobreescribir la conguracin predeterminada para los documentos de los tipos mime especicados. Cuando el editor cargue un documento, intentar encontrar la mscara o el tipo mime para uno de los tipos de archivos denidos, y de ser as se aplican las variables denidas. Si coinciden varios tipos de archivos, se utilizar el de mayor prioridad. Tipo de archivo: El tipo de archivo con la prioridad ms alta es el que se muestra en el primer desplegabe. Si se hay ms tipos de archivo, tambin se listarn. Nuevo Se utiliza para crear un nuevo tipo de archivo. Despus de que pulse este botn, los campos inferiores se vaciarn y podr rellenar las propiedades que desee para el nuevo tipo de archivo. Eliminar Para borrar un tipo de archivo existente, seleccinelo de la lista desplegable y pulse el botn Eliminar. Propiedades del tipo de archivo actual El tipo de archivo con la prioridad ms alta es el que se muestra en el primer desplegabe. Si se hay ms tipos de archivo, tambin se listarn. Nombre: El nombre del tipo de archivo ser el texto del correspondiente elemento del men. Este nombre se mostrar en el men Herramientas Tipos de archivo. Seccin: El nombre de la seccin se utiliza para organizar los tipos de archivo en los mens. Tambin se utilizarn en el men Herramientas Tipos de archivo. Variables: Le permitirn congurar las preferencias de Kate para los archivos seleccionados para este tipo mime, usando variables de Kate. Puede congurar casi cualquier opcin, como resaltado, modo de sangrado, codicacin, etc. Para obtener la lista completa de las variables conocidad, vea el manual. Resaltado: Si crea un nuevo tipo de archivo, este desplegable le permite seleccionar un tipo de archivo para el resaltado. Extensiones de archivos: Los comodines le permitirn seleccionar archivos segne el nombre del archivo. Una mscara que se suele utilizar es un asterisco y la extensin del archivo, por ejemplo *.txt; *.text. Se puede incluir una lista de mscaras separadas por punto y coma. Tipos MIME: Muestra un asistente que le ayudar a seleccionar con facilidad los tipos mime. Prioridad: Asigna una prioridad para este tipo de archivo. Si un documento coincide con varios tipos de archivos, se elegir aquel que tenga mayor prioridad. Descargar archivos de resaltado... Pulse este botn para descargar descripciones de reglas de resaltado de sintaxis nuevas o para actualizar las existentes desde el sitio web de Kate.

8.4.5.

Accesos rpidos

Aqu podr cambiar la conguracin de las teclas de acceso rpido. Seleccione una accin y pulse en personalizar si desea un acceso rpido diferente para esta accin. La lnea de bsqueda le permite buscar una accin especca y ver su acceso rpido asociado. 56

Manual de Kate

8.4.6.

Complementos

La pestaa Complementos le permite ver todas las extensiones disponibles y marcar las que desee utilizar. Presione el botn Informacin para abrir el dilogo Acerca de del complemento. Una vez marcada una extensin, el botn Congurar se activar y podr pulsarlo para congurar la extensin resaltada. Los complementos seleccionados estn disponibles en el men Herramientas.

8.5.

Conguracin con variables de documentos

Las variables de kate son una implementacin de kateparts de las variables de documento, parecidas a las de emacs y vi. En katepart, las lneas tendrn el formato kate: NOMBREVARIABLE VALOR; [ NOMBREVARIABLE VALOR; ...] las lneas pueden ser integradas en un comentario, si el archivo tiene un formato que acepta comentarios. Los nombres de las variables son palabras simples (sin espacios), y su valor llegar hasta el siguiente punto y coma. Se requiere punto y coma. Vemos un ejemplo de lnea de variable, que fuerza la conguracin del sangrado para un archivo C++, java o javascript:
// kate : space - indent on ; indent - width 4; mixedindent off ; indent - mode cstyle ;

NOTA
Slo se buscarn variables en las primeras y ltimas 10 lneas.

Existen variables para soportar la mayora de conguraciones en katepart, y adems los complementos las pueden utilizar, en cuyo caso deberan estar explicadas en la documentacin del complemento.

8.5.1.

Cmo usa kate las variables

Cuando lee la conguracin, katepart busca en los siguientes sitios (en este orden): La conguracin global. Datos opcionales de la sesin. La conguracin del tipo de archivo. Variables de documento en el propio documento. Conguraciones cambiadas durante la edicin desde el men o desde la lnea de rdenes. Como se puede imaginar las variables de documento tienen la mxima prioridad. Cuando se guarda un documento, se vuelven a leer las variables de documento, y se sobreescriben los cambios hechos utilizando los elementos del men o la lnea de rdenes. Cualquier variable no listada a continuacin se guarda en el documento y puede ser consultada por otros objetos tales como extensiones, que las pueden utilizar para sus propios propsitos. Por ejemplo la variable indent mode utiliza variables de documento para su propia conguracin. Las variables que se listan aqu documentan la versin 2.4 de Kate. Se podrn aadir ms variables en el futuro. Existen 3 tipos de valores denidos para las variables, con las siguientes expresiones vlidas: 57

Manual de Kate

BOOL - on|off|true|false|1|0 INTEGER - cualquier nmero entero STRING - todo lo dems VARIABLES DISPONIBLES auto-brackets [BOOL] Activa o desactiva la insercin de parntesis. auto-center-lines [INT] Congura el nmero de lneas de autocentrado. auto-insert-doxygen [BOOL] Activa o desactiva la insercin de asteriscos principales en los comentarios doxygen. Esto no tendr efecto a menos que se utilice el sangrado automtico cstyle. background-color [STRING] Congura el color del fondo del documento. El valor debe ser algo que pueda ser evaluado como un color vlido, por ejemplo #ff0000. backspace-indents [BOOL] Activa o desactiva el sangrado con retroceso. block-selection [BOOL] Activa o desactiva la seleccin de bloques. bom | byte-order-marker [BOOL] Activa/desactiva el marcador del orden de bytes al guardar archivos en formato Unicode (utf8, utf16, utf32). Desde: Kate 3.4 (KDE 4.4) bracket-highlight-color [STRING] Congura el color del resaltado de parntesis. El valor debe ser algo evaluable como color vlido, por ejemplo #ff0000. current-line-color [STRING] Congura el color para la lnea actual. El valor debe ser algo que pueda ser evaluado como un color vlido, por ejemplo #ff0000. default-dictionary [STRING] Establece el diccionario predenido para comprobar la ortografa. Desde: Kate 3.4 (KDE 4.4) dynamic-word-wrap [BOOL] Activa o desactiva el ajuste automtico de lnea. eol | end-of-line [STRING] Congura el nal del modo de lnea. Los valores vlidos son unix, mac y dos encoding [STRING] Congura la codicacin del documento. El valor debe ser un nombre vlido de codicacin, similar a utf-8. folding-markers [BOOL] Activa o desactiva la visualizacin de las marcas.

58

Manual de Kate

font-size [INT] Congura el tamao del punto del tipo de letra del documento. font [STRING] Congura el tipo de letra del documento. El valor debera ser un nombre vlido de tipo de letra, por ejemplo courier. hl | syntax [STRING] Establece el resaltado de sintaxis. Las cadenas vlidas son todos los nombres disponibles en los mens, por ejemplo, para C++ basta con escribir C++. icon-bar-color [STRING] Congura el color de la barra de iconos. El valor debe ser algo que pueda ser evaluado como un color vlido, por ejemplo #ff0000. icon-border [BOOL] Activa o desactiva la visualizacin del borde de iconos. indent-mode [STRING] Congura el modo de sangrado automtico. Las opciones reconocidas son none, normal, cstyle, haskell, python, lilypond, ruby y lisp. Consulte la seccin Seccin 4.8 para obtener ms detalles. indent-width [INT] Congura el ancho del sangrado. keep-extra-spaces [BOOL] Indica cuando se mantendrn los espacios extra al calcular el ancho de sangrado. keep-indent-profile [BOOL] Si est activado, evita que no sea sangrado el bloque completo si hay al menos una lnea que tiene sangrado. Nota: Eliminado en Kate 3 (KDE 4) line-numbers [BOOL] Activa o desactiva la visualizacin de los nmeros de lnea. mixed-indent [BOOL] Activa o desactiva el modo de sangrado al estilo mixto Emacs. Nota: Obsoleto desde Kate 3 en KDE4. Esta variable se ignora, y en su lugar se debe marcar replace-tabs on; para el futuro. overwrite-mode [BOOL] Activa o desactiva el modo de sobreescritura. persistent-selection [BOOL] Activa o desactiva las selecciones persistentes. remove-trailing-space [BOOL] Activa o desactiva la limpieza del nal de lnea dinmico. replace-tabs-save [BOOL] Activa o desactiva la conversin tabulador->espacio durante el guardado.Activa o desactiva la conversin tabulador->espacio durante el guardado.Activa o desactiva la conversin tabulador->espacio durante el guardado.Activa o desactiva la conversin tabulador>espacio durante el guardado.Activa o desactiva la conversin tabulador->espacio durante el guardado.

59

Manual de Kate

replace-tabs [BOOL] Activa o desactiva la conversin dinmica tabulador->espacio. replace-trailing-space-save [BOOL] Activa o desactiva la limpieza del nal de lnea durante el guardado. scheme [STRING] Congura el esquema de color. La cadena debe ser un nombre de esquema de color que exista en su conguracin para conseguir cualquier efecto. selection-color [STRING] Congura la seleccin de color. El valor debe ser algo que pueda ser evaluado como un color vlido, por ejemplo #ff0000. show-tabs [BOOL] Activa o desactiva la visualizacin del caracter TAB. smart-home [BOOL] Activa o desactiva la navegacin inteligente. space-indent [BOOL] Activa o desactiva el sangrado con espacios. Nota: Obsoleto desde Kate 3 en KDE4. La combinacin de sangrados es el comportamiento predenido. Establezca replace-tabs on; para utilizar el sangrado solo con espacios. tab-indents [BOOL] Activa o desactiva el sangrado con la tecla TAB. tab-width [INT] Congura el ancho de tabulador que se va a mostrar. undo-steps [INT] Congura el nmero de pasos para deshacer que puede recordar. Nota: Obsoleto desde Kate 3 en KDE4. Esta variable se ignora. El nmero mximo de pasos a deshacer es ilimitado. word-wrap-column [INT] Congura el ancho del ajuste de lnea. word-wrap-marker-color [STRING] Congura el color del marcador del ajuste de lnea. El valor debe ser algo que pueda ser evaluado como un color vlido, por ejemplo #ff0000. word-wrap [BOOL] Activa o desactiva el ajuste de lnea. wrap-cursor [BOOL] Activa o desactiva el margen del cursor.

60

Manual de Kate

Captulo 9

Crditos y licencia
Derechos de autor de Kate. 2000, 2001, 2002 - 2005. El equipo de desarrollo de Kate. E L EQUIPO DE K ATE Christoph Cullmann cullmann@kde.org Administrador del proyecto y desarrollador principal. Anders Lund anders@alweb.dk Desarrollador central, resaltado de sintxis de Perl, documentacin. Joseph Wenninger kde@jowenn.at Desrrollador principal, resaltado de sintaxis. Michael Bartl michael.bartl1@chello.at Desarrollador principal. Phlip phlip_cpp@my-deja.com El compilador del proyecto. Waldo Bastian bastian@kde.org El estupendo sistema de bfer. Matt Newell newellm@proaxis.com Pruebas... Michael McCallum gholam@xtra.co.nz Desarrollador principal. Jochen Wilhemly digisnap@cs.tu-berlin.de Autor de KWrite Michael Koch koch@kde.org Porte de KWrite a KParts. Christian Gebauer gebauer@bigfoot.com. Sin especicar. Simon Hausmann hausmann@kde.org Sin especicar.

61

Manual de Kate

Glen Parker glenebob@nwlink.com Historial de deshacer de KWrite, Integracin de KSpell. Scott Manson sdmanson@alltel.net Soporte de resaltado de sintxis XML de KWrite. John Firebaugh jrebaugh@kde.org Parches varios. Dominik Haumann dhdev@gmx.de Desarrollador principal, resaltado de sintaxis. M UCHAS OTRAS PERSONAS HAN CONTRIBUIDO : Matteo Merli merlim@libero.it Resaltado para archivos de especicacin RPM, diff y ms. Rocky Scaletta rocky@purdue.edu Resaltado para VHDL. Yury Lebedev Resaltado para SQL. Chris Ross Resaltado para Ferite. Nick Roux Resaltado para ILERPG. John Firebaugh. Resaltado para Java, y mucho ms. Carsten Niehaus. Resaltado para LaTeX. Per Wigren Resaltado para Makeles, Python. Jan Fritz Resaltado para Python. Daniel Naber Pequeos arreglos de errores, extensin XML. Derechos de autor de la documentacin. 2000,2001. Seth Rothberg sethmr@bellatlantic.org. Derechos de autor de la documentacin. 2002, 2003, 2005. Anders Lund anders@alweb.dk. Traducido por Pablo de Vicente pablo.devicente@gmail.com. Traducido por Miguel Revilla Rodrguez yo@miguelrevilla.com. Traducido por Marcos Fouces Lagomfouces@yahoo.es. Traducido por Santiago Fernndez Sanchosanti@kde-es.org. Esta documentacin est sujeta a los trminos de la Licencia de Documentacin Libre GNU. Este programa est sujeto a los trminos de la Licencia Pblica General GNU.

62

Manual de Kate

Apndice A

Trabajo con resaltado de sintaxis


A.1. Introduccin

El resaltado de sintaxis es lo que hace que el editor muestre automticamente texto en diferentes estilos y colores, dependiendo de la funcin de la cadena en relacin al propsito del archivo. En el cdigo fuente de un programa, por ejemplo, las sentencias de control se pueden presentar en negrita, mientras que los tipos de datos y los comentarios pueden tener diferentes colores que el resto del texto. Esto mejora notablemente la legibilidad del texto, y ayuda al autor a ser ms eciente y productivo.

Una funcin de perl, presentada con resaltado de sintaxis.

La misma funcin de perl, sin el resaltado.

63

Manual de Kate

De los dos ejemplos, cul resulta ms sencillo de leer? Kate cuenta con un sistema de resaltado de sintaxis exible, congurable y capaz, la distribucin estndar proporciona deniciones para un gran conjunto de lenguajes de programacin, descripcin y realizacin de guiones, a parte de otros formatos. Adems usted puede incluir sus propias deniciones en simples archivos XML. Kate detectar automticamente las reglas de sintaxis correctas cuando abra un archivo, basndose en el tipo MIME de dicho archivo, determinado por su extensin, o, si no tiene, por su contenido. Si la eleccin no es la correcta, usted puede establecerla manualmente en el men Documento Modo resaltado. Los estilos y colores utilizados en cada denicin del resaltado de sintaxis pueden congurarse en la solapa Estilos de resaltado , del dilogo de conguracin, mientras que los tipos MIME para los que se debe utilizar, se pueden congurar en la solapa Modos y tipos de archivo.

NOTA
El resaltado de sintaxis tiene su uso en la mejora de la legibilidad del texto, pero no puede conar en ello como prueba de que el texto es correcto. Marcar el texto en funcin de su sintaxis puede ser difcil, dependiendo del formato que est utilizando, y en algunos casos los autores de las reglas de sintaxis pueden estar orgullosos si el 98 % del texto se procesa correctamente, ya que har falta un estilo muy raro para poder ver el 2 % incorrecto.

SUGERENCIA
Puede descargar o actualizar deniciones de resaltado de sintaxis de la pgina web de Kate pulsando el botn Descargar... en la solapa Modos y tipos de archivo del Dilogo de conguracin.

A.2.

El sistema de resaltado de sintaxis de Kate

Esta seccin tratar sobre el mecanismo de resaltado de sintaxis de Kate con ms detalle. Le recomendamos su lectura si desea aprender sobre ello, o si desea crear o modicar las deniciones de sintaxis.

A.2.1.

Cmo funciona

Siempre que abre un archivo, una de las primeras cosas que hace el editor de Kate es detectar qu denicin de sintaxis se utilizar en dicho archivo. Mientras va leyendo el texto del archivo, y mientras va escribiendo en l, el sistema de resaltado de sintaxis analiza el texto utilizando las reglas establecidas por la denicin de sintaxis y marcando dnde comienzan y terminan los diferentes contextos y estilos. Cuando usted escribe en el documento, el nuevo texto es analizado y marcado al vuelo, as que si borra un carcter que marca el principio o el nal de un contexto, el estilo del texto adyacente cambia consecuentemente. Las deniciones de sintaxis utilizadas por el sistema de resaltado de sintaxis de Kate son archivos XML, que contienen: Reglas para decidir la relevancia del texto, organizadas en bloques de contexto. Listas de palabras clave. Deniciones de estilos de elementos. Al analizar el texto, las reglas de deteccin se evalan en el orden en el que estn denidas, y si el principio de la cadena actual coincide con la regla, se utiliza el contexto relacionado. El punto de inicio del texto se mueve al punto nal en el que la regla coincide y comienza un nuevo ciclo de reglas, comenzando en el contexto establecido por la regla coincidente. 64

Manual de Kate

A.2.2.

Reglas

Las reglas de deteccin son el ncleo del sistema de deteccin del resaltado. Una regla es una cadena, un carcter o una expresin regular contra la que se debe hacer coincidir el texto que est siendo analizado. Contiene informacin sobre el estilo a utilizar para la parte coincidente del texto. Puede cambiar el contexto de trabajo del sistema, ya sea hacia un contexto mencionado explcitamente o hacia el anterior contexto utilizado por el texto. Las reglas se organizan en grupos de contextos. Un grupo de contexto se utiliza para los conceptos principales del texto dentro del formato, por ejemplo, las cadenas de texto entrecomilladas o los bloques de comentarios en el cdigo fuente de un programa. Esto garantiza que el sistema de resaltado no necesita realizar un ciclo por todas las reglas cuando no es necesario, y que algunas secuencias de caracteres del texto se pueden tratar de forma diferente dependiendo del contexto actual. Es posible generar dinmicamente contextos para permitir el uso de datos especcos de instancias en las reglas.

A.2.3.

Estilos y palabras clave del contexto

En algunos lenguajes de programacin, los nmeros enteros son tratados por el compilador (el programa que convierte el cdigo fuente en un ejecutable binario) de una forma diferente a los de coma otante, y puede que haya caracteres que tengan un signicado especial dentro de una cadena entrecomillada. En esos casos, tiene sentido procesarlos de diferente manera que el texto adyacente, para que resulten fciles de identicar. As que incluso si no representan contextos especiales, pueden ser vistos como tales por el sistema de resaltado de sintaxis, as que son marcados para un procesado diferente. Una denicin de sintaxis puede contener tantos estilos como sean requeridos para cubrir todos los conceptos del formato para el que se utilizan. En muchos formatos hay listas de palabras que representan un concepto especco. Por ejemplo, en los lenguajes de programacin, las sentencias de control son un concepto, los nombres de los tipos de datos otro, y la funciones integradas en el lenguaje son un tercero. El sistema de resaltado de sintaxis de Kate puede utilizar tales listas para detectar y marcar palabras del texto para enfatizar conceptos de los formatos de texto.

A.2.4.

Estilos predeterminados

Si abre un archivo de cdigo fuente de C++, un archivo fuente de Java y un archivo HTML en Kate podr comprobar que aunque los formatos son diferentes, y por lo tanto las palabras que reciben un tratamiento especial tambin son diferentes, los colores utilizados son los mismos. Esto es debido a que Kate tiene una lista predenida de estilos predeterminados, que se emplean en las deniciones de sintaxis individuales. Esto facilita el reconocer conceptos similares en diferentes formatos de texto. Por ejemplo, los comentarios estn presentes en prcticamente cualquier lenguaje de programacin, guiones o descripcin, y si se presentan utilizando el mismo estilo en todos los lenguajes, usted no tendr que pararse a pensar e identicar su posicin en el texto.

SUGERENCIA
Todos los estilos de denicin de sintaxis utilizan uno de los estilos predeterminados. Hay pocas deniciones de sintaxis que utilicen ms estilos de los que hay de forma predeterminada, as que, si utiliza un formato muy a menudo, puede que le merezca la pena abrir el dilogo de conguracin para ver si algunos conceptos estn utilizando el mismo estilo. Por ejemplo, slo hay un estilo predeterminado para las cadenas, pero como el lenguaje de programacin perl utiliza dos tipos de cadena, puede mejorar el resaltado congurando ambas de forma ligeramente diferente. Ms adelante se explicarn todos los estilos includos predeterminados.

65

Manual de Kate

A.3.
A.3.1.

El formato XML de denicin de resaltados


Introduccin

Esta seccin es una introduccin al formato XML de denicin de resaltado. Describe los componentes principales, su signicado y utilizacin, y entra en detalles con las reglas de deteccin. La denicin formal, es decir, el DTD, se almacena en el archivo language.dtd, que debera estar instalado en el directorio $KDEDIR /share/apps/kate/syntax de su sistema. L AS SECCIONE PRINCIPALES DE LAS DEFINICIONES DE RESALTADO DE K ATE Todos los archivos de resaltado contienen un encabezado que dene la denicin de XML y el doctype (tipo de documento):
<? xml version ="1.0" encoding =" UTF -8"? > <! DOCTYPE language SYSTEM " language . dtd ">

La parte principal del archivo de denicin es el elemento languaje. Los atributos disponibles son: Atributos requeridos: name congura el nombre del lenguaje. Despus aparecer en el men y en los dilogos. section especica la categora. extensions dene las extensiones de los archivos, como *.cpp;*.h Atributos opcionales: mimetype archivos MIME asociados al tipo en que se basan. version especica la versin actual del archivo de denicin. kateversion especica la ltima versin soportada por Kate. casesensitive dene, si las palabras clave son sensibles a maysculas y minsculas o no. priority se necesita si otra denicin de resaltado utiliza las mismas extensiones. Se utilizar la de mayor prioridad. author contiene el nombre del autor y su direccin de correo electrnico. license contiene la licencia, normalmente LPGL, artstica, GPL y otras. hidden dene cundo debera aparecer el nombre en los mens de Kate. De ah que dicha lnea pueda tener un aspecto similar a:
< language name =" C ++" version ="1.00" kateversion ="2.4" section =" Sources " extensions ="*. cpp ;*. h" />

A continuacin estara el elemento highlighting, que contiene el elemento opcional list y los elementos requeridos contexts e itemDatas. Los elementos list contienen una lista de palabras clave. En este caso las palabras clave son class y const. Puede aadir tantas listas como necesite. El elemento contexts contiene todos los contextos. El primer contexto es el predeterminado y con l se iniciar el resaltado. Existen dos reglas en el contexto Normal Text, que harn coincidir la lista de palabras clave con el nombre somename y una regla que detecta una comilla y cambia el contexto a string. Para aprender ms sobre las reglas lea el siguiente captulo. La tercera parte es el elemento itemDatas. Contiene todos los colores y tipos de letra que necesitan los contextos y las reglas. En este ejemplo, se utilizan itemData Normal Text, String y Keyword. 66

Manual de Kate

< highlighting > < list name =" somename "> <item > class </ item > <item > const </ item > </ list > < contexts > < context attribute =" Normal Text " lineEndContext ="# pop " name =" Normal Text " > < keyword attribute =" Keyword " context ="# stay " String =" somename " /> < DetectChar attribute =" String " context =" string " char ="& quot ;" /> </ context > < context attribute =" String " lineEndContext ="# stay " name =" string " > < DetectChar attribute =" String " context ="# pop " char ="& quot ;" /> </ context > </ contexts > < itemDatas > < itemData name =" Normal Text " defStyleNum =" dsNormal " /> < itemData name =" Keyword " defStyleNum =" dsKeyword " /> < itemData name =" String " defStyleNum =" dsString " /> </ itemDatas > </ highlighting >

La ltima parte de la denicin de resaltado es la seccin opcional general. Puede contener informacin sobre palabras clave, plegado de cdigo, comentarios y sangrado. La seccin comment dene con qu cadena se introduce un comentario en una lnea sencilla. Tambin puede denir comentarios en mltiples lneas utilizando multiLine con el atributo adicional end. Esto se utiliza si el usuario pulsa el correspondiente acceso rpido para comentar/descomentar. La seccin keywords dene si las listas de palabras clave son sensibles a maysculas y minsculas o no. Posteriormente se explicarn otros atributos.
< general > < comments > < comment name =" singleLine " start ="#"/ > </ comments > < keywords casesensitive ="1"/ > </ general > </ language >

A.3.2.

Las secciones al detalle

Esta parte describe todos los atributos para los contextos, listas de datos, palabras clave, comentarios, plegado de cdigo y sangrado. El elemento context pertenece al grupo contexts. Un contexto dene las reglas especcas de contexto que se deben seguir cuando el sistema de resaltado alcanza el nal de una lnea. Los atributos disponibles son: name es el nombre del contexto. Las reglas utilizarn el nombre para especicar el contexto al que cambiar en el caso de que coincidan las reglas. lineEndContext dene el contexto al que cambiar el sistema de resaltado si alcanza el nal de la lnea. Puede ser un nombre u otro contexto, #stay permitir que no se cambie el 67

Manual de Kate

contexto (p. ej., no hacer nada) o #pop har que se salga de este contexto. Es posible utilizar por ejemplo #pop#pop#pop para salir tres veces. lineBeginContext dene el contexto si se encuentra el comienzo de una lnea. De forma predeterminada: #stay. fallthrough dene si el sistema de resaltado cambiar al contexto especicado en fallthroughtContext si no coinciden las reglas. De forma predeterminada vale false. fallthroughContext especica el siguiente contexto si no hay reglas que coincidan. dynamic si vale true, el contexto recordar cadenas/elementos reemplazables guardados por las reglas dinmicas. Esto se necesita, por ejemplo, en los documentos HERE. Su valor predeterminado es false. El elemento itemData se encuentra en el grupo itemDatas. Dene el estilo y los colores de los tipos de letra. Por tanto es posible denir sus propios estilos y colores, sin embargo recomendamos utilizar los estilos predeterminados, ya que as el usuario ver colores homogneos para los diferentes lenguajes. Si bien, algunas veces no existen otras posibilidades y es necesario cambiar el color y los atributos de los tipos de letra. Los atributos name y defStyleNum son necesarios, los otros son opcionales. Los atributos disponibles son: name congura el nombre del itemData. Los contextos y las reglas utilizarn este nombre en sus atributos attribute para referenciar un itemData. defStyleNum dene qu estilo se utilizar de forma predeterminada. Los estilos predeterminados disponibles se explicarn posteriormente. color dene un color. Los formatos vlidos son #rrggbb o #rgb. selColor dene el color de la seleccin. italic. Si vale true el texto se mostrar en cursiva. bold. Si vale true el texto se mostrar en negrita. underline. Si vale true el texto se mostrar subrayado. strikeout. Si vale true el texto se mostrar tachado. El elemento keywords en el grupo general dene la propiedad keyword. Los atributos disponibles son: casesensitive puede valer true o false. Si vale true, todas las palabras clave son sensibles a maysculas y minsculas. weakDeliminator es una lista de caracteres que no actan como delimitadores de palabras (delimitador dbil). Por ejemplo el punto . es un delimitador de palabra. Si tenemos una palabra clave en una list que contiene un punto, solo la encontrar si especica el punto como delimitador dbil. additionalDeliminator dene delimitadores adicionales. wordWrapDeliminator dene los caracteres tras los cuales se puede producir un ajuste de lnea. Los delimitadores predeterminados de ajuste de lnea son los caracteres .():!+,-<=> %&*/;?[]{|}~\, espacio ( ) y tabulador (\t). El elemento comment en el grupo comments dene las propiedades de los comentarios que va a utilizar Herramientas Comentar y Herramientas Descomentar. Los atributos disponibles son: name puede ser singleLine o multiLine. Si selecciona multiLine se necesitan los atributos end y region. start dene la cadena que se utiliza para iniciar un comentario. En C++ debera ser /*. end dene la cadena utilizada para cerrar un comentario. En C++ debera ser */. region debera ser el nombre con el que se guardar el comentario multilnea. Si asumimos que tenemos una regin beginRegion=Comentario ... endRegion=Comentario en sus reglas debera utilizar region=Comentario. De esta forma se descomentar incluso aunque no haya seleccionado todo el texto en un comentario multilnea. Solo es necesario que el cursor est dentro del comentario multilnea. 68

Manual de Kate

El elemento folding en el grupo general dene las propiedades de plegado del cdigo. Los atributos disponibles son: indentationsensitive. Si vale true, los marcadores de plegado de cdigo se aadirn al sangrado, como en el lenguaje de script Python. Normalmente no necesitar utilizarlo, y por ello su valor predeterminado es false. El elemento indentation en el grupo general dene qu sangrado se utilizar, sin embargo, le recomendamos fervientemente que omita este elemento, ya que el elemento de sangrado suele estar congurado en el tipo de archivo o al aadir el modo de lnea al archivo de texto. Aunque especique un sangrado, podr forzar un sangrado especco para un usuario, por otra que le agrade ms. Los atributos disponibles son: mode es el nombre del sangrado. Los sangrados a la derecha disponibles son: normal, cstyle, csands, xml, python y varindent.

A.3.3.

Estilos predeterminados disponibles

Los estilos predeterminados ya se explicaron, a modo de resumen: Los estilos predeterminados estn predenidos para los estilos de tipos de letras y colores. Veamos la lista de los estilos predeterminados disponibles: dsNormal, utilizados para el texto normal. dsKeyword, utilizados para las palabras clave. dsDataType, utilizados para los tipos de datos. dsDecVal, utilizados para los valores decimales. dsBaseN, utilizados para los valores en una base diferente a 10. dsFloat, utilizados para valores de coma otante. dsChar, utilizados para caracteres. dsString, utilizados para cadenas. dsComment, utilizados para comentarios. dsOthers, utilizados para otras cosas. dsAlert, utilizados para mensajes de aviso. dsFunction, utilizados para llamadas a funciones. dsRegionMarker, utilizados para marcadores de regin. dsError, utilizados para errores de resaltado y sintaxis incorrecta.

A.4.

Reglas de deteccin del resaltado

Esta seccin describe las reglas de deteccin del resaltado. Cada regla puede coincidir en ninguno o con varios caracteres del principio de la cadena con la que se comparan. Si la regla coincide, a los caracteres coincidentes se les asigna el estilo o atributo denido por la regla, asimismo una regla puede pedir que se cambie el contexto actual. Una regla tiene este aspecto:
< NombreRegla attribute ="( identificador )" context ="( identificador )" [ atributos especficos de la regla ] />

El atributo identica el estilo que utilizaran los caracteres coincidentes por nombre, y el contexto identica el contexto a utilizar desde aqu. El contexto se puede identicar por: 69

Manual de Kate

Un identicador, que es el nombre de los otros contextos. Una orden que le indica al motor que permanezca en el contexto actual (#stay), o que salte al contexto anterior (#pop). Para retroceder ms pasos, se puede repetir la palabra clave #pop: #pop#pop#pop Algunas reglas pueden tener reglas hijas que se ejecutan nicamente si la regla padre resulta aplicable. A toda la cadena coincidente se le dar el atributo denido por la regla padre. Una regla con reglas hijas tiene este aspecto:
< NombreRegla ( atributos ) > < NombreReglaHija ( atributos ) /> ... </ NombreRegla >

Los atributos especcos de la regla varan, y se describen en las siguientes secciones. ATRIBUTOS COMUNES attribute: Un mapa de atributos de un determinado itemData. context: Especica el contexto al que cambiar el sistema de resaltado si las reglas coinciden. beginRegion: Inicia un bloque de plegado de cdigo. Valor predeterminado: unset. endRegion: Finaliza un bloque de plegado de cdigo. Valor predeterminado: unset. lookAhead: Si vale true, el sistema de resaltado no procesar las longitudes coincidentes. Valor predeterminado: false. rstNonSpace: Coincidirn nicamente si la cadena no contiene un espacio en blanco al principio de la lnea. Valor predeterminado: false. column: nicamente coincidir si coincide la columna. Valor predeterminado: unset. R EGLAS DINMICAS dynamic: puede ser (true|false).

A.4.1.

Las reglas al detalle

DetectChar Detecta un nico carcter especicado. Normalmente se utiliza, por ejemplo, para hallar el nal de las cadenas entrecomilladas.
< DetectChar char ="( caracter )" ( atributos comunes ) ( dynamic ) />

El atributo char dene el carcter a localizar. Detect2Chars Detecta dos caracteres especicados en el orden denido.
< Detect2Chars char ="( caracter )" char1 ="( caracter )" ( atributos comunes ) ( dynamic ) />

El atributo char dene el primer carcter a localizar, char1 el segundo. AnyChar Detecta un carcter de un conjunto de caracteres especicados. 70

Manual de Kate

< AnyChar String ="( cadena )" ( atributos comunes ) />

El atributo String dene el conjunto de caracteres. StringDetect Detecta una cadena exacta.
< StringDetect String ="( string )" [ insensitive =" true | false "] ( atributos comunes ) ( dynamic ) />

El atributo String dene la cadena a localizar. El atributo insensitive tiene como valor predeterminado false y se pasa a la funcin de comparacin de cadena. Si el valor es true la comparacin no es sensible a maysculas y minsculas. RegExpr Busca la coincidencia con una expresin regular.
< RegExpr String ="( string )" [ insensitive =" true | false "] [ minimal =" true | false "] ( atributos comunes ) ( dynamic ) />

El atributo String dene la expresin regular. insensitive tiene false como valor predeterminado y se pasa al motor de expresiones regulares. minimal tiene false como valor predeterminado y se pasa al motor de expresiones regulares. Como siempre se trata de que las reglas coincidan con el principio de la cadena actual, una expresin regular que comience con el smbolo del circunejo () indica que la regla se debe comparar nicamente con el principio de una lnea. Vea la seccin sobre expresiones regulares para obtener ms informacin. keyword Detecta una palabra clave de una lista especicada.
< keyword String ="( nombre de la lista )" ( atributos comunes ) />

El atributo String identica la lista de palabras claves por su nombre. Debe existir una lista con ese nombre. Int Detecta un nmero entero.
<Int ( atributos comunes ) ( dynamic ) />

Esta regla no tiene atributos especcos. Las reglas hijas normalmente se utilizan para detectar combinaciones de L y U despus del nmero, indicando el tipo de entero en el cdigo del programa. En realidad se admiten todas las reglas como reglas hijas, aunque, el DTD nicamente permite la regla hija StringDetect. El siguiente ejemplo encuentra nmeros enteros seguidos del caracter L.
<Int attribute =" Decimal " context ="# stay " > < StringDetect attribute =" Decimal " context ="# stay " String =" L" insensitive =" true "/ > </Int >

Float Detecta un nmero de coma otante. 71

Manual de Kate

< Float ( atributos comunes ) />

Esta regla no tiene atributos especcos. Se permite AnyChar como regla hija y normalmente se utiliza para detectar combinaciones, va la regla Int para obtener una referencia. HlCOct Detecta una representacin numrica de un nmero octal.
< HlCOct ( atributos comunes ) />

Esta regla no tiene atributos especcos. HlCHex Detecta una representacin numrica de un nmero hexadecimal.
< HlCHex ( atributos comunes ) />

Esta regla no tiene atributos especcos. HlCStringChar Detecta un carcter escapado.


< HlCStringChar ( atributos comunes ) />

Esta regla no tiene atributos especcos. Localiza representaciones tipogrcas de caracteres que se utilizan habitualmente en el cdigo de programacin, por ejemplo \n (nueva lnea) o \t (TAB). Los siguientes caracteres cumplirn con la regla si siguen a una barra inversa (\): abefnr tv?\. Adems sern vlidos los nmeros hexadecimales escapados como por ejemplo \xff, y los nmeros octales escapados como \033. HlCChar Detecta un carcter C.
< HlCChar ( atributos comunes ) />

Esta regla no tiene atributos especcos. Localiza caracteres C encerrados en una marca (Ejemplo: c). La marca puede ser un caracter simple o un caracter escapado. Va HICStringChar para localizar secuencias de caracteres escapados. RangeDetect Detecta una cadena con caracteres de inicio y n denidos.
< RangeDetect char ="( carcter )" /> char1 ="( carcter )" ( atributos comunes )

char dene el carcter que inicia el rango, char1 el carcter que naliza el rango. Es muy til para detectar por ejemplo pequea cadenas entrecomilladas y similares, pero tenga en cuenta que el motor de resaltado puede trabajar slo con una cada vez, as que no se detectarn cadenas que estn divididas en dos lneas o ms. LineContinue Localiza el nal de la lnea.
< LineContinue ( atributos comunes ) />

72

Manual de Kate

Esta regla no tiene atributos especcos. Esta regla es prctica para cambiar el contexto al nal de la lnea, si el ltimo caracter es una barra inversa (\). Esto es necesario por ejemplo en C/C++ para continuar macros o cadenas. IncludeRules Incluye reglas de otro contexto o lenguaje/archivo.
< IncludeRules context =" contextlink " [ includeAttrib =" true | false "] />

El atributo context dene el contexto a incluir. Si es una cadena simple incluye todas las reglas denidas en el contexto actual, ejemplo:
< IncludeRules context =" anotherContext " />

Si la cadena comienza con ## el sistema de resaltado buscar otra denicin de lenguaje con el nombre dado, ejemplo:
< IncludeRules context ="## C ++" />

Si el atributo includeAttrib vale true, cambia el atributo de destino por otro de la fuente. Esto es necesario, por ejemplo, para comentar trabajo, si el texto coincide con contexto introducido se utiliza un resaltado diferente que con el contexto antrin. DetectSpaces Detecta espacios en blanco
< DetectSpaces ( atributos comunes ) />

Esta regla no tiene atributos especcos. Utilice esta regla si sabe que pueden existir varios espacios en blanco delante, por ejemplo, al principio de las lneas sangradas. Esta regla saltar todos los espacios en blanco a la vez, en lugar de comprobar mltiples reglas y saltar si no existen coincidencias. DetectIdentier Detecta identicadores de cadenas (como una expresin regular: [a-zA-Z_][a-zA-Z0-9_]*).
< DetectIdentifier ( atributos comunes ) />

Esta regla no tiene atributos especcos. Utilice esta regla para saltar una cadena de una palabra de caracteres, en lugar de comprobar mltiples reglas y saltar si no existen coincidencias.

A.4.2.

Trucos tiles

Si solo debe localizar dos caracteres utilice Detect2Chars en lugar de StringDetect. Lo mismo se aplica a DetectChar. Las expresiones regulares son fciles de utilizar pero algunas veces existen formas mucho ms rpidas de obtener el mismo resultado. Imagine que nicamente desea localizar el caracter # si ste es el primer caracter de la lnea. Un solucin basada en una expresin regular sera algo parecido a esto:
< RegExpr attribute =" Macro " context =" macro " String ="^\ s *" />

Puede conseguir lo mismo mucho ms rpido utilizando:

73

Manual de Kate

< DetectChar attribute =" Macro " context =" macro " char ="#" firstNonSpace =" true " />

Si desea que la expresin regular localice # tambin puede utilizar DetectChar con el atributo column=0. El atributo column cuenta los caracteres base, por tanto el tabulador es solo un caracter. Puede cambiar de contexto sin procesar caracteres. Suponga que desea cambiar de contexto cuando encuentra una cadena */ , pero necesita procesar esta cadena en el siguiente contexto. La siguiente regla lo localizar, y el atributo lookAhead har que se guarde la cadena localizada para el siguiente contexto.
< Detect2Chars attribute =" Comment " context ="# pop " char ="*" char1 ="/" lookAhead =" true " />

Utilice DetectSpaces si sabe cuantos espacios en blanco existen. Utilice DetectIdentifier en lugar de la expresin regular [a-zA-Z_]\w*. Utilice los estilos predeterminados siempre que pueda. De esta forma el usuario se encontrar con un entorno familiar. Va otros archivos XML para comprobar de qu forma otras personas implementan reglas delicadas. Puede validar cada uno de los archivos XML utilizando la orden xmllint --dtdvalid lenguaje.dtd miSintaxis.xml. Si repite expresiones regulares complejas muy frecuentemente puede utlizar ENTITIES (entidades). Ejemplo:
<? xml version ="1.0" encoding =" UTF -8"? > <! DOCTYPE language SYSTEM " lenguaje . dtd " [ <! ENTITY miref "[A -Za - z_ :][\ w .:_ -]*" > ]>

Ahora puede utilizar &miref; en lugar de la expresin regular.

74

Manual de Kate

Apndice B

Expresiones regulares
Este apndice contiene una breve pero probablemente suficiente y completa introduccin al mundo de las expresiones regulares. Documenta las expresiones regulares tal y como aparecen en Kate, que no son compatibles con las expresiones regulares de perl, ni de grep, entre otros.

B.1.

Introduccin

Las expresiones regulares no proporcionan un mtodo para describir el posible contenido de una cadena de texto de forma que pueda ser interpretada por un pequeo mdulo de software, y se pueda investigar si un texto corresponde con el buscado y, en el caso de aplicaciones avanzadas, se pongan los medios para recuperar partes del texto coincidente. Por ejemplo: pongamos que quiere buscar un texto que es el comienzo de un prrafo e incluye los nombres Henrik o Pernille, seguidos de alguna forma del verbo hablar. En una bsqueda normal, debera comenzar a buscar por el primer nombre, Henrik quiz seguido de hab, de esta manera: Henrik hab, y mientras busca coincidencias, debe descartar aquellas que no estn al principio de un prrafo, as como aquellas en las que la palabra que comience por hab no pertenezca al verbo hablar. Y despus volver a repetir todo el proceso con el otro nombre... Con las expresiones regulares, esta tara se puede acometer en una sla bsqueda, y con una gran precisin. Para conseguirlo, las expresiones regulares denen reglas para expresar detalladamente una generalizacin de la cadena a buscar. Nuestro ejemplo, que podramos expresar literalmente como: una lnea que comienza por Henrik o por Pernille (posiblemente depus de 4 espacios en blanco o tabuladores) seguido de un espacio en blanco seguido de hab y despus laba o l, se podra expresar con la siguiente expresin regular: [ \t]{0,4}(Henrik|Pernille) hab(laba|l) El ejemplo anterior muestra los cuatro conceptos principales de las expresiones regulares modernas, veamos: Patrones. Declaraciones. Cuanticadores. Retroreferencias.

75

Manual de Kate

El circunejo () que se encuentra al principio de la expresin es una declaracin, que slo es cierta si el resto de la cadena de bsqueda se encuentra al principio de una lnea. Las cadenas [ \t] y (Henrik|Pernille) hab(laba|l) son patrones. El primero es una clase de caracteres que coincide con un espacio en blanco o con un tabulador (horizontal); el otro patrn contiene un primer subpatrn que coincide con Henrik o con Pernille, despus una parte de coincidencia exacta hab y por ltimo otro subpatrn que coincide con laba o con l. La cadena {0,4} es un cuanticador que dice en cualquier lugar desde 0 a 4 caracteres anteriores. Como el software de expresiones regulares que cuenta con el concepto de retroreferencias guarda toda la parte coincidente de la cadena as como los subpatrones encerrados entre parntesis, proporcionando medios para acceder a esas referencias, podemos poner nuestras manos tanto en la cadena coincidente completa (cuando se busca en un texto de un editor por medio de una expresin regular, que normalmente aparece marcada como seleccionada) como en el nombre encontrado o en la ltima parte del verbo. Uniendo todo, la expresin coincidir donde nosotros queramos, y nicamente ah. Las siguientes secciones describirn con detalle cmo construir y utilizar patrones, clases de caracteres, declaraciones, cuanticadores y retroreferencias, y la ltima seccin presentar una serie de ejemplo tiles.

B.2.

Patrones

Los patrones constan de cadenas literales y clases de caracteres. Los patrones pueden contener subpatrones, que son patrones colocados entre parntesis.

B.2.1.

Escape de caracteres

En los patrones, as como en las clases de caracteres, algunos caracteres tienen un signicado especial. Para conseguir una coincidencia literal con alguno de esos caracteres, es necesario marcarlos como escapados para permitir al intrprete de expresiones regulares comprender que esos caracteres deben ser includos con su signicado literal. Esto se hace precendiendo el caracter de una barra inversa (\). El software de expresiones regulares ignorar el escapado de cualquier caracter que no tenga ningn signicado especial en el contexto, as que escapar, por ejemplo, j (\j) no tiene por qu causar problemas. Si tiene dudas sobre cuando un caracter puede tener un signicado especial, escpelo con seguridad. El escapado incluye el propio caracter de la barra inversa. Para poder presentarla de forma literal, debe escribir \\.

B.2.2.

Clases de caracteres y abreviaturas

Una clase de caracteres es una expresin que coincide con un conjunto de caracteres denido. En las expresiones regulares, las clases de caracteres se denen colocando los caracteres vlidos de la clase entre corchetes [], o utilizando una de las clases abreviadas que se describen a continuacin. Las clases de caracteres sencillas nicamente contienen uno o ms caracteres literales, por ejemplo [abc] (que coincidir con las letras a, b o c) o [0123456789] (que coincidir con cualquiera de los dgitos). Como las letras y los nmeros tienen un orden lgico, puede abreviarlo utilizando rangos: [ a-c] es igual a [abc] y [0-9] es igual a [0123456789]. Combinando estas formaciones,

76

Manual de Kate

por ejemplo [a-fynot1-38] resulta completamente vlido (esta ltima debera coincidir con cualquier de los caracteres o dgitos a,b,c,d, e,f,y,n,o,t, 1,2,3 o 8). Como las letras maysculas son diferentes caracteres que sus equivalentes minsculas, para crear una clase de caracteres que sea independiente del formato de las letras, deber escribir [aAbB]. Tambin es posible crear una clase negativa para que se haga coincidir todo menos. Para hacerlo incluya un circunejo () al principio de la clase: [abc] coincidir con cualquier caracter salvo con a, b o c. Adems de los caracteres literales, hay algunas abreviaturas denidas, para facilitar un poco las cosas: \a Coincide con el caracter ASCII de la campanilla (BEL, 0x07). \f Coincide con el caracter ASCII del salto de pgina (FF, 0x0C). \n Coincide con el caracter ASCII de salto de lnea (LF, 0x0A, nueva lnea en Unix). \r Coincide con el caracter ASCII de retorno de carro (CR, 0x0D). \t Coincide con el caracter ASCII del tabulador horizontal (HT, 0x09). \v Coincide con el caracter ASCII del tabulador vertical (VT, 0x0B). \xhhhh Coincide con el caracter Unicode correspondiente al nmero hexadecimal hhhh (entre 0x0000 y 0xFFFF). \0ooo (es decir, \cero ooo) coincide con el caracter ASCII/Latin-1 correspondiente al nmero octal ooo (entre 0 y 0377). . (punto) Coincide con cualquier caracter (incluyendo nueva lnea). \d Coincide con un dgito. Es igual que [0-9]. \D Coincide con un no dgito. Es igual que [0-9] o [\d] \s Coincide con un caracter de espacio en blanco. Prcticamente igual que [\t\n\r] \S Coincide con un no espacio en blanco. Prcticamente igual que [\t\r\n], e igual que [\ s]. \w Coincide con cualquier caracter de una palabra, en este caso cualquier letra o nmero. Tenga en cuenta que el subrayado (_) no est incluido, a diferencia de las expresiones regulares de perl. Es igual que [a-zA-Z0-9]. \W Coincide con cualquier caracter que no sea de una palabra, cualquier cosa menos letras o nmeros. Es igual que [a-zA-Z0-9] o [\w]. Las clases abreviadas se puede colocar dentro de una clase propia, por ejemplo para hacer coincidir un caracter de una palabra, un espacio en blanco o un punto, puede escribir [\w \.].

NOTA
Las notacin POSIX de las clases, [:<class name>:] no est de momento implementada.

77

Manual de Kate

B.2.2.1.

Caracteres con signicado especial dentro de las clases de caracteres

Los siguientes caracteres tienen un signicado especial dentro de la construccin de clases de caracteres [], y es necesario escaparlos para que sean includos literalmente en la clase: ] Finaliza la clase de caracteres. Debe estar escapado salvo que sea el primer caracter de la clase (puede seguir a un circunejo no escapado). (circunejo) Indica que se trata de una clase negativa, si es el primer caracter. Debe estar escapado para buscar una coincidencia literal en el caso de que sea el primer caracter de la clase. - (guin) Indica un rango lgico. Debe estar escapado siempre que se busque la coincidencia literal. \ (barra inversa) El caracter de escape. Debe estar siempre escapado.

B.2.3.

Alternativas: coincidencias con uno de

Si desea que la coincidencia sea de uno de una serie de patrones, puede separarlos con | (caracter de barra vertical). Por ejemplo, para encontrar John o Harry, debera utilizar una expresin de la forma John| Harry.

B.2.4.

Subpatrones

Los subpatrones son patrones colocados entre parntesis, y tienen varios usos en el mundo de las expresiones regulares. B.2.4.1. Especicacin de alternativas

Puede utilizar un subpatrn para agrupar un conjunto de alternativas dentro de un patrn ms grande. Las alternativas se separan con el caracter | (barra vertical). Por ejemplo, para buscar la coincidencia de las palabras int, oat o double, se podra utilizar el patrn int|float|double. Si nicamente desea encontrar una de ellas en el caso de que vaya seguida de algn tipo de espacio en blanco y despus algunas letras, ponga las alternativas dentro de un subpatrn: (int|float|double)\s+\w+. B.2.4.2. Captura del texto coincidente (retroreferencias)

Si desea utilizar una retroreferencia, utilice un subpatrn para que se recuerde la parte deseada del patrn. Por ejemplo, si desea buscar dos ocurrencias de la misma palabra separadas por una coma y posiblemente algn espacio en blanco, puede escribir (\w+),\s*\1. El subpatrn \w+ localizar un conjunto de caracteres de una palabra, y la expresin entera coincidir si ese conjunto va seguido de una coma, 0 o ms espacios en blanco y despus un conjunto de caracteres de una palabra igual al primero. (La cadena \1 hace referencia al primer subpatrn delimitado por parntesis).

78

Manual de Kate

B.2.4.3.

Declaraciones de anticipacin

Una declaracin de anticipacin es un subpatrn, que comienza por ?= o por ?!. Por ejemplo, si quiere buscar la cadena literal Bill, pero nicamente si no va seguida de Gates, puede utilizar la expresin: Bill(?! Gates). (Esto coincidira con Bill Clinton y con Billy el nio, pero ignorara en silencio las otras coincidencias). Los subpatrones utilizados en las declaraciones no se capturan. Consulte tambin Declaraciones.

B.2.5.

Caracteres con un signicado especial dentro de los patrones.

Los siguientes caracteres tienen signicado dentro de los patrones, y es necesario escaparlos para una coincidencia literal: \ (barra inversa) El caracter de escape. (circunejo) Declara el comienzo de la cadena. $ Declara el n de la cadena. () (parntesis derecho e izquierdo) Denotan subpatrones. {} (llaves derecha e izquierda) Denotan cuanticadores numricos. [] (corchetes derecho e izquierdo) Denotan clases de caracteres. | (barra vertical) O lgico. Separa alternativas. + (signo ms) Cuanticador, 1 o ms. * (asterisco) Cuanticador, 0 o ms. ? (signo de interrogacin) Un caracter opcional. Se puede interpretar como cuanticador, 0 o 1.

B.3.

Cuanticadores

Los cuanticadores permiten que una expresin regular coincida con un nmero o un rango de nmeros de cualquier caracter, una clase de caracteres o un subpatrn. Los cuanticadores se colocan entre llaves ({ y }). Tiene la forma general {[apariciones-mnima s][,[apariciones-mximas]]} Su uso se explica mejor en este ejemplo:

79

Manual de Kate

{1} Exactamente 1 aparicin. {0,1} Cero o 1 apariciones. {,1} Lo mismo, pero con menos trabajo ;) {5,10} Como mnimo 5 y como mximo 10 apariciones. {5,} Como mnimo 5 apariciones, sin mximo. Adems, hay algunas abreviaturas: * (asterisco) Similar a {0,}, encuentra cualquier nmero de apariciones. + (signo ms) Similar a {1,}, al menos 1 aparicin. ? (signo de interrogacin) Similar a {0,1}, cero o 1 apariciones.

B.3.1.

Codicia

Cuando se utilizan cuanticadores sin mximo, las expresiones regulares tratan de coincidir con la mayor parte posible de la cadena buscada, conocindose este comportamiento como codicioso. Los procesadores de expresiones regulares modernos, proporcionan los medios para desactivar la codicia, aunque en los entornos grcos depende del interfaz el tener acceso a esta caracterstica. Por ejemplo, un dilogo de bsqueda que permita expresiones regulares, podra tener una casilla de comprobacin llamada Coincidencia mnima. Adems podra haber una indicacin sobre que el comportamiento predeterminado es el codicioso.

B.3.2.

Ejemplos en contexto

Estos son algunos ejemplos que utilizan cuanticadores: \d{4,5}\s Coincide con los dgitos en 1234 ya y 12345 ahora, pero no con los de 567 once ni los de 223459 algn lugar. \s+ Coincide con uno o ms espacios en blanco. (bla){1,} Coincide con blablabla y con el bla de blanco o tabla. /?> Coincide con /> en <cerrado/> as como con > en <abierto>.

80

Manual de Kate

B.4.

Declaraciones

Las declaraciones permiten que una expresin regular coincida nicamente bajo una serie de condiciones controladas. Una declaracin no necesita la coincidencia de un caracter, sino que investiga los alrededores en una busca de una posible coincidencia antes de darla por vlida. Por ejemplo, la declaracin lmite de palabra no intenta encontrar un caracter que no sea de una palabra en oposicin a uno que s lo sea en su posicin, en vez de eso trata de asegurarse de que no es un caracter de una palabra. Esto signica que la declaracin puede ser vlida en el caso de que no haya ningn caracter, es decir al nal de la cadena buscada. Algunas declaraciones, de hecho, no tienen un patrn con el que coincidir, sino que la parte coincidente de la cadena no ser parte del resultado de la coincidencia de la expresin completa. Las expresiones regulares documentadas aqu soportan las siguientes declaraciones: (circunejo: el principio de una cadena) Concuerda con el comienzo de la cadena buscada. La expresin Peter coincidir con Peter en la cadena Peter, hola! pero no en Hola Peter! $ (nal de la cadena) Coincide con el nal de la cadena buscada. La espresin t\?$ coincidir con el nal de la cadena No lo has hecho t?, pero con ninguna parte de T no lo has hecho? \b (lmite de palabra Coincide si hay un caracter de una palabra a un lado y otro que no sea de una palabra al otro. Esto es muy til para encontrar el nal de las palabras, o ambos extremos para delimitar la palabra entera. La expresin \ben\b coincidir con el en separado en la cadena Estamos en el borde de la ventana, pero no con el en de ventana. \B (lmite de no palabra) Coincide con todo lo que \b no coincide. Eso signica que coincidir, por ejemplo, dentro de las palabras: La expresin \Ben\B coincidir en ventana pero no en entero o en estoy en mi casa. (?=PATRN) (Anticipacin positiva) Una declaracin de anticipacin busca la parte de la cadena seguida de una posible coincidencia. La antipacin positiva previene la coincidencia de la cadena si el texto que sigue no corresponde al PATRN de la declaracin, y el texto que coincide con eso no ser incluido en el resultado. La expresin util(?=\w) coincidir con util en utilitario pero no en Eso es de gran utilidad. (?!PATRN) (Anticipacin negativa) La anticipacin negativa previene una posible coincidencia si la parte siguiente de la cadena coincide con el PATRN. La expresin const \w+\b(?!\s*&) coincidir con const char en la cadena const char* foo, mientras que no coincidir con const QString en const QString& bar, ya que el & coincide con el patrn de la declaracin de anticipacin negativa.

81

Manual de Kate

Apndice C

Instalacin
Kate forma parte del proyecto KDE http://www.kde.org/ . Kate est incluido en el paquete kdebase en ftp://ftp.kde.org/pub/kde/ , el servidor FTP del proyecto KDE. Consulte Construir KDE4 desde el cdigo fuente para obtener informacin detallada sobre cmo compilar e instalar aplicaciones de KDE Como KDE usa cmake, no debera tener ningn problema para compilarlo. Si encuentra alguna dicultad le rogamos que se dirija a las listas de distribucin de KDE.

82

Manual de Kate

Apndice D

ndice alfabtico
_ rea de edicin, 9 C comentariost, 20 congurar conguracin preferencias, 45 D descomentar, 20 E El selector de archivos, 10 Emulador de terminal, 11 L La ventana principal, 8 Lista de documentos, 9 R reemplazo de cadenas al estilo de sed Bsqueda al estilo de sed, 24

83

You might also like