<chapter id="fundamentals">
<title
>Los fundamentos</title>

<para
> Si alguna vez ha utilizado un editor de texto, no tendrá problema al utilizar &kate;. En las siguientes dos secciones, <link linkend="starting-kate"
>Iniciando &kate; </link
> y en <link linkend="working-with-kate"
>Trabajando con &kate;</link
>, le mostraremos todos lo que necesita para iniciarse y trabajar rápidamente. </para>

<sect1 id="starting-kate">
<title
>Iniciando &kate;</title>

<para
> Puede iniciar &kate; desde el <guimenu
>menú K</guimenu
> o desde la línea de comandos. </para>

<sect2 id="starting-from-the-menu">
<title
>Desde el menú</title>
<para
> Abra el menú de programas de &kde; pulsando sobre el icóno de la <guiicon
>K mayúscula</guiicon
> sobre la barra de herramientas en la parte inferior izquierda de su pantalla. Al hacerlo aparecerá el <guimenu
>menú de programas</guimenu
>. Mueva el cursor por el menú hasta el elemento <guimenu
>Editores</guimenu
>. Aparecerá una lista de los editores disponibles. Seleccione <guimenuitem
>&kate;</guimenuitem
>. </para>

<para
> A no ser que configure &kate; en sentido contrario, se cargarán los últimos archivos que usted editó. Consulte <link linkend="configure"
>Configurando &kate;</link
> para saber como activar/desactivar esta característica. </para>

</sect2>

<sect2 id="starting-from-the-command-line">
<title
>Desde la línea de comandos</title>

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

<informalexample
> <screen>
<prompt
>%</prompt
><userinput
><command
>kate</command
> <option
><replaceable
>miarchivo.txt</replaceable
></option
></userinput>
</screen
> </informalexample>

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

<informalexample
> <screen>
<prompt
>%</prompt
><userinput
><command
>kate</command
> <option
><replaceable
>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable
></option
></userinput>
</screen
> </informalexample>

<sect3 id="command-line-options">
<title
>Opciones de la línea de comandos</title>
<para
>&kate; acepta las siguientes opciones de la línea de comandos:</para>

<variablelist
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help</option
></userinput
></term
> <listitem
> <para
> Muestra una lista de las opciones básicas disponibles en la línea de comandos. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help-qt</option
></userinput
></term
> <listitem
> <para
> Muestra las opciones disponibles para modificar el modo en el que &kate; interactua con &Qt;. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help-kde</option
></userinput
></term
> <listitem
> <para
> Muestra las opciones disponibles para modificar el modo en el que &kate; interactua con &kde;. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help-all</option
></userinput
></term
> <listitem
> <para
> Muestra todas las opciones de la línea de comandos. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--author</option
></userinput
></term
> <listitem
> <para
> Muestra una lista de los autores de &kate; en la ventana del terminal. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--version</option
></userinput
></term
> <listitem
> <para
> Muestra información de las versiones de &Qt;, &kde;, y &kate;. También disponible introduciendo <userinput
><command
>kate</command
> <option
>-V</option
></userinput
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--license</option
></userinput
></term
> <listitem
> <para
> Muestra información de la licencia. </para
> </listitem
> </varlistentry
> </variablelist>
</sect3>
</sect2>

<sect2 id="drag-and-drop">
<title
>Arrastrar y soltar</title>
<para
> &kate; utiliza el protocolo de &kde; para arrastrar y soltar. Los archivos pueden arrastrarse y soltarse en &kate; desde el escritorio, &konqueror; o algún servidor remoto ftp abierto con una de las ventanas de &konqueror;. </para>
</sect2>
</sect1>

<sect1 id="working-with-kate">
<title
>Trabajando con &kate;</title>
<para
> <link linkend="quick-start"
>Inicio rápido</link
> le mostrará como (des)activar cuatro opciones sencillas que le permiten configurar algunas de las propiedades más potentes de &kate;. <link linkend="keystroke-commands"
> Comandos en teclas</link
> muestra algunos de los accesos rápidos del teclado predterminados para quellos que no pueden o no quieren utilizar el ratón. </para>

<sect2 id="quick-start">
<title
>Inicio rápido</title>

<para
> Esta sección describirá algunos de los elementos en el menú de <guimenu
>Configuración</guimenu
> de modo que usted puede configurar rápidamente &kate; para que trabaje como usted desea. </para>

<para
> 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 normalmente. Y por encima de ella, una barra de menú. </para>

<para
> La ventana a la izquierda es una barra lateral empotrable. Combina una lista de archivos y un selector de archivos. Cambie de una a otra pulsando sobre las pestañas en la parte superior de la ficha. </para>

<para
> Si ha iniciado &kate; con un archivo, la ventana de la derecha le mostrará el archivo que está editando y la lista de archivos en la barra lateral le mostrará el nombre del archivo. Utilice la ventana selectora de archivos para abrir los archivos. </para>

<para
> Puede activar o desactivar las ventanas Lista de archivos y Selector de archivos desde el menú <guimenu
>Configuración</guimenu
>. Este menú le ofrece su primera visión de la potencia y flexibilidad de &kate;. En esta sección nos detendremos en cuatro elementos: </para>

<variablelist
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Mostrar Barra de herramientas</guimenuitem
></menuchoice
></term
> <listitem
> <para
> Activa/Desactiva la barra de herramientas. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenuitem
>Mostrar lista de archivos</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Activa/Desactiva la lista de archivos. Si la ventana de Lista de archivos/Selector de archivos no está abierta, &kate; lanza la barra lateral como una ventana separada e independiente. Para anclarla agarre las dos líneas paralelas finas por encima de las pestañas pulsando sobre ellas con el botón izquierdo del ratón, y mantengalo pulsado. Arrastre la ventana dentro de la ventana de edición de &kate; y suelte el botón izquierdo del ratón cuando hay posicionado la ventana Lista de archivos/Selector de archivos en el lugar que desea. </para
> <tip
> <para
> Si ha agarrado las dos líneas paralelas de modo correcto el puntero de su ratón mudará a unas flechas cruzadas mientras arrastre la ventana. </para
> </tip
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Mostrar selector de archivos</guimenuitem
></menuchoice
></term
> <listitem
> <para
> Activa/Desactiva el selector de archivos. Este elemento es el mismo que <guimenuitem
>Mostrar lista de archivos</guimenuitem
> con una diferencia. Al activarlo lanza una ventana con el selector de archivos en la parte superior. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Mostrar consola</guimenuitem
></menuchoice
></term
> <listitem
> <para
> Activa/Desactiva un emulador de consola en la parte inferior de la ventana de &kate;. En otras palabras, le ofrece una entrada de línea de comandos dentro de la aplicación. </para
> </listitem
> </varlistentry
> </variablelist>
</sect2>

<sect2 id="keystroke-commands">
<title
>Comandos en teclas</title>

<para
> Muchos de los comandos en tecla (accesos rápidos) de &kate; son configurables a través del menú <link linkend="settings"
>Configuración</link
>. Por omisión &kate; soporta las siguientes asociaciones de teclas. </para>

<informaltable>
<tgroup cols="2">
<tbody
> <row
><entry
><para
><keycap
>Insertar</keycap
></para
></entry
> <entry
><para
> Pasa de modo inserción a modo sobreescritura. Cuando está en modo inserción el editor añadirá cualquier caracter introducido al texto y empujará los caracteres previamente introducidos a la derecha del cursor de texto. El modo de sobreescritura hace que la entrada de cada caracter elimine el caracter inmediatamente a la derecha del cursor de texto.</para
></entry
> </row
> <row
> <entry
><para
><keycombo
><keycap
>Flecha izquierda</keycap
></keycombo
></para
></entry
> <entry
><para
>Mueve el cursor un caracter a la izquierda </para
></entry
> </row
> <row
> <entry
><para
><keycombo
><keycap
>Flecha derecha</keycap
></keycombo
></para
></entry
> <entry
><para
> Mueve el cursor un caracter a la derecha </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Flecha arriba</keycap
></keycombo
></para
></entry
> <entry
><para
> Mueve el cursor una línea arriba </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Flecha abajo</keycap
></keycombo
></para
></entry
> <entry
><para
> Mueve el cursor una línea abajo </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Página arriba</keycap
></keycombo
></para
></entry
> <entry
><para
> Mueve el cursor una página hacia arriba </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Página abajo</keycap
></keycombo
></para
></entry
> <entry
><para
>Mueve el cursor una página hacia abajo </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Retroceder</keycap
></keycombo
></para
></entry
> <entry
><para
> Borra el caracter a la izquierda del cursor </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Inicio</keycap
></keycombo
></para
></entry
> <entry
><para
> Mueve el cursor al comienzo de la línea </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Fin</keycap
></keycombo
></para
></entry
> <entry
><para
> Mueve el cursor al final de la línea </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Suprimir</keycap
></keycombo
></para
></entry
> <entry
><para
>Borra el caracter a la derecha del cursor (o cualquier texto seleccionado)</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Shift; <keycap
>flecha izquierda</keycap
></keycombo
></para
></entry
> <entry
><para
> Marca el texto un caracter a la izquierda </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Shift; <keycap
>flecha derecha</keycap
></keycombo
></para
></entry
> <entry
><para
> Marca el texto un caracter a la derecha </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>F1</keycap
></keycombo
></para
></entry
> <entry
><para
> Ayuda</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Shift; <keycap
>F1</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="whats-this"
>¿Qué es esto?</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl; <keycap
>F</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="find"
> Buscar</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>F3</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="find-again"
> Repetir la búsqueda</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
></para
></entry
> <entry
><para
>Insertar un marcador</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
></para
></entry
> <entry
><para
> Copiar el texto marcado al portapapeles </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></para
></entry
> <entry
><para
> <link linkend="new"
>Nuevo</link
> documento</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="print"
>Imprimir</link
> </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></para
></entry
> <entry
><para
>Salir - cerrar la copia activa del editor </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="replace"
> Reemplazar</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
></para
></entry
> <entry
><para
>Guardar su archivo.</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>V</keycap
></keycombo
></para
></entry
> <entry
><para
> Pegar.</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>X</keycap
></keycombo
></para
></entry
> <entry
><para
>Borrar el texto marcado y copiarlo al portapapeles. </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="undo"
>Deshacer</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="redo"
>Rehacer</link
></para
></entry
> </row
> </tbody>
</tgroup>
</informaltable>
</sect2>

</sect1>

<sect1 id="fundamentals-getting-help">

<title
>Obteniendo ayuda</title>

<sect2>

<title
>Trabajando con &kate;</title>
<variablelist
> <varlistentry
> <term
>Este manual</term
> <listitem
> <para
>Ofrece documentación detallada sobre todos los comandos de menú, opciones de configuración, herramienta, diálogos, plugins &etc; así como descripciones de la ventana de &kate;, el editor y varios conceptos utilizados en la aplicación.</para
> <para
>Pulse <keycap
>F1</keycap
> o utilice la <menuchoice
><guimenu
>Ayuda</guimenu
></menuchoice
> menú <guisubmenu
>Contenidos</guisubmenu
> para ver este manual.</para
></listitem
> </varlistentry
> <varlistentry id="whats-this"
> <term
>¿Qué es esto?</term
> <listitem
> <para
>¿Qué es esto? ofrece ayuda inmediata sobre elementos asilados de las ventanas gráficas, tales como botones u otras áreas de ventana.</para
> <para
>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, y muchos otros diálogos también.</para
> <para
>Para emplear la ayuda ¿Qué es esto?, pulse <keycombo
>&Shift;<keycap
>F1</keycap
></keycombo
> o utilice la <menuchoice
><guimenu
>Ayuda</guimenu
><guimenuitem
>Qué es esto</guimenuitem
></menuchoice
>para activar el modo Qué es esto. El cursor se transformará en una flecha con una interrogación, y ahora usted puede pulsar sobre cualquier elemento en la ventana para leer la ayuda Qué es esto para ese elemento, si estuviera disponible.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Botones de ayuda en los diálogos</term
> <listitem
> <para
>Algunos diálogos tienen un botón <guibutton
>Ayuda</guibutton
>. Pulsandolo se iniciará el &khelpcenter; y se abrirá la documentación correspondiente.</para
> </listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2>
<title
>Con sus archivos de texto</title>

<para
>&kate; no proporciona (todavía) ningún medio de leer documentos relacionados con la documentación. Dependiendo del archivo que usted esté editando, puede que encuentre <link linkend="kate-mdi-tools-konsole"
>Incorporado en &konsole;</link
> de utilidad para ver páginas de manual de &UNIX; o de documentación info relacionadas, o puede que desee utilizar &konqueror;.</para>

</sect2>

</sect1>

</chapter>

