<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//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 en el diálogo de preferencias, 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:
-->










