# Manuel de &klipper;

## Introduction

&klipper; est l'outil du presse-papiers de &kde;. &klipper; conserve l'historique des entrées du presse-papiers et permet de les associer à des actions d'applications. Vous pouvez signaler un quelconque problème ou émettre un souhait avec le bugzilla de KDE, ou utiliser l'outil de rapport de bogue dans le menu Aide.

## Utilisation de &klipper;

### Fonctions de base

L'icône de &klipper;. L'icône de &klipper;

Pour afficher l'historique du presse-papiers, cliquez sur l'icône &klipper; du tableau de bord de &kde; ou appuyez simultanément sur &Ctrl;&Alt;V . Les précédentes entrées du presse-papiers se trouvent dans la partie haute du menu contextuel qui s'affiche. Le fait de sélectionner une de ces entrées la copie dans le presse-papiers d'où elle pourra, de manière classique, être collée dans toute application &kde; ou X.

Le raccourci pour cette action doit être configuré dans la Configuration de la boîte à miniatures dans la page entrées.

Vous pouvez chercher dans l'historique du presse-papiers en l'ouvrant (cliquez sur &klipper;), et en saisissant votre requête. Les résultats sont mis à jour lorsque vous saisissez les caractères. Si vous vous demandez comment utiliser les accélérateurs clavier dans &klipper;, appuyez simplement sur &Alt; et l'accélérateur souhaité. Par exemple, pour effacer l'historique du presse-papiers lorsque le menu de &klipper; est ouvert, appuyez sur &Alt; et la lettre soulignée dans Effacer l'historique du presse-papier.

Sélectionnez Afficher le code barre depuis le menu contextuel de &klipper; pour ouvrir une boîte de dialogue avec un code QR et un code barre DataMatrix. Utilisez &ksnapshot; pour capturer les codes barres et les enregistrer.

Pour désactiver &klipper;, cliquez sur l'icône, et depuis le menu qui apparaît, choisissez Quitter.

### Actions

&klipper; peut exécuter certaines actions en rapport avec le contenu du presse-papiers dont la forme correspond à une expression rationnelle particulière. Par exemple, toute entrée du presse-papiers commençant par http:// peut être envoyée à Firefox ou &konqueror; en tant qu'&URL; à ouvrir. De plus, si le contenu correspond à un emplacement, des actions semblables peuvent être effectuées en fonction du type de fichier. Par exemple, si l'emplacement vers un fichier PDF est copié dans le presse-papiers, le fichier peut être affiché dans &okular;.

Pour utiliser cette fonction, sélectionnez simplement une &URL; ou un emplacement. S'il existe une expression rationnelle qui correspond dans la liste de &klipper;, un menu contenant les programmes pour votre sélection apparaît. Utilisez la souris ou les touches du curseur pour choisir un programme, et &klipper; lancera l'application sélectionnée avec, comme argument, l'adresse pointée par la sélection.

Si vous ne désirez pas appliquer d'actions au contenu du presse-papiers, sélectionnez Fermer la boîte de dialogue dans le menu surgissant pour retourner à ce que vous faisiez avant. Si vous laissez le menu, il disparaîtra, vous laissant continuer votre travail. Il est possible de paramétrer la durée durant laquelle le menu est apparent dans la boîte de dialogue Configurer &klipper;..., avec l'option Durée d'ouverture du menu contextuel des actions dans l'onglet Général. Vous pouvez désactiver séparément la partie concernant l'emplacement de fichier en utilisant l'option activer les actions MIME dans la page Actions.

Pour désactiver complètement les actions associées, cliquez sur l'icône de &klipper; et désélectionnez Activer les actions du presse-papiers, ou appuyez sur &Ctrl;&Alt;X.

Il est possible de modifier les entrées qui correspondent à des expressions rationnelles avant même d'y associer une action. Dans le menu contextuel de &klipper;, choisissez Modifier le contenu... : vous pouvez modifier l'entrée choisie dans la zone d'édition qui apparaît, avant de cliquer sur Ok pour lancer l'action associée.

Une pression simultanée des touches &Ctrl;&Alt;R affiche le menu contextuel permettant de répéter la dernière action effectuée par &klipper;.

### Comportement du presse-papiers et de la sélection

#### Général

&klipper; peut être utilisé pour définir le comportement du presse-papiers et de la sélection dans &kde;.

Le système &X-Window; utilise deux zones tampons différentes pour le copier / coller : la sélection et le presse-papiers. Le texte est placé dans la zone tampon de sélection simplement en le sélectionnant, et il peut être collé avec le bouton central de la souris. Pour placer du texte dans la zone tampon du presse-papiers, sélectionnez-le puis appuyez simultanément &Ctrl;X ou &Ctrl;C . Le texte de la zone tampon du presse-papiers est collé en pressant simultanément &Ctrl;V ou en sélectionnant Édition Coller .

#### Changer le comportement du presse-papiers et de la sélection

Pour changer le comportement du presse-papiers / de la sélection, dans le menu contextuel du tableau de bord sélectionnez Configurer &klipper;..., puis dans la boîte de dialogue qui apparaît, sélectionnez la page Général. Décocher Synchroniser le contenu du presse-papiers et la sélection rend la zone tampon du presse-papiers et celle de la fonction de sélection indépendantes. Avec cette option définie, l'option Ignorer la sélection, empêchera &klipper; d'inclure le contenu de la sélection dans l'historique du presse-papiers et de réaliser des actions sur le contenu de la sélection. Avec l'option Synchroniser le contenu du presse-papiers et la sélection, la zone tampon du presse-papiers et de la sélection ont toujours le même contenu. Cela signifie que le texte de la sélection peut être collé soit avec le bouton central de la souris, soit par la combinaison de touche &Ctrl;V , et de le même façon pour le texte de la zone tampon du presse-papiers.

## Configuration de &klipper;

### Afficher la boîte de dialogue de configuration

Pour voir ou modifier les options de &klipper;, ouvrez le menu surgissant de &klipper; et sélectionnez Configurer &klipper;.... La boîte de dialogue de configuration de &klipper; s'affiche alors. Son contenu est décrit ci-dessous.

### Général

Enregistrer le contenu du presse-papiers en quittant

- Si cette option est activée, l'historique du presse-papiers sera enregistré en quittant &klipper; afin de permettre son utilisation au prochain lancement de &klipper;.

Empêcher le presse-papiers d'être vidé

- Si cette option est activée, le presse-papiers ne sera jamais vide : &klipper; insérera l'élément le plus récent dans l'historique du presse-papiers plutôt que de le laisser se vider.

Ignorer les images

- Lorsqu'une partie de l'écran est sélectionné avec la souris ou le clavier, on l'appelle sélection. Si cette option est sélectionnée, seules les sélections de texte sont stockée dans l'historique, tandis que les images et les autres sélections ne le sont pas.

Ignorer la sélection

- Règle le mode du presse-papiers. Cette option empêchera &klipper; d'inclure le contenu de la sélection dans l'historique du presse-papiers et d'effectuer les actions sur le contenu de la sélection. Voyez clipboard-modes.

Sélection de texte uniquement

- Lorsqu'une partie de l'écran est sélectionné avec la souris ou le clavier, on l'appelle sélection. Si cette option est sélectionnée, seules les sélections de texte sont stockée dans l'historique, tandis que les images et les autres sélections ne le sont pas.

Synchroniser le contenu du presse-papiers et la sélection

- Règle le mode du presse-papiers. Lorsqu'une partie de l'écran est sélectionné avec la souris ou le clavier, on l'appelle sélection. Si cette option est sélectionnée, la sélection et le presse-papiers seront maintenus identiques, de sorte que tout ce qui se trouve dans la sélection est immédiatement prêt à être collé quelle que soit la méthode, y compris le traditionnel bouton central de la souris. Sinon, la sélection est enregistrée dans l'historique du presse-papiers, mais ne peut être collée qu'en utilisant le bouton central de la souris. Voyez également l'option Ignorer la sélection. Voyez clipboard-modes.

Durée d'ouverture des menus Action

- Détermine la durée après laquelle le menu action disparaît, dans le cas où il n'est pas utilisé.

Taille de l'historique du presse-papiers

- Règle le nombre d'éléments enregistrés dans l'historique du presse-papiers.

### Options des actions

Répéter les actions sur un élément sélectionné dans l'historique

- Si cette option est activée, &klipper; affiche le menu surgissant des actions lorsqu'un élément est sélectionné, si c'est possible.

Supprimer les espaces lors de l'exécution des actions

- Si cette option est activée, tous les espaces (caractère espace, tabulation, &etc;) au début ou à la fin du contenu du presse-papiers seront supprimés avant de passer ce contenu à l'application. C'est utile, par exemple, si le presse-papiers contient une &URL; avec des espaces, ce qui causerait des erreurs si elle était chargée telle quelle dans le navigateur.

Activer les actions relatives au type MIME

- Si cette option est activée, en plus des actions que vous avez définies, une liste d'applications pour le type MIME détecté apparaîtra dans le menu contextuel.

Modifier une expression / action

- Dans la page Actions, double-cliquez sur l'expression rationnelle ou l'action à modifier ou sélectionnez-là et appuyez sur le bouton Modifier l'action. Une boîte de dialogue apparaît, dans laquelle le texte peut être modifié.

Ajouter une expression / action

- Cliquez sur le bouton Ajouter une action pour ajouter une expression rationnelle à celles que &klipper; prend en charge. &klipper; utilise `QRegExp` de &Qt;, qui traite la plupart des expressions rationnelles que vous pourriez utiliser dans les commandes grep ou egrep, par exemple.

  Vous pouvez ajouter une description du type d'expression rationnelle (&pex; HTTP) en cliquant avec le bouton gauche dans la colonne Description.

  Pour plus de détails concernant les expressions rationnelles de `QRegExp`, veuillez consulter la page http://qt-project.org/doc/qt-4.8/qregexp.html#details. Notez toutefois que &klipper; ne gère pas le mode « Wildcard » mentionné sur cette page.

  La modification des expressions rationnelles est décrite ci-dessous. Pour associer une commande à exécuter, cliquez sur Ajouter une commande, puis modifiez la commande dans la boîte d'édition de texte. Double-cliquez sur une commande pour la modifier.

  Notez qu'un %s placé dans une ligne de commande sera remplacé par le contenu courant du presse-papiers. Par exemple : si vous inscrivez ``kwrite` %s` alors que le presse-papiers contient `/home/phil/fichier_texte`, la commande lancée sera : ``kwrite``/home/phil/fichier_texte`` . Dans une ligne de commande, %s doit être précédé d'une barre oblique inversée (backslash), comme suit : `\%s`

Avancé

- Affiche la boîte de dialogue Désactiver les actions pour les fenêtres du type WM_CLASS.

  Certains programmes, comme &konqueror;, utilisent le presse-papiers de manière interne. Si le menu surgissant de &klipper; apparaît tout le temps lorsque vous utilisez certaines applications, faites ce qui suit :

  1. Ouvrez l'application

  2. Depuis un terminal, exécutez ``xprop` | `grep` `WM_CLASS`` et cliquez ensuite sur la fenêtre de l'application que vous exécutez.

  3. La première chaîne après le signe égal est celle à saisir.

  Une fois que WM_CLASS est ajouté, plus aucune action ne sera générée pour les fenêtres de cette application.

### Raccourcis

La page Raccourcis vous permet de modifier les raccourcis clavier utilisés pour accéder aux fonctions de &klipper;. Trois options s'offrent à vous :

Aucun raccourci

- Aucun raccourci ne sera assigné à l'action sélectionnée.

Raccourci par défaut

- L'action sélectionnée est associée au raccourci par défaut de &klipper;. Les raccourcis par défaut sont ceux mentionnés tout au long de ce manuel.

Raccourci personnalisé

- C'est vous qui définissez le raccourci pour l'action sélectionnée.

  Pour choisir la touche qui servira de raccourci à l'action sélectionnée, cliquez sur Personnalisé puis Aucun. Saisissez maintenant la combinaison de touches désirée sur votre clavier, comme dans n'importe quelle application &kde;.

Si vous définissez un raccourci clavier pour Afficher Klipper à la position de la souris, lorsque vous appuyez sur ce dernier, le menu contextuel de &klipper; s'ouvre à l'emplacement du pointeur de la souris plutôt qu'à sa position par défaut, dans le tableau de bord de &kde;. Très utile si vous vous servez plus de la souris que du clavier.

## Remerciements et licence

&klipper;

Programme sous copyright 1998 &Andrew.Stanley-Jones; asj@cban.com.

Programme sous copyright 1998-2000 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;

Actuellement maintenu par Esben Mose Hansen. Voyez http://mosehansen.dk/about pour les détails sur les contacts.

Documentation sous copyright 2000-2003, 2005 &Philip.Rodrigues; &Philip.Rodrigues.mail;

Traduction française par &YvesDessertine; &PhillipDucharme; &GillesThioliere; &DamienRaudeMorvan; et &LudovicGrossard;.

&underFDL; &underGPL;

## Installation

### Comment obtenir &klipper;

&install.intro.documentation;

### Compilation et installation

&install.compile.documentation;
&documentation.index;