<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&klipper;">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE" -- change language only here -->
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>

<book lang="&language;">
<bookinfo>
<title>El manual de &klipper;</title>

<authorgroup>
<author>
<firstname>Philip</firstname>
<surname>Rodrigues</surname>
<affiliation>
<address><email>philip.rodrigues@libertysurf.co.uk</email></address>
</affiliation>
</author>

<othercredit role="developer">
<firstname>Carsten</firstname>
<surname>Pfeiffer</surname>
<affiliation>
<address><email>pfeiffer@kde.org</email></address>
</affiliation>
<contrib>Desarrollador</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation>
<address><email>vampyr@atconnex.net</email></address>
</affiliation>
<contrib>Revisora</contrib>
</othercredit>

<othercredit role="translator">
<firstname>Pablo</firstname>
<surname>de Vicente</surname>
<affiliation><address><email>pvicentea@nexo.es</email></address></affiliation>
<contrib>Traductor</contrib>
</othercredit>

</authorgroup>

<copyright>
<year>2000</year>
<holder>Philip Rodrigues</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>07/03/2001</date>
<releaseinfo>2.00.00</releaseinfo>

<abstract>
<para>&klipper; es el portapapeles de KDE, una utilidad para cortar y pegar.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Klipper</keyword>
<keyword>kdebase</keyword>
<keyword>portapapeles</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introducción</title>

<para>&klipper; es la utilidad portapapeles de KDE. Almacena la historia del 
portapapeles, y le permite enlazar los contenidos del portapapeles con las
operaciones de las aplicaciones. Por favor, si desea informar de cualquier 
problema o solicitar alguna propiedad más envie un mensaje a Carsten Pfeiffer
<email>pfeiffer@kde.org</email>.</para>

<sect1 id="klipper-revhistory">
<title>&klipper; Revisión histórica</title>

<itemizedlist>
<listitem><para>2.0.1 - Añadido tiempo de espera para suprimir el menú de 
&klipper; si no se hace nada con el texto del portapapeles.</para></listitem>
<listitem><para>2.0 - Lanzado junto con KDE 2.0. Añadido diálogo de 
configuración, grabación de la historia y las operaciones al 
salir</para></listitem>
<listitem><para>1.0 - primer lanzamiento público</para></listitem>
</itemizedlist>
</sect1>
</chapter>


<chapter id="using-klipper">
<title>Usando &klipper;</title>

<sect1 id="basic-usage">
<title>Uso básico</title>

<para>Para mostrar la historia del portatpapeles, pulse sobre el icono de 
&klipper;, o pulse 
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>V</keycap>
</keycombo>. Las entradas anteriores del portapapeles se muestran sobre el 
fondo del 
menú desplegable que aparece. Si selecciona una de ellas se copiará al 
portapapeles, desde donde puede ser pegada a cualquier aplicación KDE o X
del modo habitual.</para>

</sect1>

<sect1 id="actions">
<title>Operaciones</title>

<para>&klipper; puede realizar operaciones sobre el contenido del portatpapeles,
de acuerdo con una expresión regular determinada. Por ejemplo, cualquier 
contenido del portapapeles que comience con 
<quote>http://</quote> puede ser pasado a 
<application>Netscape</application> o &konqueror; para ser abierta como una 
&URL;.</para>

<para>Para utilizar esta propiedad, simplemente copie una &URL; o un nombre de
archivo al portapapeles. Si hay una expresión regular en la lista de &klipper;,
aparecerá un menú mostrandole las opciones de que dispone.
(por ejemplo Abrir &URL; en &konqueror;, abrir &URL; en &Netscape;). 
Utilice el ratón
o el teclado para seleccionar la opción que desee, y &klipper; ejecutará
el programa seleccionado, abriendo la dirección a la que apunta el contenido
del portapapeles.</para>

<para>Si no quiere realizar ninguna operación con los contenidos del 
portapapeles, seleccione <guimenuitem>No hacer nada</guimenuitem> en el menú
desplegable para volver a lo que estaba haciendo antes. Si abandona el menú, 
este desaparecerá, permitiendole continuar con su trabajo. Puede cambiar el
tiempo durante el que el menú permanece en el diálogo de preferencias, en la 
opción <guilabel>Retardo para operaciones desplegables</guilabel> en la pestaña
<guilabel>General</guilabel>.</para>

<para>Las operaciones se pueden desactivar completamente pulsando en &klipper; 
y seleccionando <guimenuitem>Operaciones activadas</guimenuitem>, o pulsando
<keycombo action="simul">&Ctrl;&Alt;<keycap>V</keycap></keycombo> seguido de
<keycombo action="simul">&Ctrl;&Alt;<keycap>X</keycap></keycombo>.</para>

<para>Los contenidos del portapapeles que se ajustan a una expresión regular
también pueden ser editados antes de realizar una operación sobre ellos. 
Seleccione <guimenuitem>Editar y procesar de nuevo</guimenuitem> en el menú
desplegable de &klipper;, podrá modificar los contenidos del portapapeles en el
diálogo que aparece, antes de pulsar el botón 
<guibutton>Aceptar</guibutton> para ejecutar la operación apropiada.</para>

<para>Si pulsa <keycombo
action="simul">&Ctrl;&Alt;<keycap>R</keycap></keycombo>
se mostrará el menú desplegable permitiendole repetir la última operación 
realizada por &klipper;.</para>

</sect1>
</chapter>

<chapter id="configuration">
<title>Configurando Klipper</title>

<sect1 id="viewing-options">

<title>Viendo las opciones</title>

<para>Para ver o cambiar las opciones de configuración de &klipper;, en
el menú desplegable de &klipper; seleccione 
<guimenu>Configuración</guimenu>. El diálogo de configuración de &klipper;
aparecerá. Sus contenidos se describen más abajo.</para>

<sect2 id="general-tab">
<title>Opciones generales</title>

<variablelist>

<varlistentry>
<term><guilabel>Menú desplegable en la posición del cursor</guilabel></term>
<listitem><para>Hace aparecer los menús desplegables de &klipper; en la 
posición del cursor, en lugar de en su posición predeterminada en el panel
de KDE. Util si utiliza el ratón más que el teclado.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Guardar el contenido del portatpapeles al 
salir</guilabel></term>
<listitem><para>Hace que &klipper; mantenga el contenido del histórico del 
portapapeles, y lo restaure la próxima vez que se ejecute.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Tiempo de espera para operaciones desplegables</guilabel></term>
<listitem><para>Fija el tiempo que un menú desplegable permanecerá si usted 
no hace nada con él.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="actions-tab">
<title>Opciones de operaciones</title>

<variablelist>
<varlistentry>
<term><guilabel>Editando expresiones/operaciones</guilabel></term>
<listitem><para>En la pestaña <guilabel>Operaciones</guilabel>, pulse sobre
la expresión regular u operación que desee editar. Aparecerá una caja en la que
podrá editar el texto que desee. Asegurese de pulsar Intro cuando haya 
finalizado.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Añadiendo expresiones/operaciones</guilabel></term>
<listitem><para>Pulse el botón <guimenuitem>Añadir operación</guimenuitem> 
para añadir una expresión regular para la que &klipper; pueda encontrar 
una correspondencia. &klipper; utiliza la clase 
<classname>QRegExp</classname> de Qt, y entiende la mayor parte de expresiones
regulares que utilizaría por ejemplo en <application>grep</application> o
<application>egrep</application>.</para>
<note><para>Puede encontrar información detallada sobre el uso de las 
expresiones regulares de <classname>QRegExp</classname> en <ulink
url="http://doc.trolltech.com/qregexp.html#details">http://doc.trolltech.com/qregexp.html#details</ulink>.
Advierta que &klipper; no soporta el modo de comodín mentcionado en esa 
página.</para></note>

<para>Edite la expresión regular como se describe más arriba. Para añadir un 
comando, pulse con el botón <mousebutton>derecho</mousebutton> del ratón, 
seleccione <guimenuitem>Añadir comando</guimenuitem> y edite el comando que
aparece en el árbol bajo la expresión regular.</para>

<para>Advierta que <token>%s</token> en la línea de comando es reemplazado por
los contenidos del portapapeles, por ejemplo si su definición de comando es 
<userinput><command>kedit</command> <token>%s</token></userinput> y el 
contenido de su portapapeles es <filename>/home/phil/textfile</filename>, 
se ejecutará el comando <userinput><command>kedit</command>
<filename>/home/phil/textfile</filename></userinput>.
Para incluir <token>%s</token> en la línea de comandos, utilice la barra 
reversa, de este modo: <userinput>\%s</userinput>.</para></listitem>

</varlistentry>
</variablelist>

</sect2>

<sect2 id="shortcuts-tab">
<title>Accesos rápidos</title>

<para>La pestaña de accesos rápidos le permite los accesos rápidos del teclado
que se utilzan para acceder a las funciones de &klipper;. Puede modificar 
el acceso rápido por una de las tres opciones siguientes:</para>

<variablelist>
<varlistentry>
<term><guilabel>Sin tecla</guilabel></term>
<listitem><para>La operación seleccionada no tiene acceso directo desde el 
teclado.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Tecla predeterminada</guilabel></term>
<listitem><para>La operación seleccionada utiliza la tecla predeterminada de
&klipper;. Estos son los accesos rápidos a los que se refiere este 
manual.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Tecla personalizada</guilabel></term>
<listitem><para>La operación seleccionada se asigna a las teclas que usted 
elija.</para>
<para>Para elegir una tecla personalizada para la operación que haya 
seleccionado, pulse sobre el icono de la llave en la parte inferior derecha de
la pantalla para activarla, e introduzca la tecla que desea desde el teclado.
La tecla que haya elegido puede ser combinada con alguna de las teclas 
modificadoras <keycap>Mayúsculas</keycap>, &Ctrl;,
o &Alt;, activando la opción correspondiente. </para> </listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>
</chapter>

<chapter id="credits">
<title>Creditos y Licencia</title>

<para>
Klipper
</para>
<para>
Copyright del programa 1998 Andrew Stanley-Jones <email>asj@cban.com</email>
</para>
<para>
Copyright del programa 1998-2000 Carsten Pfeiffer <email>pfeiffer@kde.org</email></para>
<para>
Actualmente mantenido por Carsten Pfeiffer
</para>

<para>
Copyright de la documentación 2000 Philip Rodrigues
<email>philip.rodrigues@libertysurf.co.uk</email> </para>

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title>Instalación</title>

<sect1 id="getting-klipper">
<title>¿Cómo obtener &klipper;?</title>

<para>&klipper; es parte del proyecto KDE <ulink
url="http://www.kde.org">http://www.kde.org</ulink>.  &klipper; puede 
encontrarse en el paquete kdebase en <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, el servidor
principal de ftp del proyecto KDE.</para>

</sect1>

<sect1 id="requirements">
<title>Requisitos</title>

<para>Para ejecutar &klipper;, necesita KDE 2.</para>

<para>Todas la librerías necesarias se pueden encontrar en 
<ulink url="ftp://ftp.kde.org">el servidor ftp de KDE</ulink>. </para>
</sect1>

<sect1 id="compilation">
<title>Compilación e instalación</title>
<para>&klipper; debería compilarse e instalarse junto con el paquete kdebase,
y aparecer en su panel KDE (&kicker;) cuando inicie KDE 2.</para>

<screenshot>
<screeninfo>Icono de Klipper</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG">
	  </imageobject>
	  <textobject>
	    <phrase>Instantánea</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>Para desactivarlo, simplemente elimine la referencia a &klipper;
en su archivo <filename>$KDEDIR/bin/startkde</filename></para>

</sect1>
</appendix>



<![ %addindex; [ &kdedocindex; ]]>

</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
