# Los fundamentos

Si alguna vez ha utilizado un editor de texto, no tendrá problema al utilizar &kate;. En las dos siguientes secciones, Iniciar &kate; y Trabajar con &kate;, le mostraremos todo lo que necesita para iniciarse y trabajar rápidamente.

## Iniciar &kate;

Puede iniciar &kate; desde el &kmenu; o desde la línea de órdenes.

### Desde el menú

Abra el menú de programas de &kde; pulsando sobre el icono de la gran K de la barra de herramientas de la parte inferior izquierda de su pantalla. Al hacerlo, surgirá el menú de programas. Mueva el cursor hasta la opción de menú Aplicaciones Utilidades Editor de texto avanzado &kate;.

### Desde la línea de órdenes

Puede iniciar &kate; introduciendo su nombre en la línea de órdenes. Si, además, introduce un nombre de archivo, como en el ejemplo de más abajo, abrirá o creará dicho archivo.

    %kate miarchivo.txt

Si dispone de una conexión activa, y permiso, puede beneficiarse de la transparencia de red de &kde; para abrir archivos en Internet.

    %kate ftp://ftp.kde.org/pub/kde/README

#### Opciones de la línea de órdenes

&kate; acepta las siguientes opciones de la línea de órdenes:

``kate` `--help``

- Muestra una lista de las opciones básicas disponibles en la línea de órdenes.

``kate` `--help-qt``

- Muestra las opciones disponibles para modificar el modo en el que &kate; interactúa con &Qt;.

``kate` `--help-kde``

- Muestra las opciones disponibles para modificar el modo en el que &kate; interactúa con &kde;.

``kate` `-s` `--start` `nombre``

- Inicie kate con el `nombre` de sesión. Si la sesión no existe, se creará. Si ya existía una instancia de &kate; ejecutándose, se cargarán los archivos correspondientes en esa instancia. Cuando se utiliza la opción `--use`, también se utilizará una sesión en esta instancia.

``kate` `-u` `--use` `URL``

- Hace que &kate; utilice la instancia actual si hay alguna. En la actualidad, este es el comportamiento predeterminado, pero esta opción permanece por motivos de compatibilidad.

``kate` `-p` `--pid` `PID``

- Solo reutiliza una instancia con el PID específico (ID del proceso). Se utiliza con la opción `--use`.

``kate` `-e` `--encoding` `codificación` `URL``

- Utiliza la codificación especificada para el documento.

``kate` `-l` `--line` `línea` `URL``

- Se desplaza a la línea especificada después de abrir el documento.

``kate` `-c` `--column` `columna` `URL``

- Se desplaza a la columna especificada después de abrir el documento.

``kate` `-i` `--stdin``

- Lee el contenido del documento desde STDIN. Es similar a la opción `-` utilizada en muchos programas de línea de órdenes, y le permite redirigir la salida de las órdenes a &kate;.

``kate` `--startanon``

- Inicia &kate; con una nueva sesión anónima, implicando `-n`.

``kate` `-n` `--new``

- Fuerza el inicio de una nueva instancia de &kate; (se ignorará si usa `start` y otra instancia de &kate; ya tiene una sesión abierta), forzada si no se proporciona ningún parámetro ni URL.

``kate` `-b` `--block``

- Si se está usando una instancia de &kate; que ya está en ejecución y se indica una URL a la que dirigirse, se bloquea hasta que finalice dicha instancia.

  Puede utilizar &kate; con esta opción como editor para teclear mensajes de aplicación de cambios en sistemas de control de versiones como Git o Subversion. Dichos sistemas esperan bloquear el editor hasta que se haya introducido el mensaje porque es entonces cuando abren el archivo temporal, el cual estaría vacío si Kate volviese inmediatamente al llamante.

  Esta opción también es necesaria con KIO (&kde; entrada/salida) si usted abre un archivo remoto (que se haya descargado a un archivo temporal) y tiene que recargarse después de que lo guarde.

``kate` `--tempfile``

- Esta opción estándar de &kde; está implementada desde &kate; 2.5.1. Cuando se utiliza, los archivos especificados se tratan como archivos temporales y se borran (si son archivos locales y se tiene los permisos suficientes) cuando se cierran, a menos que se modifiquen después de abrirse.

``kate` `--help-all``

- Muestra todas las opciones de la línea de órdenes.

``kate` `--author``

- Muestra una lista de los autores de &kate; en la ventana del terminal.

``kate` `-v` `--version``

- Lista la información de la versión para &Qt;, &kde;, y &kate;.

``kate` `--license``

- Muestra información de la licencia.

### 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 desde algún sitio ftp remoto abierto en una ventana de &dolphin;.

## Trabajar con &kate;

El Inicio rápido le mostrará como conmutar cuatro opciones sencillas que le permiten configurar de manera inmediata algunas de las características más potentes de &kate;. Accesos rápidos muestra algunos de los accesos rápidos del teclado predeterminados para aquellos que no pueden o no quieren utilizar el ratón.

### Inicio rápido

Esta sección describirá algunos elementos del menú Ver para que usted pueda configurar rápidamente &kate; como desee.

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 un panel lateral que combina las ventanas Documentos y Navegador de archivos. Cambie de una a otra pulsando las pestañas 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 el panel lateral, el nombre del archivo. Utilice la ventana Navegador de archivos para abrir archivos.

Puede conmutar las ventanas «Documentos» y «Navegador de archivos» desde el menú Ver Vistas de herramientas. Este menú le ofrece una primera idea de la potencia y flexibilidad de &kate;. En esta sección nos detendremos en tres elementos:

Ocultar documentos

- Conmuta el panel de Documentos de manera que esté visible o no.

### Accesos rápidos

Muchas de las órdenes de combinaciones de teclas (accesos rápidos) de &kate; son configurables a través del menú Configuración. De forma predeterminada, &kate; admite las siguientes asociaciones de teclas.

Insertar | Conmuta entre el modo inserción y el modo sobrescritura. Cuando está en modo inserción el editor añadirá cualquier carácter introducido al texto y empujará los caracteres previamente introducidos a la derecha del cursor de texto. El modo de sobrescritura hace que la entrada de cada carácter elimine el carácter inmediatamente a la derecha del cursor de texto.
Flecha izquierda | Mueve el cursor un carácter a la izquierda
Flecha derecha | Mueve el cursor un carácter a la derecha
Flecha arriba | Mueve el cursor una línea arriba
Flecha abajo | Mueve el cursor una línea abajo
Página arriba | Mueve el cursor una página hacia arriba
Página abajo | Mueve el cursor una página hacia abajo
&Backspace; | Borra el carácter a la izquierda del cursor
Inicio | Mueve el cursor al comienzo de la línea
Fin | Mueve el cursor al final de la línea
Borrar | Borra el carácter a la derecha del cursor (o cualquier texto seleccionado)
&Shift;&Enter; | Inserta un fin de línea con los caracteres de la línea que no son letras y números delante. Esto es útil, por ejemplo, para escribir comentarios en el código: al final de la línea // un texto pulse este acceso rápido y la siguiente ya empezará con //. Así, no necesitará introducir los caracteres de comentario al inicio de cada nueva línea para comentarios.
&Shift; flecha izquierda | Marca el texto un carácter a la izquierda
&Shift; flecha derecha | Marca el texto un carácter a la derecha
F1 | Ayuda
&Shift; F1 | ¿Qué es esto?
&Ctrl; F | Buscar
F3 | Repetir la búsqueda
&Ctrl;B | Insertar un marcador
&Ctrl;C | Copiar el texto marcado al portapapeles
&Ctrl;N | Nuevo documento
&Ctrl;P | Imprimir
&Ctrl;Q | Salir - cerrar la copia activa del editor
&Ctrl;R | Remplazar
&Ctrl;S | Guardar su archivo
&Ctrl;V | Pegar
&Ctrl;X | Borrar el texto marcado y copiarlo al portapapeles
&Ctrl;Z | Deshacer
&Ctrl;&Shift;Z | Rehacer

## Trabajar con &kate; MDI

### Introducción

Ventana, Vista, Documento, Marco, Editor... ¿Qué significan en la terminología de &kate;, y como extraer de ellos el máximo rendimiento? Este capítulo explicará todo esto y alguna cosa más.

#### La ventana principal

La ventana principal de &kate; es una ventana de programa estándar de &kde;, con el añadido de paneles laterales que contienen vistas de herramientas. Tiene una barra de menús con todos los menús comunes y alguno más, y una barra de herramientas que proporciona acceso a las órdenes más usadas.

La parte más importante de la ventana es el área de edición, que de forma predeterminada muestra un único componente de edición, en el que puede trabajar con sus documentos.

Las posibilidades de anclaje de las ventanas se utilizan con las ventanas de herramientas:

- Lista de documentos

- Navegador del sistema de archivos

- Emulador de terminal integrado

Y posiblemente cualquier otra ventana de herramientas, como las que, por ejemplo, proporcionan los complementos.

Las ventanas de herramientas se puede situar en cualquier panel lateral, para mover una herramienta haga clic sobre ella con el &RMB; y selecciónela en el menú de contexto.

Una vista de herramientas puede marcarse como persistente en el menú del &RMB; de este botón de la barra lateral. El panel lateral puede contener más herramientas al mismo tiempo, de forma que cuando una herramienta sea persistente se podrán mostrar otras herramientas de manera simultánea.

### El área del editor

&kate; es capaz de tener más de un documento abierto al mismo tiempo y también es capaz de dividir el área de edición 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 definiciones al principio a las que se refiere habitualmente a lo largo del texto. O puede ver la cabecera del código fuente de un programa en un marco, mientras edita el archivo de implementación en otro.

Cuando un documento está disponible en más de un editor, los cambios hechos en uno de ellos serán reflejados en los otros inmediatamente. Esto incluye el cambio de texto, así como su selección. Las operaciones de búsqueda o de movimiento del cursor, solo tienen lugar en el editor actual.

En este momento no es posible tener abiertas varias sesiones de un mismo documento con la intención de que los cambios que se produzcan en una no afecten a las demás.

Al dividir un editor en dos marcos, ambos son del mismo tamaño y muestran el documento que está siendo editado en ese momento. El nuevo marco estará la parte inferior (en el caso de una división horizontal) o en la parte derecha (si la división es vertical). El nuevo marco estará activo, lo que se representa visualmente por un pequeño indicador verde en dicho marco.

### La lista de documentos

La lista de archivos muestra una lista de todos los documentos abiertos en &kate;. Los archivos modificados tendrán un pequeño icono de un disquete a su izquierda, para indicar su estado.

De manera predeterminada, la lista de documentos aparece en el Modo de árbol, el cual muestra la estructura de carpetas que rodea a todos los documentos actualmente abiertos. También está disponible el Modo de lista, que muestra una lista sencilla de todos los documentos abiertos. Puede cambiar de modo haciendo clic con el botón derecho sobre la lista y seleccionándolo en el menú Modo de visualización.

Si hay dos o más archivos con el mismo nombre abiertos (que pertenezcan a carpetas diferentes) en el Modo lista, al nombre del segundo se le antepondrá un «(2)» y así sucesivamente. La ventana de información de archivo mostrará su nombre completo, incluyendo la ruta, permitiendo así que se pueda elegir el archivo deseado.

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 botón 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 alfabético según su nombre.

Ruta del documento

- Muestra los documentos por orden alfabético según su ruta.

La lista de documentos mostrará de forma predeterminada su historial, sombreando las entradas de los documentos más recientes con un color de fondo. Si el documento se ha editado, se utilizará una combinación de colores. Los documentos más recientes tendrán colores más intensos, de forma que pueda encontrar más fácilmente los documentos con los que está trabajando. Esta característica se puede desactivar en la página Documentosdel diálogo de configuración.

La posición predeterminada de la lista de documentos en la ventana de &kate; es a la izquierda del área de edición.

## Utilizar sesiones

Las sesiones es la forma en que &kate; le permitirá mantener más de una lista de archivos y configuraciones de la interfaz gráfica de usuario. Puede tener tantas sesiones como desee y puede utilizar sesiones con nombre o anónimas para los archivos que solo desee utilizar una vez. En estos momentos, &kate; puede guardar la lista de archivos abiertos y la configuración de la ventana general en la sesión. En futuras sesiones de &kate;, se añadirán más características que se guardarán en las sesiones. Con la introducción de sesiones, &kate; también le permite abrir cualquier número de instancias de la aplicación en lugar de solo una tal y como aparece en el comportamiento predeterminado.

Las sesiones se implementan en tres áreas:

- Opciones de línea de órdenes que le permitirá seleccionar e iniciar sesiones cuando inicia kate desde la línea de órdenes.

- El menú sesiones que le permite cambiar, guardar, iniciar y administrar sus sesiones

- Opciones de configuración que le permite decidir cuántas sesiones se deberían utilizar.

Cuando se inicia una nueva sesión, se carga configuración de la interfaz gráfica de usuario de la Sesión predeterminada. Para guardar la configuración de la ventana en la sesión predeterminada, necesitará activar la funcionalidad de guardar la configuración de la ventana en la página de configuración de sesiones del diálogo de configuración y cargar la sesión predeterminada, pudiendo configurar la ventana nuevamente de acuerdo con sus gustos y guardando nuevamente la sesión.

Cuando se cargue una sesión con nombre, &kate; mostrará el nombre de la sesión al inicio del título de la ventana, que tendrá la estructura «`Nombre de la sesión`: `Nombre del documento o &URL;` - &kate;»

Cuando se abren archivos desde la línea de órdenes con la opción `--start `nombre`` o si se ha seleccionado una sesión con el selector de sesiones, se cargará la sesión antes que los archivos especificados en la línea de órdenes. Para abrir archivos desde la línea de órdenes en una nueva sesión sin nombre, configure kate para iniciar una nueva sesión predeterminada en la página de sesión del diálogo de configuración o utilice `--start` con una cadena vacía `''`.

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 integrado, Kate seleccionará automáticamente la instancia actual si no se indica otra cosa en la línea de órdenes.

### Restaurar el comportamiento de &kate; del estilo antiguo

Esperamos que cuando se acostumbre al uso de sesiones, se dé cuenta de que proporcionan una herramienta sencilla y eficiente para trabajar en diferentes áreas. Sin embargo, si prefiere el antiguo comportamiento de &kate; (una instancia para abrir todos los archivos), puede utilizar esta sencilla estrategia:

- Haga que kate se inicie siempre con el parámetro `--use` añadiéndolo a la orden en las preferencias de la aplicación, o utilizando un alias de la shell.

- Configure &kate; para cargar la última sesión utilizada al inicio.

- Configurar &kate; para guardar la lista de archivo cuando cierre una sesión.

- Cargar la sesión predeterminada una vez.

## Obteniendo ayuda

### En &kate;

Este manual

- Ofrece documentación detallada sobre todas las órdenes de menú, opciones de configuración, herramientas, diálogos, complementos, &etc;., así como descripciones de la ventana de &kate;, del editor y de varios conceptos utilizados en la aplicación.

  PulseF1 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 gráficas, 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 través del diálogo de configuración, así como de muchos otros diálogos.

  Para emplear la ayuda «¿Qué es esto?», pulse &Shift; F1 o utilice la opción de menú Ayuda¿Qué es esto? para activar el modo «¿Qué es esto?». El cursor se transformará en una flecha con una interrogación, 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 diálogos

- Algunos diálogos tienen un botón Ayuda. Pulsándolo se iniciará &khelpcenter; y se abrirá la documentación correspondiente.

### Con sus archivos de texto

&kate; no proporciona (¡todavía!) una forma de leer la documentación asociada a un documento. Dependiendo del archivo que esté editando, puede que encuentre útil el emulador de terminal integrado para ver páginas del manual de &UNIX; o documentación relacionada (info) o puede utilizar &konqueror;.

### Artículos de &kate;

La página principal de &kate; proporciona algunos Artículos y guías con informaciones que quedan fuera del ámbito de aplicación de este manual.