# Clipman

This manual describes Clipman version 1.2.2.

Last edited: 2011-11-01.

La permission vous est donnée de copier, distribuer et / ou modifier ce document selon les termes de la licence GNU Free Documentation License, Version 1.3 ou toute version ultérieure publiée par la Free Software Foundation sans section invariante, sans texte de première de couverture, et sans texte de couverture. Le texte de la licence complète est disponible sur le Free Software Foundation.

## 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

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.

Menu avec l'historique
Montre le menu qui est affiché suite à un clic sur l'icône Clipman dans le Panneau Xfce ou la zone de notification

Il y a deux manières pour exécuter Clipman. Vous pouvez sélectionner Clipman dans le menu des applications sous la catégorie Accessoires 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 des greffons… ».

### 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.

## Dialogue de 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.

### Paramètres généraux

La liste suivante décrit les options disponibles dans l'onglet Général du Dialogue de paramètres

Liste des paramètres généraux disponibles

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é.

Sauvegarder avant de quitter

  Conserve l'historique à chaque nouvelle session.

Stocker la dernière image copiée

  Autorise le stockage d'une image dans l'historique.

Ignorer les sélections

  Empêche les éléments du presse-papier primaire d'apparaître dans l'historique.

Taille de l'historique

  Définit le nombre d'éléments à conserver dans l'historique.

Paramètres généraux
Dialogue de paramètres de l'onglet Général

### Paramètres des 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.

To learn more about actions go to the next section.

Paramètres des actions
Dialogue de paramètres avec l'onglet Actions

#### 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).

Dialogue d'action
Dialogue de paramètres qui montre le Dialogue d'action lors de la création ou la modification d'une 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 d'expressions régulières

- « 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.

Ressources externes

- Article Wikipedia sur les expressions régulières

##### Commandes

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, avec le simple motif « bug #(123) » il est possible d'utiliser « \0 » pour le texte « bug #123 » et « \1 » pour le : texte « 123 ». Avec la commande « exo-open http://host/\1 », la vraie commande exécutée serait « exo-open http://host/123 ».

### Peaufinage

La liste suivante décrit les options disponibles dans l'onglet Peaufinage du Dialogue de paramètres

Liste de peaufinage disponible

Coller intantanément

  Automatiquement coller l'élément sélectionné de l'historique dans la fenêtre actuelle.

Positionner le menu au pointeur de la souris

  Afficher le menu au niveau du pointeur de la souris, fonctionne uniquement depuis la commande xfce4-popup-clipman.

Réordonner les éléments de l'historique

  Placer le dernier texte copié au haut de l'historique, pratique pour conserver les anciens éléments.

Ordre inversé

  Inverse l'odre de l'historique dans le menu.

Ignorer les actions en pressant Ctrl

  Lorsque la sélection est terminée (souris ou clavier) et que la touche Ctrl est encore enfoncée, le menu des actions n'est pas affiché.

Peaufinage
Dialogue de paramètres de l'onglet Peaufinage

### 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 où Clipman stocke ses données 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 :

Propriétés Xfconf
Description de toutes les propriétés Xfconf avec leurs valeurs

Propriété | Type | Défault | Valeurs
/settings/add-primary-clipboard | bool | false | true ou false pour synchroniser le presse-papier primaire avec le presse-paper par défaut
/settings/enable-actions | bool | false | true ou false pour activer les actions
/settings/history-ignore-primary-clipboard | bool | false | true ou false 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 number of texts in history
/settings/save-on-quit | bool | true | true ou false pour restaurer l'historique à chaque nouvelle session
/tweaks/inhibit | bool | false | true ou false pour désactiver le collecteur
/tweaks/paste-on-activate | uint | 0 | 0 pour désactiver, 1 pour coller avec Ctrl+V, ou 2 pour coller avec Shift+Insert dès qu'un élément est sélectionné dans l'historique
/tweaks/popup-at-pointer | bool | false | true ou false pour afficher le menu au niveau du pointeur de la souris, fonctionne uniquement depuis la commande xfce4-popup-clipman
/tweaks/reorder-items | bool | true | true ou false pour remonter le dernier texte copié au haut de l'historique, pratique pour conserver les anciens éléments
/tweaks/reverse-menu-order | bool | false | true ou false pour restaurer l'historique à chaque nouvelle session
/tweaks/skip-action-on-key-down | bool | false | true ou false pour outrepasser les actions lorsque la touche Controle est maintenue à la fin de la sélection

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

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

## Support

To report a bug or a feature request use the bug tracking system at bugzilla.xfce.org. If you have questions about the use of this software, please ask on the Xfce mailing list, or point your IRC client to irc.freenode.net and join the channel #xfce and ask for help.

## À propos de Clipman

Clipman a été écrit par Eduard Roccatello puis maintenu par Nick Schermer, et aujourd'hui il est écrit par Mike Massonnet. Visitez le site web Clipman.

Cette documentation a été écrite par Mike Massonnet (mmassonnet@xfce.org). S'il vous plaît envoyer tous vos commentaires et suggestions à propos de ce manuel.

Ce logiciel est distribué sous les termes de la GNU General Public License telle que publiée par la Free Software Foundation; soit la version 2 de la Licence, ou (à votre choix) toute version ultérieure.

Vous devriez avoir reçu une copie de la GNU General Public License avec ce programme; sinon, écrivez à la Free Software Foundation, Inc, 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA .

Copyright © 2009, 2011 Mike Massonnet
Translation © 2009, 2011 Mike Massonnet