<chapter id="configuring-kate">
<chapterinfo>
<authorgroup>
<author
><personname
><firstname
></firstname
></personname
></author>
<othercredit role="translator"
> <firstname
>Pablo</firstname
> <surname
>de Vicente</surname
> <affiliation
><address
><email
>vicente@oan.es</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
> <othercredit role="translator"
> <firstname
>Marcos</firstname
> <surname
>Fouces Lago</surname
> <affiliation
><address
><email
>mfouces@yahoo.es</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
> <othercredit role="translator"
> <firstname
>Santiago</firstname
> <surname
>Fernández Sancho</surname
> <affiliation
><address
><email
>santi@est.unileon.es</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Configuración de &kate;</title>

<sect1 id="configuring-overview">
<title
>Introducción</title>
<para>
<indexterm>
<primary
>Configurar</primary>
<secondary
>Configuración</secondary>
<tertiary
>Preferencias</tertiary
></indexterm>
<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> &kate; ofrece varias formas de configurar la aplicación para que se comporte como se desea. Los más importantes son: </para>

<variablelist>
<varlistentry>
<term id="configure"
>El diálogo de configuración</term>
<listitem
><para
>Es la principal herramienta de configuración, que le permite configurar &kate;, el componente de edición y el uso de extensiones.</para
></listitem>
</varlistentry>
<varlistentry>
<term id="settings"
>El menú <guimenu
>Opciones</guimenu
></term>
<listitem
><para
>Le permite cambiar opciones utilizadas frecuentemente, e iniciar los diálogos de configuración.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>El menú <guimenu
>Ver</guimenu
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>
</variablelist>

<para
>La Konsole empotrada utiliza la configuración definida en el &kcontrolcenter;, y puede ser configurada pulsando el botón derecho del ratón y eligiendo el submenú <guimenuitem
>Opciones</guimenuitem
>.</para>

</sect1>

<sect1 id="configuring-kate-configdialog">
<title
>El diálogo principal de configuración</title>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="configdialog01.png"/>
</imageobject>
</mediaobject>

<para
>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. El árbol agrupa las páginas de configuración en grupos lógicos.</para>

<sect2 id="config-dialog">
<title
>El grupo &kate;</title>
<para
>Este grupo contiene páginas para configurar la aplicación principal de &kate;.</para>

<sect3 id="config-dialog-general">
<title
>La página general</title>
<para
>Opciones globales de &kate;.</para>

<variablelist>
<varlistentry>
<term
>Modo de aplicación</term>
<listitem>
<para
><indexterm
><primary
>MDI</primary
><secondary
>SDI</secondary
></indexterm>
Este grupo le permite elegir entre los modos <acronym
>MDI</acronym
> y <acronym
>SDI</acronym
> de &kate;, seleccionando el botón apropiado.</para>
 <para
>El modo <acronym
>MDI</acronym
> (interfaz de múltiples documentos) de &kate;, que es el predeterminado, hace que &kate; utilice una sola ventana para todos los archivos abiertos. Puede elegir el documento a editar en la lista de archivos (anclada de forma predeterminada en la parte izquierda de la ventana de &kate;) o seleccionando el documento en el menú <guimenu
>Documento</guimenu
>.</para>
<para
>El modo <acronym
>SDI</acronym
> (inferfaz de un único documento) de &kate; hace que cada documento se abra en una ventana independiente, y la lista de archivos tendrá una ventana separada.</para>
 <para
>Si cambia esta opción, necesitará reiniciar &kate; para que surta efecto.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Al inicio</term>
<listitem
><para
>Estas opciones determinan cómo y si &kate; restaurará su sesión de edición al ser iniciado después de un apagado normal (si es restaurado por el administrador de sesiones, &kate; tratará siempre de recuperar la sesión con la mayor fidelidad a como se encontraba la última vez que se utilizó &kate;).</para>

<variablelist>
<varlistentry>
<term>
<anchor id="config-dialog-general-reopen-files"/>
<guibutton
>Reabrir archivos</guibutton
></term>
<listitem
><para
>Si esta opción está activada, los archivos que se encontraban abiertos cuando se cerró &kate;, serán reabiertos. Se recuperarán los marcadores y la posición del cursor. El borde de iconos y los parámetros del número de líneas del último editor utilizado también se reestablecerán.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Restaurar configuración de vista</guibutton
></term>
<listitem
><para
>Si esta opción está activada, &kate; intentará restaurar sus marcos exactamente como los dejó.</para
></listitem>
</varlistentry>
</variablelist>

</listitem>

</varlistentry>

<varlistentry>
<term
><guibutton
>Restringir a una sóla sesión</guibutton
></term>
<listitem
><para
>Si esta opción está activada significa que sólo puede tener funcionando una sesión de &kate; en un momento dado. Si intenta iniciar otra, la sesión actual tomará el control y abrirá los archivos solicitados. Por ejemplo, si utiliza &kate; para mostrar el código fuente de las páginas web en Konqueror, todas ellas se abrirán en una única sesión de &kate; si esta opción está activada.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Mostrar contenidos al redimensionar marcos</guibutton
></term
> <listitem
><para
>Si esta opción está activada, las ventanas serán completamente redibujadas mientras se arrastran los divisores de marcos. Si la opción está desactivada, se utilizará una <quote
>banda elástica</quote
> (indicando el nuevo tamaño del marco) en su lugar.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-general-sync-konsole"/>
<guibutton
>Sincronizar Konsole con el documento activo</guibutton
></term>
<listitem
><para
>Esto hará que &konsole; cambie al directorio del documento activo al iniciarse, y cuando se seleccione un nuevo documento comience en dicho directorio. Si no está activado, tendrá que navegar por su cuenta con &konsole;. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Número de archivos recientes</guibutton
></term>
<listitem
><para
>Como es de esperar, ésto le permite decidir la longitud del menú de archivos <guimenu
>Abrir reciente</guimenu
>.</para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="config-dialog-documentlist">
<title
>La página de listado de documentos</title>
<para
>Esta página 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.Véa la sección sobre <link linkend="kate-mdi-tools-file-list"
>La lista de documentos</link
> para obtener más información sobre esta característica.</para>
</sect3>

<sect3 id="config-dialog-externaltools">
<title
>Herramientas externas</title>

<para
>En el menú <guimenu
>Herramientas</guimenu
> encontrará un submenú llamado <guisubmenu
>Herramientas externas</guisubmenu
>. Estas herramientas llaman a aplicaciones externas con datos relativos al documento actual, por ejemplo su URL, directorio, texto o selección. Esta página le permitirá administrar el menú y editar, eliminar o añadir nuevas herramientas.</para>

<para
>Cada herramienta externa es una órden de consola que contiene macros que representan los datos del documento. Cuando se activan, las macros se substituyen con datos del documento activo.</para>

<variablelist>
<title
>Propiedades de las herramientas externas</title>
<varlistentry>
<term
>Etiqueta</term>
<listitem
><para
>Una etiqueta para la herramienta externa en el menú.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Script</term>
<listitem
><para
>El script que se ejecutará cuando la herramienta se active. Antes de pasar el script al intérprete se sustituirán las siguientes macros: <variablelist>
<varlistentry>
<term
>%URL</term>
<listitem
><para
>La URL completa del documento actual, o una cadena vacía si el documento no se ha guardado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%URLS</term>
<listitem
><para
>Una lista de las URLs de todos los documentos abiertos separadas por espacios (excepto aquellos que no se han guardado).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%directory</term>
<listitem
><para
>El directorio que forma parte de la URL del documento actual o una cadena vacía si el documento actual no ha sido guardado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%filename</term>
<listitem
><para
>el nombre de archivo del documento actual sin la ruta, o una cadena vacía si el documento actual no ha sido guardado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%line</term>
<listitem
><para
>El número de línea en la que se encuentra el cursor dentro del documento actual.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%column</term>
<listitem
><para
>El número de columna en la que se encuentra el cursor en el documento actual.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%selection</term>
<listitem
><para
>El texto seleccionado en el documento actual, o una cadena vacía si no hay texto seleccionado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%text</term>
<listitem
><para
>El texto completo del documento actual. Tenga cuidado ya que esto puede hacer que se supere el tamaño máximo de orden permitido por su sistema. Utilícelo con cuidado.</para
></listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Ejecutable</term>
<listitem
><para
>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 <envar
>PATH</envar
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Tipos MIME</term>
<listitem
><para
>Una lista separada por dos puntos con los tipos mime para los que esta orden debería estar disponible. Actualmente está en desuso.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Guardar</term>
<listitem
><para
>Opcionalmente puede decidir guardar el documento actual o todos los documentos antes de ejecutar el script. Es práctico si su script lee el archivo del disco.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Nombre de la línea de comandos</term>
<listitem
><para
>Si rellena esto, la herramienta estará disponible en los <link linkend="advanced-editing-tools-commandline"
>editores de la línea de órdenes</link
> como <command
>exttool-<replaceable
>Nombre de la línea de órdenes</replaceable
></command
> (la cadena que introduzca aquí precedida de <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="config-dialog-editor">
<title
>El grupo editor</title>
<para
>Este grupo contiene todas las páginas relacionadas con el editor de &kate;. La mayor parte de las configuraciones que se encuentran aquí son las predeterminadas, y pueden ser sobreescritas por <link linkend="config-dialog-editor-filetypes"
>denificiones de tipos de archivo</link
>, por <link linkend="config-variables"
>variables de documento</link
> o por cambios en el propio documento durante una sesión de edición.</para>

<sect3 id="config-dialog-editor-colors">
<title
>La páginas <guilabel
>Colores</guilabel
></title
> <para
>Esta página le permite cambiar los colores de fondo y de fondo de la selección del editor. Inicialmente, &kate; utilizará los colores establecidos por el &kcontrolcenter;, en la página <menuchoice
><guimenu
>Aspecto y comportamiento</guimenu
><guimenuitem
>Colores</guimenuitem
> </menuchoice
>.</para>

<para
>Para cambiar un color, pulse el botón asociado y seleccione el color deseado en el selector de colores.</para>

<note
><para
>Hay ciertos colores de fondo que pueden hacer el texto con sintaxis resaltada resulte ilegible. Debería elegir un color claro para el fondo, y un color oscuro para el fondo de selección. </para>
<para
>En otro caso, lo más probable es que tenga que cambiar los <link linkend="config-dialog-editor-highlight-default-styles"
>Estilos predeterminados</link
>.</para>
</note>
</sect3>

<sect3 id="config-dialog-editor-fonts">
<title
>La página de fuentes</title
> <!-- FIXME LINKS //-->

<para
>Esta página le permite elegir los tipos de letra predeterminados de &kate;. Los parámetros utilizados se aplicarán también a &kwrite; y a la visualización de archivos de texto de &konqueror;.</para>

<para
>Esta página consta de dos apartados, uno para los tipos de letra del editor y otro para el tipo de letra de impresión. Seleccione un apartado y elija el tipo de letra deseado. El comportamiento predeterminado es utilizar la opción configurada globalmente por &kde; para el tipo de letra de anchura fija.</para>

<tip
><para
>Al no ser posible en este momento utilizar tipos de letra individuales para cada documento, ni cambiar el tipo de letra para impresión en el diálogo de impresión, tenga cuidado. Se recomienda un tipo de letra de anchura fija. </para
></tip>
</sect3>

<sect3 id="config-dialog-editor-indent">
<title
>La página de sangrías</title>
<para
>Esta página le permite cambiar el comportamiento de las sangrías.</para>

<variablelist>
<title
>Opciones de sangrar</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-auto-indent"/>
<guibutton
>Sangrado automático</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; aplicará automáticamente una sangría a las nuevas líneas igual a la sangría de la línea anterior. Si la línea anterior está vacía, se utilizará la información de la superior que tenga contenidos.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-indent-with-spaces"/>
<guibutton
>Sangrar con espacios</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; realizará la sangría con espacios en vez de con tabuladores.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-backspace-key-indents"/>
<guibutton
>Tecla retroceder sangra</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; eliminará la sangría hasta dejarla al nivel de la línea superior más cercana con contenido al pulsar la tecla <keycap
>Retroceder</keycap
>, si la parte de la línea que precede al cursor tiene tan sólo un espacio en blanco.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-tab-key-indents"/>
<guibutton
>Tecla tabulador sangra</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; sangrará la línea actual hasta igualarla con la línea superior más cercana con contenido si pulsa la tecla <keycap
>Tabulador</keycap
>, si la parte de la línea que precede al cursor contiene tan sólo un espacio en blanco.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-keep-extra-spaces"/>
<guibutton
>Mantener espacios extra</guibutton>
</term>
<listitem>
<para
>Si este comportamiento está activado, &kate; dejará espacios en blanco antes del cursor después de aplicar la sangría.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-select">
<title
>La página Seleccionar</title>

<para
>Esta página proporciona opciones para ajustar con más precisión el comportamiento de &kate; a la hora de seleccionar.</para>

<variablelist>
<title
>Opciones de selección</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-persistent-selections"/>
<guibutton
>Selecciones persistentes</guibutton>
</term>
<listitem>
<para
>Si está activada esta opción, el pulsar una tecla no hace que la selección sea eliminada o deseleccionada.</para>
<note
><para
>Esta opción tiene algún conflicto con la opción Sobreescribir selecciones. Si ambas están activadas, el pegar un texto o pulsar cualquier otra tecla que no sea ninguno de los cursores hará que la selección actual sea sobreescrita.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-overwrite-selections"/>
<guibutton
>Sobreescribir selección</guibutton>
</term>
<listitem>
<para
>Si está activado, cualquier inserción de texto, ya sea tecleada o pegada hará que se elimine el texto seleccionado y éste sea reemplazado por el texto insertado.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-edit">
<title
>La página Editar</title>
<para
>Esta página contiene opciones variadas para el ajuste preciso del comportamiento del componente de edición de &kate;.</para>

<variablelist>
<title
>Opciones de edición</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-word-wrap"/>
<guibutton
>Ajuste de línea</guibutton>
</term>
<listitem>
<para
>Se utiliza para dar formato dinámicamente al texto al cortar la líneas en un lugar apropiado, en vez de símplemente colocar la líneas en el editor para facilitar la lectura.</para>
<para
>Si está activado, &kate; insertará un carácter de salto de línea tal y cómo se define en la opción <link linkend="document-end-of-line"
>Fin de línea</link
> del documento cuando la línea supera la longitud establecida en la opción <link linkend="config-dialog-editor-edit-wrap-words-at"
>Ajustar línea a</link
> que se describe a continuación.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-wrap-words-at"/>
<guibutton
>Ajustar línea a</guibutton>
</term>
<listitem>
<para
>Esta opción decide la longitud máxima de las líneas si la opción <link linkend="config-dialog-editor-edit-word-wrap"
>Ajuste de línea</link
> está activada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-replace-tabs-with-spaces"/>
<guibutton
>Reemplazar tabuladores con espacios</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; sustituirá los caracteres de tabulación por un número determinado de espacios en blanco, tal y como se define en <link linkend="config-dialog-editor-edit-tab-indent-width"
>Ancho de tabulador</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-remove-trailing-spaces"/>
<guibutton
>Eliminar los espacios al final</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; eliminará cualquier espacio en blanco al final de una línea cada vez que el cursor abandone esa línea.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-tab-indent-width"/>
<guibutton
>Ancho de sangrado/tabulador</guibutton>
</term>
<listitem>
<para
>Establece el ancho del tabulador, que además se utiliza también para decidir la cantidad de sangrado a aplicar cuando <link linkend="config-dialog-editor-indent-auto-indent"
>Auto sangrar</link
> está activado, o se invoca por otro motivo al sangrado.</para>
<para
>Establece el ancho del tabulador, que además se utiliza también para decidir la cantidad de sangrado a aplicar cuando el <link linkend="config-dialog-editor-indent-auto-indent"
>Sangrado automático</link
> está activado, o se invoca por otro motivo al sangrado.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-auto-brackets"/>
<guibutton
>Auto corchetes</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; insertará automáticamente un corchete derecho inmediatamente a la derecha del cursor cuando se inserte desde el teclado uno izquierdo. Los tipos de llaves, corchetes y paréntesis soportados son <keycap
>(</keycap
>, <keycap
>{</keycap
>, <keycap
>[</keycap
> y <keycap
>&lt;</keycap
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-group-undos"/>
<guibutton
>Deshacer por grupos</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; agrupará las operaciones de edición similares (por ejemplo teclear, borrar, pegar) en una única entrada en el historial de deshacer, para que todo pueda ser deshecho de una sola vez.</para>
</listitem>
</varlistentry>


<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-show-tabs"/>
<guibutton
>Mostrar tabuladores</guibutton>
</term>
<listitem>
<para
>Si está activado, &kate; dibujará una pequeño punto al inicio de un caracter <keycap
>Tabulador</keycap
> para indicar su presencia.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-smart-home"/>
<guibutton
>Inicio inteligente</guibutton>
</term>
<listitem>
<para
>Esto hará que &kate; mueva el cursor al primer caracter que no sea un espacio en blanco de la línea actual en vez de colocarse al principio absoluto, cuando se pulsa la tecla <keycap
>Inicio</keycap
> (u otra tecla asignada para tal función).</para>
</listitem>
</varlistentry>

<!-- NOTE This option has gone (anders)
<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-page-up-down-moves-cursor"/>
<guibutton
>Page Up/Down moves cursor</guibutton>
</term>
<listitem>
<para
>If enabled, the cursor will be moved to the first/last visible
line when <keycap
>Page Up</keycap
>/<keycap
>Page Down</keycap
> (or
other key assigned to those functions) is pressed, rather than being
kept at its relative position.</para>
</listitem>
</varlistentry>
-->
<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-wrap-cursor"/>
<guibutton
>Ajustar cursor</guibutton>
</term>
<listitem>
<para
>Si está activado, el mover el cursor más hallá del final de una línea, hará que este continúe en la línea siguiente/anterior si es que las hay.</para>
<para
>Si no está activado, el cursor no se puede mover más allá del comienzo de la línea, aunque sí puede moverse más allá del final de la línea, y cuando se inserta texto &kate; inserta automáticamente un espacio en blanco en esa posición. Esto es en ocasiones muy útil para los programadores, por ejemplo.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-keyboard">
<title
>La página Teclado</title>

<para
>Aquí puede configurar los accesos directos del teclado para las órdenes internas del componente de edición de &kate;. Esto incluye órdenes para moverse por el documento y seleccionar texto. Para las teclas relacionadas con el copiado y pegado de texto, vea el diálogo de configuración de las teclas. </para>

<para
>Puede cambiar las teclas correspondientes a una orden, o añadir una tecla alternativa.</para>

<procedure>
<title
>Para cambiar la(s) tecla(s) de una orden, siga este procedimiento:</title>
<step>
<para
>Seleccione la orden para el que desea configurar las teclas.</para>
</step>
<step>
<para
>Elija la opción <guibutton
>Ninguna</guibutton
> en el panel colocado debajo de la lista si no desea una tecla para esta orden.</para>
<para
>Elija la opción <guibutton
>Predeterminado</guibutton
> para utilizar la(s) tecla(s) predeterminada(s) para esa orden.</para>
<para
>Elija la opción <guibutton
>Personalizar</guibutton
> para seleccionar una tecla propia para esa orden, o para establecer una alternativa.</para>
</step>
<step>
<para
>Si elije la opción <guibutton
>Personalizar</guibutton
>, se activará el botón de introducción de teclas de la derecha del panel. Para establecer una tecla, basta con que pulse el botón. Aparecerá el diálogo de definición de accesos rápidos de &kde;. En este diálogo:</para>
</step>
<step>
<procedure>
<step>
<para
>Elija si desea establecer la opción predeterminada o una tecla alternativa. <guilabel
>Predeterminada</guilabel
> no significa que cambie la tecla predeterminada de la aplicación para esta acción, sino que se establece la tecla personalizada estándar para ello.</para>
</step>
<step>
<para
>Pulse la secuencia de teclas deseada, se podrá visualizar en el diálogo para su confirmación. </para>

<para
>Si su naturaleza es aventurera, pruebe a jugar con la opción <guibutton
>Tecla múltiple</guibutton
>. Su uso le permitirá tener secuencias de teclas similares a las de &Emacs; (una tecla entra en un grupo, la siguiente ejecuta la acción), además del hecho de que en vez de limitarse a hacer el trabajo, &kde; mostrará un menú para elegir en un lugar sin definir y probablemente inapropiado. Así no tendrá duda de si presionar la siguiente tecla de la secuencia funcionará o si tiene que utilizar el acelerador del menú (ambos funcionarán).</para>
</step>
</procedure>
</step>
</procedure>
</sect3>

<sect3 id="config-dialog-editor-filetypes">
<title
>La página de tipos de archivos</title>

<para
>Esta página le permitirá sobreescribir la configuración predeterminada para los documentos de los tipos mime especificados. Cuando el editor carga un documento, intentará encontrar la máscara o el tipo mime para uno de los tipos de archivos definidos, y de ser así se aplican las variables definidas. Si coinciden varios tipos de archivos, se utilizará el de mayor prioridad. Por favor véa la sección <link linkend="config-variables"
>Configurar con variables de documento</link
> para ver cómo especificar las variables.</para>

<para
>Para crear un tipo de archivo, pulse el botón <guibutton
>Nuevo</guibutton
> y rellene las propiedades.</para>

<para
>Para borrar un tipo de archivo existente, selecciónelo de la lista desplegable y pulse el botón <guibutton
>Eliminar</guibutton
>.</para>

<para
>Para editar un tipo de archivo, selecciónelo en la lista desplegable.</para>

<variablelist>

<title
>Propiedades del tipo de archivo</title>

<varlistentry>
<term
>Nombre</term>
<listitem
><para
>Este es el nombre que se mostrará en el menú <menuchoice
><guisubmenu
>Herramientas</guisubmenu
><guisubmenu
>Tipo de archivo</guisubmenu
></menuchoice
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Sección</term>
<listitem
><para
>Un submenú de <menuchoice
><guisubmenu
>Herramientas</guisubmenu
><guisubmenu
>Tipo de archivo</guisubmenu
></menuchoice
> en el que se ubicará este tipo de archivo. Si la sección no existe se creará.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Variables</term>
<listitem
><para
>Aquí se sitúa la configuración actual. Las variables que se asignen aquí sobreescribirán los valores de la configuración predeterminada. Por favor lea <link linkend="config-variables"
>Configurar con variables de documento</link
> para ver las variables disponibles.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Extensiones de archivos</term>
<listitem
><para
>Una lista de nombres de archivos globales separada por dos puntos utilizados para determinar si el documento coincide con este tipo de archivos.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Tipos MIME</term>
<listitem
><para
>Un lista de tipos mime separada por dos puntos utilizados para determinar si el documento coincide con este tipo de archivos.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Prioridad</term>
<listitem
><para
>Si un documento coincide con varios tipos de archivos, se elegirá aquel que tenga mayor prioridad.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-spelling">
<title
>La página Ortografía</title>
<para
>Esta página le permite configurar el comportamiento de &kspell; en &kate;.</para>
</sect3>

<sect3 id="config-dialog-editor-hl">
<title
>La página Resaltado</title>

<para
>Esta página le permitirá ajustar con precisión el color y la selección del tipo de sintaxis en &kate;.</para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="configdialog02.png"/></imageobject>
</mediaobject>
</para>
<para
>Para obtener más información sobre el sistema de resaltado de sintaxis, consulte ??</para>

<para
>La página consta de dos apartados, uno para definir los <guibutton
>Estilos predeterminados</guibutton
> y otro para administrar los <guibutton
>Modos de resaltado</guibutton
>. Ambos apartados muestran una lista de contextos en los que los colores y puentes predeterminados se utilizan para visionar el aspecto de cada estilo. El nombre del contexto se presenta utilizando las propiedades actuales de dicho contexto.</para>

<para
>La lista tiene cuatro o cinco columnas, cada una con el siguiente propósito:</para>

<variablelist>

<varlistentry>
<term
>Contexto</term>
<listitem
><para
>Muestra el nombre del contexto, se dibuja utilizando las propiedades de estilo del contexto.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Negrita</term>
<listitem
><para
>El estado de esta casilla decide si el contexto debe ser presentado utilizando un tipo de letra en negrita.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Cursiva</term>
<listitem
><para
>El estado de esta casilla decide si el contexto debe ser presentado utilizando un tipo de letra en cursiva.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Normal</term>
<listitem
><para
>Este botón muestra el color para dibujar el estilo en modo normal, cuando el texto no está seleccionado. Para cambiar el color, pinche en el botón.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Seleccionado</term>
<listitem
><para
>Este botón muestra el color para dibujar el texto cuando éste se encuentra seleccionado. Para cambiar el color, pinche en el botón.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Uso estilo predeterminado</term>
<listitem
><para
>Esta casilla, disponible únicamente en el apartado de <guibutton
>Modos resaltados</guibutton
> muestra si el estilo está utilizando sus valores predeterminados. Se desactivará automáticamente si cambiar alguna de las propiedades del estilo. Márquela para devolver el estilo a sus valores predeterminados.</para
></listitem>
</varlistentry>

</variablelist>

<sect4 id="config-dialog-editor-highlight-default-styles">
<title
>La pestaña Estilos predeterminados</title>
<para
>Para cambiar alguno de los estilos predeterminados, fijando sus propiedades tal y cómo desee.</para>
</sect4>

<sect4 id="config-dialog-editor-highlight-highlight-modes">
<title
>La pestaña Reglas de Resaltado</title>

<para
><indexterm
><primary
>configuración de la sintaxis de resaltado</primary
></indexterm
> Aquí puede cambiar las propiedades más importantes de cada modo de resaltado disponible. En primer lugar, utilice el desplegable <guibutton
>Resaltado</guibutton
> para elegir un modo sobre el que trabajar.</para
> <para
>Los modos de resaltado se eligen inicialmente en base al tipo &MIME; y la extensión del archivos. Para cambiar la lista de la selección actual, edite las entradas <guibutton
>Extensiones de archivos</guibutton
> y <guibutton
>Tipos MIME</guibutton
>. También puede pulsar el botón del asistente en la derecha de la entrada <guibutton
>Tipos MIME</guibutton
>. Esto mostrará un diálogo con todos los tipos &MIME; disponibles para poder elegir. Su uso modificará tanto los tipos &MIME; como las extensiones de archivo.</para>

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="mimetypechooser.png"/></imageobject>
</mediaobject>
<para
>El diálogo de selección de tipos &MIME; muestra un árbol de tipos &MIME; disponibles, con una descripción de los patrones del tipo &MIME;. Para incluir un tipo &MIME; pinche en el cuadro situado a su lado. </para>

<para
>Puede cambiar las propiedades de estilo de cualquiera de los contextos tal y como se ha descrito.</para>

<para
>En la parte inferior del apartado, debajo de las propiedades de resaltado, podrá ver un botón etiquetado <guibutton
>Descargar</guibutton
>. Si lo pulsa se tratará de establecer una conexión con la página web &kate; y descargar una lista de todos los modos de resaltado de sintaxis disponibles, para que pueda actualizarlos o añadirlos.</para>

</sect4>

</sect3>

</sect2>

<sect2 id="config-dialog-plugins">
<title
>El grupo Plugins</title>

<para
><indexterm
><primary
>configuración de las extensiones</primary
></indexterm
> Este grupo contiene páginas relacionadas con las extensiones. Además de la página de configuración del Administrador, algunas extensiones proporcionan opciones de configuración individuales. Si desea obtener información sobre éstas, consulte la documentación de las extensiones de forma individualizada.</para>

<sect3 id="config-dialog-plugins-manager">
<title
>La página del administrador de plugins</title>

<para
>Esta página proporciona los medios para cargar/descargar extensiones, y una información mínima sobre las extensiones individuales.</para>

<para
>Para cargar una extensión no cargada, selecciónela en el panel <guibutton
>Plugins disponibles</guibutton
> y utilice los botones de las flechas para moverlo al panel de <guibutton
>Plugins cargados</guibutton
>.</para>

<para
>Para descargar una extensión cargada, selecciónela en el panel <guibutton
>Plugins cargados</guibutton
> y utilice los botones de las flechas para moverlo al panel <guibutton
>Plugins disponibles</guibutton
>.</para>

<para
>Para ver una mínima descripción e información de una extensión, selecciónela y dicha información aparecerá debajo de las listas.</para>
</sect3>

</sect2>

</sect1>

<sect1 id="config-variables">

<title
>Configuración con variables de documentos</title>

<para
>Las variables de kate son una implementación de kateparts de las variables de documento, parecidas a las de emacs y vi. En katepart, las líneas tendrán el formato <userinput
>kate: VALOR NOMBREVARIABLE; [ VALOR NOMBREVARIABLE; ...]</userinput
> las líneas 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.</para>

<para
>Veámos un ejemplo de línea de variable, que fuerza la configuración del sangrado para un archivo C++, java o javascript: <programlisting
>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting>
</para>

<note
><para
>Sólo se buscarán variables en las primeras y últimas 10 líneas.</para
></note>

<para
>Existen variables que soportan la mayor parte de las configuraciones en katepart, además existen extensiones que utilizan variables, que deberían estar documentadas en la documentación de la extensión.</para>

<sect2 id="config-variables-howto">
<title
>Cómo utiliza kate las variables</title>

<para
>Cuando lee la configuración, katepart busca en los siguientes sitios (en este orden): <itemizedlist
> <listitem
><para
>La configuración global.</para
></listitem
> <listitem
><para
>Datos opcionales de la sesión.</para
></listitem
> <listitem
><para
>La configuración del "tipo de archivo".</para
></listitem
> <listitem
><para
>Variables de documento en el propio documento.</para
></listitem
> <listitem
><para
>Configuraciones cambiadas durante la edición desde el menú o desde la línea de órdenes.</para
></listitem
> </itemizedlist
> Como se puede imaginar las variables de documento tienen la máxima 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 línea de órdenes.</para>

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

<para
>Las variables que se listan aquí documentan la versión 2.4 de &kate;. 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: <itemizedlist>
<listitem
><para
>BOOL - on|off|true|false|1|0.</para
></listitem>
<listitem
><para
>INTEGER - cualquier número entero.</para
></listitem>
<listitem
><para
>STRING - todo lo demás.</para
></listitem>
</itemizedlist>
</para>

<variablelist>
<title
>Variables disponibles</title>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-brackets</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la inserción de paréntesis.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-center-lines</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el número de líneas de autocentrado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-insert-doxygen</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la inserción de asteriscos principales en los comentarios doxygen. Esto no tendrá efecto a menos que se utilice el sangrado automático cstyle. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>background-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el color del fondo del documento. El valor debe ser algo que pueda ser evaluado como un color válido, por ejemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>backspace-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el sangrado con retroceso.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>block-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la selección de bloques.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>bracket-highlight-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el color del resaltado de paréntesis. El valor debe ser algo que pueda ser evaluado como un color válido, por ejemplo "#ff0000". </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>current-line-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el color para la línea actual. El valor debe ser algo que pueda ser evaluado como un color válido, por ejemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>dynamic-word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el ajuste automático de línea.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>eol | end-of-line</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el final del modo de línea. Los valores válidos son <quote
>unix</quote
>, <quote
>mac</quote
> y <quote
>dos</quote
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>encoding</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura la codificación del documento. El valor debe ser un nombre válido de codificación, similar a <quote
>utf-8</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font-size</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el tamaño del punto del tipo de letra del documento.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el tipo de letra del documento. El valor debería ser un nombre válido de tipo de letra, por ejemplo <quote
>courier</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-bar-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el color de la barra de iconos. El valor debe ser algo que pueda ser evaluado como un color válido, por ejemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-border</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la visualización del borde de iconos.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>folding-markers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la visualización de las marcas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-mode</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el modo de sangrado automático. Las opciones reconocidas son <quote
>none</quote
>, <quote
>normal</quote
>, <quote
>cstyle</quote
>, <quote
>csands</quote
>, <quote
>python</quote
>, <quote
>xml</quote
>. Véa la sección <link linkend="kate-part-autoindent"
>Utilizar sangrado automático</link
> para obtener más detalles.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el ancho del sangrado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-extra-spaces</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Indica cuando se utilizarán espacios extras para calcular el ancho de sangrado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-indent-profile</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Si está activado, evita que no sea sangrado el bloque completo si hay al menos una línea que tiene sangrado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>line-numbers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la visualización de los números de línea.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>mixed-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el modo de sangrado al estilo mixto Emacs.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>overwrite-mode</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el modo de sobreescritura.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>persistent-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva las selecciones persistentes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>remove-trailing-space</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la limpieza del final de línea dinámico.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la conversión tabulador-&gt;espacio durante el guardado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la conversión dinámica tabulador-&gt;espacio.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-trailing-space-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la limpieza del final de línea durante el guardado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>scheme</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>selection-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura la selección de color. El valor debe ser algo que pueda ser evaluado como un color válido, por ejemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>show-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la visualización del caracter TAB.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>smart-home</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva la navegación inteligente.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>space-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el sangrado con espacios.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el sangrado con la tecla TAB.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el ancho de tabulador que se va a mostrar.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>undo-steps</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el número de pasos para deshacer que puede recordar.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-column</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el ancho del ajuste de línea.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-marker-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Configura el color del ajuste de línea. El valor debe ser algo que pueda ser evaluado como un color válido, por ejemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el ajuste de línea.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>wrap-cursor</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa o desactiva el margen del cursor.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>
