# Configuración de &kate;

## Introducción

&kate; ofrece varias formas de configurar la aplicación para que se comporte como se desea. Los más importantes son:

El diálogo de configuración

- Es la principal herramienta de configuración, que le permite configurar &kate;, el componente de edición y el uso de extensiones.

El menú Opciones

- Le permite cambiar opciones utilizadas frecuentemente, e iniciar los diálogos de configuración.

El menú Ver

- Le permite dividir el marco actual, así como mostrar los iconos y el panel con los números de línea para el documento actualmente editado.

El terminal integrado utiliza la configuración definida en &systemsettings;, y se puede configurar pulsando el botón derecho del ratón para mostrar un menú contextual.

## El diálogo principal de configuración

El diálogo de configuración de &kate; muestra un árbol de temas en la parte izquierda, y una página de configuración correspondiente al tema seleccionado en la parte derecha.

La configuración está dividida en dos grupos llamados

- Configuración de la aplicación

- Configuración del componente de edición

## Configuración de la aplicación &kate;

Este grupo contiene páginas para configurar la aplicación principal de &kate;

### General

Esta sección contiene unas pocas opciones globales para &kate;

Comportamiento

- Advertir de los archivos modificados por procesos externos

- Cuando está activada, &kate; le avisará cuando aplicaciones externas modifiquen los archivos una vez que reciba el foco. Podrá trabajar con varios archivos modificados a la vez, podrá recargar, guardar o descartar los archivos cambiados en grupos.

  Sino está activado, &kate; le preguntará que desea hacer cuando el foco de la aplicación se sitúe en un archivo que se ha modificado fuera de la aplicación.

Meta-información

- Mantener metainformación entre sesiones

- Cuando se active, &kate; guardará los metadatos tales como marcadores y configuración de sesión incluso cuando cierre sus documentos. Los datos utilizarán si el documento se vuelve a abrir sin cambios.

Eliminar meta información no utilizada después de

- Asigna el número máximo de días para mantener metainformación de los archivos abiertos previamente. Esto contribuye a mantener la base de datos de metainformación de un tamaño razonable.

### Sesiones

Esta sección contiene opciones relativas a utilizar sesiones.

Elementos de las sesiones

- Incluir configuración de ventana

- Si está activada, &kate; guardará la configuración de la ventana con cada sesión.

Comportamiento al iniciar la aplicación

- Seleccione el comportamiento que desee para &kate; al iniciarse. Esta configuración se puede cambiar especificando qué hacer en la línea de órdenes.

  Iniciar nueva sesión

- Con esta opción, &kate; iniciará una nueva sesión sin nombre al iniciar la aplicación.

Cargar la última sesión utilizada

- &kate; utilizará la sesión más recientemente abierta al inicio. Esto es bueno si desea utilizar siempre el mismo nombre de sesión o cambiarlo en contadas ocasiones.

Elegir una sesión de forma manual

- &kate; mostrará un pequeño diálogo que le permitirá elegir su sesión preferida o cargar la sesión predeterminada si no se ha guardado ninguna. Este es el comportamiento predeterminado. Es adecuado si utiliza muchas sesiones diferentes con frecuencia.

Los cambios en los datos de sesión (archivos abiertos y, si está activada, la ventana de configuración) siempre se guardarán.

### Complementos

Esta página proporciona una lista de los complementos instalados para la aplicación &kate;. Cada complemento está representada por su nombre y una pequeña descripción. Puede marcar la casilla de verificación de un elemento para activar el complemento que representa.

Si un complemento tuviera opciones de configuración, aparecerá una sección subordinada a esta página para poder configurarlo.

Para obtener más información sobre los complementos disponibles, consulte plugins.

### Documentos

Sombrear el fondo

- Esta sección le permitirá activar o desactivar la visualización del sombreado del fondo de su actividad reciente, y seleccionar qué colores se utilizarán si está activado.Vea la sección sobre La lista de documentos para obtener más información sobre esta característica.

Ordenar por

- Configura la forma en que se ordenará la lista de documentos. También se puede configurar desde el menú que aparece al utilizar el &RMB; en la lista de documentos.

Modo de visualización

- Proporciona dos opciones que hacen afectan al aspecto de la vista de la herramienta de Documentos. La opción Vista de árbol mostrará los documentos en un árbol debajo de las carpetas en la que se encuentran, mientras que la opción Vista de lista mostrará una lista simple de documentos.

Mostrar ruta completa

- Cuando la vista de árbol y esta opción están activadas, las entradas de las carpetas que aparecen en la vista de la herramienta de documentos mostrarán la ruta completa del sistema de archivos a la carpeta, además del nombre de la carpeta. Esto no tiene efecto en la vista de lista.

&configuring-part-sections;

## Configuración con variables de documentos

Las variables de &kappname; son una implementación de las variables de documento de katepart, parecidas a las de &Emacs; y vi. En katepart, las líneas tendrán el formato `kate: NOMBREVARIABLE VALOR; [ NOMBREVARIABLE VALOR; ...]`. Las líneas se pueden integrar 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. El punto y coma es obligatorio.

Veamos un ejemplo de línea de variable, que fuerza la configuración del sangrado para un archivo C++, java o javascript:

    // kate: replace-tabs on; indent-width 4; indent-mode cstyle;

Solo se buscarán variables en las primeras y últimas 10 líneas.

Además, las variables de los documentos se pueden colocar en un archivo llamado `.kateconfig` en cualquier directorio y las preferencias configuradas se aplicarán de la misma forma que si las líneas de modo se hubieran introducido en cada uno de los archivos del directorio y sus subdirectorios, a tantos niveles de profundidad como se haya indicado en la profundidad de búsqueda configurada. Las variables de documento de `.kateconfig` usan la misma sintaxis que las líneas de modo.

Existen variables para soportar la mayoría de configuraciones en katepart, y además los complementos las pueden utilizar, en cuyo caso deberían estar explicadas en la documentación del complemento.

### Cómo usa &kappname;las variables

Cuando lee la configuración, katepart busca en los siguientes sitios (en este orden):

- La configuración global.

- Datos opcionales de la sesión.

- La configuración del «tipo de archivo».

- Variables de documento en `.kateconfig`.

- Configuraciones realizadas durante la edición desde el menú o desde la línea de órdenes.

Como puede observar, las variables de documento solo se sustituyen por los cambios realizados en tiempo de ejecución. Cada vez que se guarda un documento, se vuelven a leer las variables de documento y se sobrescriben los cambios realizados mediante las opciones de menú o la línea de órdenes.

Cualquier variable no listada a continuación se guarda en el documento y puede ser consultada por otros objetos tales como complementos, que las pueden utilizar para sus propios propósitos. Por ejemplo, la variable indent mode utiliza variables de documento para su propia configuración.

Las variables que se listan aquí documentan la versión 3.7 de &kappname;. Se podrán añadir más variables en el futuro. Existen 3 tipos de valores definidos para las variables, con las siguientes expresiones válidas:

- BOOL - on|off|true|false|1|0

- INTEGER - cualquier número entero

- STRING - todo lo demás

### Variables disponibles

    auto-center-linesINT

- Configura el número de líneas de autocentrado.

    auto-insert-doxygenBOOL

- Activa o desactiva la inserción de asteriscos al principio de los comentarios doxygen. Esto no tendrá efecto a menos que se utilice el sangrado automático de estilo C.

    background-colorSTRING

- Configura el color del fondo del documento. El valor debe ser algo que pueda ser evaluado como color válido, por ejemplo, `#ff0000`.

    backspace-indentsBOOL

- Activar o desactivar la anulación de sangrado cuando se pulsa &Backspace;.

    block-selectionBOOL

- Activa o desactiva la selección de bloque.

    bom | byte-order-markerBOOL

- Activa o desactiva el marcador del orden de bytes al guardar archivos en formato Unicode (utf8, utf16, utf32).

  A partir de &kate; 3.4 (&kde; 4.4)

    encodingSTRING

- Establece la codificación utilizada para cargar o guardar el archivo. Como las variables del documento se leerán tras la carga, esto se tiene en cuenta únicamente a la hora de guardar. Si las coloca en un archivo `.kateconfig`, también tendrá efecto en la carga.

  A partir de &kate; 3.10 (&kde; 4.10)

    bracket-highlight-colorSTRING

- Configura el color del resaltado de paréntesis. El valor debe ser algo evaluable como color válido, por ejemplo, `#ff0000`.

    current-line-colorSTRING

- Configura el color para la línea actual. El valor debe ser algo que pueda ser evaluado como color válido, por ejemplo, `#ff0000`.

    default-dictionarySTRING

- Establece el diccionario predefinido para comprobar la ortografía.

  A partir de &kate; 3.4 (&kde; 4.4)

    dynamic-word-wrapBOOL

- Activa o desactiva el ajuste dinámico de línea.

    eol | end-of-lineSTRING

- Configura el modo de fin de línea. Los valores válidos son `unix`, `mac` y `dos`

    folding-markersBOOL

- Activa o desactiva la visualización de las marcas.

    font-sizeINT

- Configura el tamaño del punto del tipo de letra del documento.

    fontSTRING

- Configura el tipo de letra del documento. El valor debería ser un nombre válido de tipo de letra, por ejemplo, `courier`.

    hl | syntaxSTRING

- Establece el resaltado de sintaxis. Las cadenas válidas son todos los nombres disponibles en los menús. Por ejemplo, para C++, basta con escribir `C++`.

    icon-bar-colorSTRING

- Configura el color de la barra de iconos. El valor debe ser algo que pueda ser evaluado como color válido, por ejemplo, `#ff0000`.

    icon-borderBOOL

- Activa o desactiva la visualización del borde de iconos.

    indent-modeSTRING

- Configura el modo de sangrado automático. Las opciones reconocidas son `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` and `xml`. Consulte la sección kate-part-autoindent para obtener más detalles.

    indent-pasted-textBOOL

- Activar o desactivar el sangrado de ajuste del texto copiado desde el portapapeles.

  A partir de &kate; 3.11 (&kde; 4.11)

    indent-widthINT

- Configura el ancho del sangrado.

    keep-extra-spacesBOOL

- Indica cuando se mantendrán los espacios extra al calcular el ancho de sangrado.

    line-numbersBOOL

- Activa o desactiva la visualización de los números de línea.

    mixed-indentBOOL

- Activa o desactiva el modo de sangrado al estilo mixto, como en &Emacs;.

  Nota: Obsoleto desde &kate;3 en &kde;4. Esta variable se ignora y en su lugar, se debe marcar `replace-tabs on;` en adelante.

    newline-at-eofBOOL

- Añade una línea vacía al final del archivo (EOF) cuando se guarda el documento.

  A partir de &kate; 3.9 (&kde; 4.9)

    overwrite-modeBOOL

- Activa o desactiva el modo de sobreescritura.

    persistent-selectionBOOL

- Activa o desactiva la selección persistente

    remove-trailing-spaceBOOL

- Activa o desactiva la limpieza del final de línea dinámico.

  Nota: obsoleto a partir de &kde; 4.10. En su lugar, utilice remove-trailing-spaces con la opción deseada.

    remove-trailing-spacesSTRING

- Elimina los espacios al final al guardar el documento. Las opciones válidas son:

  - `none`, `-` o `0`: no eliminar espacios al final nunca.

  - `modified`, `mod`, `+` o `1`: elimina los espacios al final solo en las líneas modificadas. El sistema de modificación de líneas marca las líneas modificadas.

  - `all`, `*` o `2`: elimina los espacios al final en todo el documento.

  A partir de &kde; 4.10, quedan obsoletas las opciones `remove-trailing-space` y `replace-trailing-space-save`.

    replace-tabs-saveBOOL

- Activa o desactiva la conversión de tabulador a espacio.

    replace-tabsBOOL

- Activa o desactiva la conversión de tabulador dinámico a espacio.

    replace-trailing-space-saveBOOL

- Activa o desactiva la limpieza del final de línea durante el guardado.

  Nota: obsoleto a partir de &kde; 4.10. En su lugar, utilice remove-trailing-spaces con la opción deseada.

    schemeSTRING

- Configura el esquema de color. La cadena debe ser un nombre de esquema de color que exista en su configuración para conseguir cualquier efecto.

    selection-colorSTRING

- Configura la selección de color. El valor debe ser algo que pueda ser evaluado como color válido, por ejemplo,`#ff0000`.

    show-tabsBOOL

- Activa o desactiva la visualización del carácter TAB.

    smart-homeBOOL

- Establece navegación inteligente de la carpeta personal a activo o inactivo.

    space-indentBOOL

- Activa o desactiva el sangrado con espacios.

  Nota: Obsoleto desde &kate; 3 en &kde;4. La combinación de sangrados es el comportamiento predefinido. Establezca `replace-tabs on;` para utilizar el sangrado solo con espacios.

    tab-indentsBOOL

- Activa o desactiva el sangrado con la tecla .

    tab-widthINT

- Configura el ancho de tabulador que se va a mostrar.

    undo-stepsINT

- Configura el número de pasos para deshacer que puede recordar.

  Nota: Obsoleto desde &kate; 3 en &kde;4. Esta variable se ignora. El número máximo de pasos a deshacer es ilimitado.

    word-wrap-columnINT

- Activa o desactiva el ancho del ajuste estático de línea.

    word-wrap-marker-colorSTRING

- Configura el color del marcador del ajuste de línea. El valor debe ser algo que pueda ser evaluado como color válido, por ejemplo, `#ff0000`.

    word-wrapBOOL

- Activa o desactiva el ajuste de línea estático.