## Manuel de Clipman

### Mike Massonnet

`<mmassonnet@xfce.org>`

This manual describes version 1.0.1 of Clipman.

Copyright © 2009 Mike Massonnet

Copyright © 2009 Mike Massonnet (mmassonnet@xfce.org)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. The complete license text is available from the Free Software Foundation.

April, July 2009

## Introduction

Clipman est un gestionnaire de presse-papier pour Xfce. Il conserve le contenu du presse-papier tandis qu'il est habituellement perdu lors de la fermeture d'une application. Il est capable de gérer du texte et des images, et possède une fonctionnalité pour exécuter des actions sur du texte spécifique en le comparant à des expressions régulières.

### Anatomie d'un presse-papier

Dans X11 (toutes les plateformes Unix) il y a par défaut deux presses-papiers pour échanger des données à travers les fenêtres. Un presse-papier par défaut qui est modifié lors d'une copie manuelle (par exemple en sélectionnant un fichier et en cliquant sur le bouton Copier), et un presse-papier primaire qui est modifié lors des sélections de textes.

Clipman gère uniquement le presse-papier par défaut, mais peut également prendre en compte les sélections. Lorsqu'il gère les sélections, le presse-papier par défaut est toujours synchronisé avec celui-ci et contient les mêmes données. De ce fait il est possible de coller avec le clavier ce qui est sélectionné sur l'écran.

### Démarrer

Clipman est utilisé pour garder une liste d'historique des éléments du presse-papier et permet de les restaurer. L'historique est afficher dans un menu accessible depuis l'icône principale. Dans le menu il est possible de restaurer un texte ou de vider l'historique.

Figure 1. Menu Clipman

Il y a deux manières pour exécuter Clipman. Vous pouvez sélectionner Clipman dans le menu des applications sous la catégorie Utilitaire ou lancer la commande `xfce4-clipman` depuis une ligne de commande, ou vous pouvez l'ajouter dans le panneau. Pour ajouter un nouvel élément dans le panneau cliquez du bouton droit sur le panneau et choississez « Ajouter un item… ».

### Commande de popup

Clipman fournit l'outil `xfce4-popup-clipman`. Lorsqu'il est invoqué le menu principal est affiché. La commande est pratique pour les Raccourcis d'applications accessible dans Menu Xfce+Paramètres+Clavier.

## Paramètres

Le dialogue de paramètres est disponible via l'item « Propriétés » depuis le menu contextuel clic-droit sur l'icône principale. Il permet d'affiner l'historique et d'éditer les actions.

### Général

La table suivante décrit les options disponibles :

Tableau 1. Options générales dans le dialogue de paramètres

Options | Description
--- | ---
Synchroniser les sélections | Le presse-papier primaire est synchronisé avec le presse-papier par défaut et de cette manière il est possible de coller ce qui est sélectionné
Exclure de l'historique | Empêche les éléments du presse-papier primaire d'apparaître dans l'historique
Sauvegarder avant de quitter | Conserve l'historique à chaque nouvelle session
Stocker une image | Autorise le stockage d'une image dans l'historique
Taille de l'historique | Définit le nombre d'éléments à conserver dans l'historique

Figure 2. Paramètres de Clipman

### Actions

Une action est composée de la paire d'un nom et d'une expression régulière. Chaque action peut contenir une à plusieurs commandes. Le support des actions est facultatif et peut être activer ou désactiver en cochant la case « Activer les actions ».

Pour ajouter une action cliquez sur l'icône Ajouter, pour éditer une action sélectionnez l'action et cliquez sur l'icône Editer ou double cliquez l'action, et pour supprimer une action sélectionnez l'action et cliquez sur l'icône Supprimer. En ajoutant ou en éditant une action un nouveau dialogue est ouvert.

Pour en savoir plus sur les actions aller à la section intitulée « Dialogue d'action ».

Figure 3. Paramètres de Clipman

### Dialogue d'action

Une action possède un nom lisible qui décrit le motif qu'elle possède. Une action doit avoir au minimum une commande qui elle aussi possède un nom lisible. Le texte qui est comparé peut être réutilisé dans une commande.

Les actions sont comparées aux sélections à moins d'être spécifiées autrement. Si la case « Activer uniquement lors des copies manuelles » est active, l'action sera comparée avec le presse-papier par défaut (e.g. avec Ctrl+C).

Figure 4. Dialogue d'action

#### Expression régulière

Caractères spéciaux de base : « `.?+*(|)[]\` ».

- « `.` » : représente un caractère unique.
- « `?+*` » : signifit respectivement zero ou un caractère, un ou plusieurs caractères, zero ou plusieurs caractères.
- « `(|)` » : utilisé pour grouper et les substitutions, la barre verticale est utilisé comme opération logique OU.
- « `[^]` » : utilisé pour comparer un caractère à un champ de caractères normaux et spéciaux, le circonflexe est utilisé au début comme une négation.
- « `\` » : échappe un caractère spécial.

Classe de caractères de bases alphanumérique : « `A-Za-z0-9` ». Les classes de caractères sont utilisées à l'intérieur des crochets et représentent plusieurs caractères.

##### Exemples

- « `bug ?#?[0-9]+` » : texte « bug », zero ou un espace, zero ou un caractère dieze, et un ou plusieurs chiffres.
- « `(http|ftp).+\.(jpg|png|gif)` » : texte « http » ou « ftp », un ou plusieurs caractères, un point, et le texte « jpg », « png » ou « gif ».
- « `http://.{120}[^ ]+` » : texte « http:// », 120 caractères, et un ou plusieurs caractères à l'exception d'un espace.

##### Ressource externe

Consultez cette article Wikipedia pour avoir des informations sur les expressions régulières.

#### Commande

Une commande peut réutiliser une ou plusieurs substitutions depuis l'expression régulière. Les substitutions sont représentées par « `\<numéro>` » où <numéro> correspond au sous-motif entre parenthèses ou 0 pour le texte complet.

Par exemple, dans le simple motif « `bug #(123)` » il est possible d'utiliser « `\0` » pour le texte « bug #123 » et « `\1` » pour le texte « 123 ». Pour la commande « `exo-open http://host/\1` », la vraie commande exécutée serait « `exo-open http://host/123` ».

### Xfconf

Clipman utilise Xfconf pour stocker ses paramètres. Ceci vous donne la possibilité de changer un paramètre avec l'outil `xfconf-query` ou `xfce4-settings-editor`. Le canal est `xfce4-panel` et la propriété de base est `/plugins/clipman`. Le tableau ci-dessous liste toutes les propriétés avec leurs valeurs possible :

Tableau 2. Propriétés Xfconf

Propriété | Type | Défault | Valeurs
--- | --- | --- | ---
/settings/add-primary-clipboard | bool | false | true pour synchroniser le presse-papier primaire avec le presse-paper par défaut
/settings/enable-actions | bool | false | true pour activer les actions
/settings/history-ignore-primary-clipboard | bool | false | true pour exclure le presse-papier primaire de l'historique
/settings/max-images-in-history | uint | 0 | 0-5 quantité d'images dans l'historique
/settings/max-texts-in-history | uint | 10 | 5-100 quantité de textes dans l'historique
/settings/save-on-quit | bool | true | true pour restaurer l'historique à chaque nouvelle session

Pour modifier un paramètre depuis un terminal lancez la commande :

`xfconf-query -c xfce4-panel -p /plugins/clipman/<property> -s <value>`

## Support

Pour rapporter une anomalie ou une requête utilisez le système de suivi de bogues à l'adresse http://bugzilla.xfce.org/. Si vous avez des questions sur l'usage de ce logiciel, veuillez contacter la liste de diffusion Xfce ou pointez votre client IRC sur irc.freenode.net, joignez le salon de discussion #xfce et demandez pour de l'aide.

## À propos de Clipman

Clipman was written by Eduard Roccatello and then maintained by Nick Schermer. Nowadays it is written by Mike Massonnet (`<mmassonnet@xfce.org>`). Visit the Clipman Web site.

This documentation was written by Mike Massonnet (`<mmassonnet@xfce.org>`). Please send all your comments and suggestions regarding this manual to `<mmassonnet@xfce.org>`.

This software is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.