# 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 lanzador de aplicaciones o desde la línea de órdenes.

### Desde el menú

Abra el menú de programas de &kde; pulsando sobre el icono del lanzador de aplicaciones situado en la barra de herramientas, en la parte inferior izquierda de su pantalla. Al hacerlo, aparecerá el un menú. 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 &kde-ftp;README

Para cambiar el directorio de los archivos temporales, que por omisión es `/tmp`, ajuste la variable de entorno `TMPDIR` antes de iniciar &kate;. Por ejemplo:

    %mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

#### 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 disponibles en la línea de órdenes.

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

- Inicia &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.

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

- Solo reutiliza una instancia con el PID específico (ID del proceso).

``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 abre un archivo remoto (que se haya descargado a un archivo temporal) y tiene que recargarse después de que lo guarde.

``kate` `--tempfile``

- 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` `--desktopfile` `nombre de archivo``

- Nombre de archivo base para la entrada del escritorio para esta aplicación.

  Esto resulta particularmente útil para aplicaciones de envoltorio y para aplicaciones que tienen varios archivos de escritorio en general. De este modo, cada archivo de escritorio puede tener su propia línea de órdenes para la entrada `Exec`.

``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 &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;. Atajos de teclado muestra algunos de los atajos de 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 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 todas las ventanas de los paneles laterales con la opción del menú Ver Vistas de herramientas o con el atajo de teclado &Ctrl;&Alt;&Shift;F. Este menú le ofrece una primera idea de la potencia y flexibilidad de &kate;.

En Vistas de herramienta tiene una lista de todos los complementos activos. Marque la casilla de verificación situada junto a cada uno de los elementos o haga clic con el &LMB; en los botones de herramienta del panel lateral para mostrar u ocultar la vista de herramienta.

### Atajos de teclado

Muchas de las órdenes de combinaciones de teclas (atajos de teclado) de &kate; son configurables a través del menú Preferencias. De forma predeterminada, &kate; admite las siguientes asociaciones de teclas.

F1 | Ayuda
&Shift; F1 | ¿Qué es esto?
&Ctrl;N | Nuevo documento
&Ctrl;L | Guardar todo
&Ctrl;O | Abrir un documento
&Ctrl;&Alt;O | Apertura rápida
&Ctrl;&Shift;F | Modo de pantalla completa
&Ctrl;&Shift;, | Configurar &kate;
&Ctrl;W / &Ctrl;&Esc; | Cerrar
&Ctrl;Q | Salir - cerrar la copia activa del editor
&Ctrl;&Alt;&Shift;F | Mostrar barras laterales
&Ctrl;&Shift;T | Dividir horizontalmente
&Ctrl;&Shift;L | Dividir verticalmente
F8 | Siguiente vista dividida
&Shift;F8 / &Ctrl;&Esc; | Anterior vista dividida
&Ctrl;&Shift;R | Cerrar la vista actual
&Alt;&Right; | Siguiente pestaña
&Alt;&Left; | Anterior pestaña
&Ctrl;&Shift;T | Volver a abrir los últimos documentos cerrados

De forma adicional, puede usar los atajos de teclado proporcionados por el componente &katepart; y por todos los complementos de &kate; activados.

## 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 de cualquier complemento activo en el diálogo de preferencias.

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.

Si un complemento tiene opciones de configuración, puede usar el primer elemento del menú de contexto para abrir la página correspondiente den el diálogo de preferencias de &kate;.

### 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.

## 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 use `--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.

## Apertura rápida

Kate contiene un diálogo de apertura rápida que permite abrir de forma inmediata archivos o cambiar rápidamente entre ellos. Puede acceder a este diálogo con &Ctrl;&Alt;O.

La apertura rápida puede mostrar todos los documentos abiertos en Kate además de todos los archivos de los proyectos abiertos. Para poder ver archivos de proyectos, debe activar el Complemento de proyectos.

### Uso de la apertura rápida

El uso de la apertura rápida es muy sencillo. Tras abrirla, escriba el nombre o partes de nombre del archivo que quiera abrir para que la apertura rápida filtre la lista según lo que haya escrito. Si pulsa &Enter; se abrirá el archivo seleccionado. Si pulsa &Esc; se ocultará la apertura rápida.

De forma predeterminada, solo se buscan coincidencias del nombre del archivo durante el filtrado. Si quiere tener en cuenta la ruta tendrá que añadir «/» al texto que escriba. Por ejemplo: «doc/index» coincidirá con todos los archivos que contengan «index» dentro de la carpeta «doc».

Los documentos que ya están abiertos se resaltan en negrita y se muestran en la parte superior de la lista cuando se abre el diálogo. Además, cuando aparece la apertura rápida, el documento abierto anterior ya estará seleccionado, por lo que puede pulsar &Enter; para ir a dicho documento.

### Configuración de la apertura rápida

Apertura rápida

La apertura rápida proporciona varias opciones de configuración. Para acceder a ellas, haga clic derecho en la línea de edición.

Las opciones disponibles en la actualidad son:

- `Proyecto actual`: Muestra solo los archivos del proyecto actual.

  `Todos los proyectos`: Muestra los archivos de todos los proyectos abiertos.

  `Filtrado difuso`: Usar el algoritmo de coincidencia difusa para filtrar los archivos.

  `Filtrado mediante comodines`: Usar la coincidencia de comodines para filtrar los archivos.

## 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.