<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [
  <!ENTITY kappname "&klipper;">
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE" 
> <!-- change language only here -->
]>

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

<authorgroup>
<author
> <firstname
>Philip</firstname
> <surname
>Rodrigues</surname
> <affiliation
> <address
><email
>phil.rod@ntlworld.com</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
>lauri@kde.org</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
><year
>2001</year
><year
>2002</year>
<holder
>Philip Rodrigues</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-01-11</date>
<releaseinfo
>2.92.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>

</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"
>&Ctrl;&Alt;<keycap
>V</keycap
> </keycombo
>. Las entradas anteriores del portapapeles se muestran sobre el fondo del menú emergente 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 portapapeles, de acuerdo con una expresión regular determinada. Por ejemplo, cualquier contenido del portapapeles que comience con <quote
>http://</quote
> puede ser pasado a &Netscape; 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 (&eg; 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ú emergente 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 abierto en el diálogo de <guilabel
>Preferencias</guilabel
>, en la opción <guilabel
>Tiempo límite para operaciones emergentes</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ú emergente 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ú emergente permitiendole repetir la última operación realizada por &klipper;.</para>

</sect1>

<sect1 id="clipboard-modes">
<title
>Modos del portapapeles</title>

<sect2 id="clipboard-modes-general">
<title
>General</title>
<para
> &klipper; puede ser utilizado para configurar el modo del portapapeles en todo &kde;. El primer modo resulta familiar para los usuarios de &Microsoft; &Windows; y &Mac;: El texto se inserta en el portapapeles utilizando una función de cortar/pegar de aplicaciones (o generalmente <keycombo
>&Ctrl;<keycap
>X</keycap
></keycombo
> y <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
> respectivamente) y la función de pegado de las aplicaciones (o generalmente <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
>) pega el contenido en este portapapeles. </para>
<para
> El segndo modo es el más familiar para usuarios experimentados de &UNIX;: El texto seleccionado se copia a este portapapeles, y pulsando con el botón <mousebutton
>central</mousebutton
> del ratón se pegan los contenidos al portapapeles. </para>
</sect2>

<sect2 id="changing-clipboard-modes">
<title
>Cambiando los modos del portapapeles</title>
<para
> Para cambiar los modos del portapapeles, seleccione <guimenuitem
>Preferencias</guimenuitem
> desde el menú emergente de &klipper; y en el cuadro de diálogo que aparece, seleccione la ficha <guilabel
>General</guilabel
>.Las casillas <guilabel
>Sincronizar contenidos del portapapeles y selección</guilabel
> determinan el modo del portapapeles. Si la casilla es seleccionada, el portapapeles funciona en modo &UNIX;; si no se utiliza el modo &Windows;/&Mac;. </para>
</sect2>

</sect1>

</chapter>

<chapter id="preferences">
<title
>Preferencias de &klipper;</title>

<sect1 id="viewing-options">

<title
>Viendo el diálogo de preferencias</title>

<para
>Para ver o cambiar las opciones de configuración de &klipper;, abra el menú emergente de &klipper; y seleccione <guimenuitem
>Preferencias</guimenuitem
>. El diálogo de preferencias de &klipper; aparecerá. Sus contenidos se describen más abajo.</para>

</sect1>

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

<variablelist
> <varlistentry
> <term
><guilabel
>Menú emergente en la posición del cursor</guilabel
></term
> <listitem
><para
>Hace aparecer los menús emergentes 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 portapapeles al salir</guilabel
></term
> <listitem
><para
>Si esta opción está activada, al seleccionar un elemento de la historia &klipper; comprobará si cualquier operación para ese elemento es aplicable, y muestre las operaciones posibles. Si la opción está desactivada, las operaciones no se pueden ejecutar en elementos de la historia.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Reproducir las operaciones en un elemento seleccionado del historial</guilabel
></term
> <listitem
><para
>Si esta opción está activada, al seleccionar un elemento del historial hará que, si es apropiado &klipper; muestre las operaciones emergentes en ese elemento.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Sincronizar contenidos del portapapeles y de la selección.</guilabel
></term
> <listitem
><para
>Configura el modo del portapapeles. Vea <xref linkend="clipboard-modes"/>. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Impedir portapapeles vacío</guilabel
></term
> <listitem
><para
>Si se selecciona, el portapapeles nunca estará vacío. &klipper; insertará el elemento más reciente desde el portapapeles en la historia del portapapeles en lugar de permitir que esté vacío. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tiempo límite para operaciones emergentes</guilabel
></term
> <listitem
><para
>Fija el tiempo que un menú emergente permanecerá si usted no hace nada con él.</para
></listitem
> </varlistentry
> <varlistentry
><term
><guilabel
>Tamaño de la historia del portapapeles</guilabel
></term
> <listitem
><para
>Fija el número de los elementos que están almacenados en la historia del portapapeles.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

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

<variablelist
> <varlistentry
> <term
>Editando expresiones/operaciones</term
> <listitem
><para
>En la pestaña <guilabel
>Operaciones</guilabel
>, pulse sobre la expresión regular u operación que desee editar. Aparecerá un cuadro de edición de texto en el que podrá editar el texto como desee. Asegurese de pulsar <keysym
>Intro</keysym
> cuando haya finalizado.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Añadiendo expresiones/operaciones</term
> <listitem
><para
>Pulse el botón <guibutton
>Añadir operación</guibutton
> 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
> <para
>Puede añadir una descripción de un tipo de expresión regular (&eg; <quote
>HTTP URL</quote
>) pulsando con el botón <mousebutton
>izquierdo</mousebutton
> del ratón en la columna <guilabel
>Descripción</guilabel
>.</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
> <varlistentry
><term
><guibutton
>Avanzado...</guibutton
></term
> <listitem
><para
>Llama al diálogo <guilabel
>Desactivar operaciones para ventanas del tipo WM_CLASS</guilabel
></para
> <para
>Algunos programas, tales como &konqueror; utilizan el portapapeles internamente. Si recibe menús emergentes de &klipper; durante todo el tiempo cuando use una cierta aplicación, haga lo siguiente:</para
> <orderedlist
> <listitem
><para
>Abrir la aplicación</para
></listitem
> <listitem
><para
>Desde un terminal, ejecutar <userinput
><command
>xprop</command
> | <command
>grep</command
> <parameter
>WM_CLASS</parameter
></userinput
> y después pulsar sobre la ventana de la aplicación que está ejecutando</para
></listitem
> <listitem
><para
>La primera cadena de caracteres después del signo igual es la que hay que introducir</para
></listitem
> </orderedlist
> <para
>Una vez que haya añadido WM_CLASS, no se generarán más aplicaciones para ventanas de esa aplicación.</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 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 ha seleccionado, pulse sobre la representación de una tecla en la esquina derecha de la pantalla para activarla, y teclee la combinación deseada, como en cualquier aplicación &kde; </para
> </listitem
> </varlistentry
> </variablelist>

</sect1>
</chapter>

<chapter id="credits">
<title
>Créditos 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
> Documentación: copyright 2000-2002 Philip Rodrigues <email
>phil.rod@ntlworld.com</email
> </para>

&underFDL;
&underGPL;

</chapter>

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

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

&install.intro.documentation;

</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 3.</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 desactivar esto, simplemente borre el archivo <filename
>$KDEDIR/share/autostart/klipper.desktop</filename
> o cree un archivo <filename
>$HOME/share/autostart/klipper.desktop</filename
> con los siguientes contenidos: <programlisting>
[Desktop Entry]
Hidden=true
</programlisting
> Lo último mantendrá la instalación del sistema intacta y sólo impedirá que &klipper; sea iniciado por usted, sin afectar a otros usuarios. </para>

</sect1>
</appendix>

&documentation.index; 

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










