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

<book id="klipper" lang="&language;">
<bookinfo>
<title
>Manual de &klipper; </title>

<authorgroup>
<author
>&Philip.Rodrigues; &Philip.Rodrigues.mail;</author>

<othercredit role="developer"
>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail; </othercredit>

<othercredit role="translator"
> <firstname
>Rocío</firstname
> <surname
>Gallego</surname
> <affiliation
><address
><email
>traducciones@rociogallego.com</email
></address
></affiliation
> <contrib
>Traducción</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
> <othercredit role="translator"
> <firstname
>Marcos</firstname
> <surname
>Fouces Lago</surname
> <affiliation
><address
><email
>mfouces@yahoo.es</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
> <othercredit role="translator"
><firstname
>Santiago</firstname
><surname
>Fernández Sancho</surname
><affiliation
><address
><email
>santi@kde-es.org</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>2000-2003</year>
<holder
>&Philip.Rodrigues;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2022-05-05</date>
<releaseinfo
>Plasma 5.25</releaseinfo>

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

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Klipper</keyword>
<keyword
>kdebase</keyword>
<keyword
>portapapeles</keyword>
</keywordset>
</bookinfo>
<!--http://blog.martin-graesslin.com/blog/2014/07/next-generation-klipper/-->
<chapter id="introduction">
<title
>Introducción</title>
<para
>&klipper; es la utilidad del portapapeles de &plasma;. Guarda el historial del portapapeles y permite enlazar su contenido a acciones de las aplicaciones. Si desea informar de cualquier problema o solicitar alguna funcionalidad, envíe un mensaje al <ulink url="http://bugs.kde.org"
>bugzilla de KDE</ulink
>.</para>

</chapter>

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

<sect1 id="basic-usage">
<title
>Uso básico</title>
<para
>Puede usar &klipper; en la bandeja del sistema como <emphasis
>widget</emphasis
> de &plasma; o como aplicación clásica. Ambos modos comparten la misma funcionalidad, aunque tienen una interfaz distinta, y muestran el último elemento del historial al situar el puntero del ratón sobre el icono de &klipper; en la bandeja del sistema: </para>

<screenshot>
<screeninfo
>El icono de &klipper;.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screenshot.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>El icono de &klipper;.</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>El widget de &klipper; está oculto si el portapapeles está vacío.</para>

<para
>Para mostrar el historial del portapapeles, pulse el icono de &klipper; que hay en la bandeja del sistema.</para>

<sect2 id="klipper-widget">
<title
>Elemento gráfico de &klipper;</title>
<screenshot>
<screeninfo
>El elemento gráfico de &klipper;.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="klipper-widget.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>El elemento gráfico de &klipper;</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Sitúe el puntero del ratón sobre una entrada para que aparezcan cuatro iconos que le permiten invocar una acción, mostrar un código de barras, editar el contenido o eliminar la entrada del historial. Use &spectacle; para capturar los códigos de barras y guardarlos. </para>

<para
>Puede buscar en el historial del portapapeles abriéndolo (pulse sobre &klipper;) y escribiendo la consulta. Los resultados se actualizarán según vaya escribiendo. Para borrar el historial del portapapeles, pulse el icono que hay a la derecha del campo de búsqueda. </para>

<para
>La acción <guilabel
>Configurar el portapapeles...</guilabel
> del menú de contexto abre el <link linkend="preferences"
>diálogo de preferencias</link
>. </para>

</sect2>
</sect1>

<sect1 id="actions">
<title
>Acciones</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 «http://» se puede pasar a Firefox o a &konqueror; para ser abierta como una &URL;. Además, si el contenido corresponde a una ruta, se pueden realizar acciones similares según el tipo de archivo. Por ejemplo, si se copia la ruta de un archivo <quote
>PDF</quote
> en el portapapeles, el archivo se puede ver en &okular;.</para>

<para
>Para utilizar esta funcionalidad, basta con que seleccione una &URL; o una ruta en el portapapeles. Si cumple alguna expresión regular de la lista de &klipper;, aparecerá un menú mostrándole los programas de los que dispone para que elija uno. Utilice el ratón o las teclas de cursor para seleccionar el programa que desee y &klipper; lo ejecutará, abriendo la dirección a la que apunta el contenido del portapapeles.</para>

<para
>Si no quiere realizar ninguna acción con el contenido del portapapeles, seleccione <guimenuitem
>Desactivar este menú emergente</guimenuitem
> en el menú emergente para volver a lo que estaba haciendo antes. Si abandona el menú, este desaparecerá, permitiéndole continuar con su trabajo. Puede cambiar el tiempo durante el cual permanece abierto el menú en el diálogo de preferencias, con la opción <guilabel
>Mostrar menú emergente de acciones</guilabel
> de la página <guilabel
>General</guilabel
>. Puede desactivar de manera independiente la parte de la ruta de archivos mediante la opción <guilabel
>Incluir acciones MIME</guilabel
> en la página <guilabel
>Menú de acciones</guilabel
>.</para>

<para
>Se pueden desactivar acciones completamente usando el atajo de teclado <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>X</keycap
></keycombo
>.</para>

<para
>El contenido del portapapeles que se ajuste a una expresión regular también se puede editar antes de realizar una acción sobre él. Seleccione <guimenuitem
>Editar contenido...</guimenuitem
> a la derecha de la entrada del portapapeles para poder cambiar el contenido del portapapeles en el diálogo que aparecerá, antes de pulsar el botón <guibutton
>Aceptar</guibutton
> para ejecutar la acción apropiada.</para>

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

</sect1>

<sect1 id="clipboard-modes">
<title
>Comportamiento del portapapeles/selección</title>

<sect2 id="clipboard-modes-general">
<title
>General</title>
<para
>&klipper; se puede usar para cambiar el comportamiento del portapapeles y de la selección en &plasma;. </para>

<note
><para
>&X-Window; utiliza dos memorias temporales separadas como portapapeles: la «selección» y el «portapapeles». El texto se colocará en la memoria temporal de selección simplemente con seleccionarlo y se podrá pegar usando el botón central del ratón. Para colocar el texto en la memoria temporal del portapapeles, selecciónelo y pulse <keycombo
>&Ctrl;<keycap
>X</keycap
> </keycombo
> o <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
>. El texto de la memoria temporal del portapapeles se puede pegar usando <keycombo
>&Ctrl;<keycap
>V</keycap
> </keycombo
> o seleccionando <guimenuitem
>Pegar</guimenuitem
> en un menú de contexto.</para>
</note>

</sect2>

<sect2 id="changing-clipboard-modes">
<title
>Cambiar el comportamiento del portapapeles/selección</title>
<para
>Para cambiar el comportamiento del portapapeles o de la selección, seleccione <guimenuitem
>Configurar el portapapeles...</guimenuitem
> en el menú de contexto de &klipper; y en el diálogo que aparezca, seleccione la página <guilabel
>General</guilabel
>. Si quita la marca de la opción <guilabel
>Selección y portapapeles</guilabel
>, hará que el portapapeles y la selección funcionen en memorias intermedias completamente separadas, tal y como se ha descrito anteriormente. Si marca esta opción, la opción <guilabel
>Ignorar</guilabel
> evitará que &klipper; incluya el contenido del portapapeles en su historial y que se realicen operaciones sobre el contenido de la selección. Si selecciona <guilabel
>Selección y portapapeles</guilabel
>, las memorias intermedias del portapapeles y de la selección serán siempre iguales, lo que significa que el texto seleccionado se podrá pegar con el botón <mousebutton
>central</mousebutton
> del ratón o con la combinación de teclas <keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
>, y lo mismo se puede aplicar a la memoria intermedia del portapapeles. </para>

 <!-- The
<guilabel
>Synchronize contents of the clipboard and the
selection</guilabel
> check box determines the clipboard mode. If the box is
selected, the clipboard functions in the &UNIX; mode; if not, the
&Windows;/&Mac; mode is used. -->

</sect2>


</sect1>

</chapter>

<chapter id="preferences">
<title
>Configuración de &klipper;</title>

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

<variablelist>

<varlistentry
><term
><guilabel
>Selección y portapapeles</guilabel
></term>
<listitem
><para
>Cuando se resalta con el ratón o con el teclado un texto o un área de la pantalla, esta es la <emphasis
>selección</emphasis
>. Se puede pegar con el botón central del ratón.</para
><para
>Si la selección se copia explícitamente usando una acción <guimenuitem
>Copiar</guimenuitem
> o <guimenuitem
>Cortar</guimenuitem
>, se guarda en el <emphasis
>portapapeles</emphasis
>. Se puede pegar usando una acción <guimenuitem
>Pegar</guimenuitem
>.</para
><para
>Cuando está activada, esta opción mantiene la selección y el portapapeles iguales, de modo que cualquier selección esté inmediatamente disponible para pegarla con cualquier método. Si está desactivada, la selección aún se puede guardar en el historial del portapapeles (acción sujeta a las opciones siguientes), pero solo se puede pegar con el botón central del ratón.</para
></listitem>
</varlistentry>

<varlistentry
><term
><guilabel
>Historial del portapapeles</guilabel
></term>
<listitem
><para
>Conmuta el historial del portapapeles.</para
></listitem>
</varlistentry>

<varlistentry
><term
><guilabel
>Número de entradas</guilabel
></term>
<listitem
><para
>Fija el número de los elementos que están almacenados en el historial del portapapeles.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Selección de texto</guilabel
></term>
<listitem
><para
>Cuando se selecciona un área de la pantalla con el ratón o con el teclado, esta se convierte en la «selección». Esta opción determina si las selecciones de texto se guardan en el historial del portapapeles. Se puede escoger entre <guilabel
>Guardar siempre en el historial</guilabel
> y <guilabel
>Solo cuando se copie explícitamente</guilabel
>. La opción <guilabel
>Guardar siempre en el historial</guilabel
> no está disponible si está desactivada la sincronización entre selección y portapapeles (en este caso, la selección nunca se guarda automáticamente en el historial del portapapeles). Consulte <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 

<varlistentry>
<term
><guilabel
>Selección que no es de texto</guilabel
></term>
<listitem
><para
>Esta opción determina si las selecciones que no son de texto (como las imágenes) se guardan en el historial del portapapeles. Se puede escoger entre <guilabel
>Guardar siempre en el historial</guilabel
>, <guilabel
>Solo cuando se copie explícitamente</guilabel
> y <guilabel
>No guardar nunca en el historial</guilabel
>. La opción <guilabel
>Guardar siempre en el historial</guilabel
> no está disponible si está desactivada la sincronización entre selección y portapapeles (en este caso, la selección no se guarda nunca automáticamente en el historial del portapapeles). Consulte <xref linkend="clipboard-modes"/>. </para>
</listitem>
</varlistentry
> 

</variablelist>

</sect1>

<sect1 id="action-menu-page">
<title
>Menú de acciones</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Mostrar menú emergente de acciones</guilabel
></term>
<listitem
><para
>Fija el tiempo que un menú emergente permanecerá si no se hace nada con él.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Reemplazar 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
><guibutton
>Excluir ventanas</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; constantemente cuando use una cierta aplicación, haga lo siguiente:</para>

<orderedlist>
<listitem
><para
>Abra la aplicación.</para
></listitem>
<listitem
><para
>Desde un terminal, ejecute <userinput
><command
>xprop</command
> | <command
>grep</command
> <parameter
>WM_CLASS</parameter
></userinput
> y después pulse 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 operaciones para las ventanas de esa aplicación.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Elimina los espacios en blanco al ejecutar acciones</guilabel
></term>
<listitem
><para
>Si está seleccionado se eliminarán todos los espacios en blanco (espacios, tabuladores, &etc;) que se encuentren al principio y al final del contenido del portapapeles antes de ser pasado a una aplicación. Esto es práctico, por ejemplo, si el portapapeles contiene una &URL; con espacios en blanco, lo que puede provocar un error al intentar abrirla en un navegador.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Incluir acciones MIME</guilabel
></term>
<listitem
><para
>Si se selecciona, incluye aplicaciones que pueden aceptar el tipo &MIME; de un nombre de archivo o URL seleccionado en el menú emergente.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="actions-configuration-page">
<title
>Configuración de acciones</title>

<variablelist>
<varlistentry>
<term
>Editando expresiones/operaciones</term>
<listitem
><para
>En la página <guilabel
>Operaciones</guilabel
>, haga doble clic sobre la expresión regular o acción que desee editar o seleccionar y pulse el botón <guibutton
>Editar acción</guibutton
>. Aparecerá un diálogo con el texto de la expresión en el que podrá editarla como desee.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Añadiendo expresiones/operaciones</term>
<listitem
><para
>Pulse el botón <guibutton
>Añadir acción...</guibutton
> para añadir una expresión regular con la que &klipper; pueda encontrar una coincidencia. &klipper; usa la clase la clase <classname
>QRegularExpression</classname
> de &Qt;, que usa PCRE (expresiones regulares compatibles con Perl).</para>
<para
>Puede añadir una descripción de un tipo de expresión regular (&eg; «HTTP URL») 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
>QRegularExpression</classname
> en la <ulink url="https://doc.qt.io/qt-5/qregularexpression.html#details"
>documentación en línea de Qt</ulink
>.</para
></note>

<para
>Edite la expresión regular como se describió anteriormente. Para añadir una orden, pulse <guimenuitem
>Añadir orden</guimenuitem
> y edite la orden que aparece en cuadro de edición. Para editar una orden, haga doble clic en ella.</para>

<para
>Tenga en cuenta que <token
>%s</token
> en la línea de órdenes se sustituye por los contenidos del portapapeles, &eg;, si su definición de orden es <userinput
><command
>kwrite</command
> <token
>%s</token
></userinput
> y el contenido de su portapapeles es <filename
>/home/phil/textfile</filename
>, se ejecutará la orden <userinput
><command
>kwrite</command
> <filename
>/home/phil/textfile</filename
></userinput
>. Para incluir <token
>%s</token
> en la línea de órdenes, utilice la barra inversa, de este modo: <userinput
>\%s</userinput
>.</para>

<para
>Las entradas de <userinput
><token
>%0</token
></userinput
> a <userinput
><token
>%9</token
></userinput
> se sustituirán con los correspondientes textos capturados del patrón de coincidencia. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="shortcuts-page">
<title
>Opciones de los atajos de teclado</title>

<para
>La página de atajos de teclado le permite cambiar los atajos de teclado que se utilizan para acceder a las funciones de &klipper;. Puede modificar el atajo de teclado mediante una de las tres opciones siguientes:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Ninguna</guilabel
></term>
<listitem
><para
>No se puede acceder directamente a la acción seleccionada con el teclado.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Predeterminada</guilabel
></term>
<listitem
><para
>La acción seleccionada utiliza la tecla predeterminada de &klipper;. Estos son los atajos de teclado a los que se refiere este manual.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Personalizar</guilabel
></term>
<listitem
><para
>La acción seleccionada se asigna a las teclas que elija.</para>
<para
>Para elegir una tecla personalizada para la acción que ha seleccionado, pulse <guilabel
>Personalizar</guilabel
> y después, <guilabel
>Ninguna</guilabel
>. A continuación, teclee la combinación deseada, como en cualquier aplicación de &kde;. </para
> </listitem>
</varlistentry>
</variablelist>

<para
>Si define un atajo de teclado para <guilabel
>Abrir Klipper en la posición del ratón</guilabel
>, al pulsar dicho atajo de teclado se abrirá el menú emergente de  en la posición del cursor del ratón, en lugar de hacerlo en su posición predeterminada (en el panel de &plasma;). Esto resulta útil si utiliza el ratón más que el teclado.</para>

</sect1>
</chapter>

<chapter id="credits">
<title
>Créditos y licencia</title>

<para
>&klipper; </para>
<para
>Derechos de autor del programa. 1998. &Andrew.Stanley-Jones; <email
>asj@cban.com</email
>. </para>
<para
>Derechos de autor del programa. 1998-2000. &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;.</para>
<para
>El encargado actual es Esben Mose Hansen. En <ulink url="http://mosehansen.dk/about"
>http://mosehansen.dk/about</ulink
> tiene información de contacto. </para>

<para
>Derechos de autor de la documentación. 2000-2003, 2005. &Philip.Rodrigues; &Philip.Rodrigues.mail;.</para>

<para
>Traducido por Pablo de Vicente <email
>pvicentea@nexo.es</email
>, Marcos Fouces Lago <email
>mfouces@yahoo.es</email
> y Santiago Fernández Sancho <email
>santi@kde-es.org</email
>.</para
> &underFDL; &underGPL; </chapter>


&documentation.index; 

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










