Clipman

This manual describes Clipman version 1.2.0.

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.

Table of Contents

  1. Introduction

  2. Paramètres

  3. Support

  4. À propos de Clipman

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.

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… ».

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 table suivante décrit les options disponibles dans l'onglet Général du Dialogue de paramètres

Options générales
Description des options de l'onglet Général dans le Dialogue de paramètres

Option

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é

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

Ordre inversé

Inverse l'odre de l'historique dans le menu

Taille de l'historique

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

Paramètres de Clipman (Général)
Dialogue de paramètres de l'onglet Général

Paramètres d'une Action

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

Paramètres de Clipman (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.

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

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, certaines ne sont pas disponibles depuis le Dialogue de paramètres

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/reverse-menu-order

bool

false

true ou false pour restaurer l'historique à chaque nouvelle session

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

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 bugzilla.xfce.org. Si vous avez des questions sur l'usage de ce logiciel, veuillez contacter la liste de discussion 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 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 .