Utiliser des greffons avec Kupfer.

# Configuration des greffons

Les fonctions de Kupfer sont organisées en modules d'extensions appelés « greffons » ou « extensions » ou encore « plugins ». Chaque greffon fournit une fonction supplémentaire, par exemple l'intégration dans une application externe.

# Configuration des greffons

## Ouverture des Préférences de Kupfer à l'onglet « Greffons ».

Utilisez l'une des méthodes suivantes :

Click the Kupfer icon in the notification area and select the item Preferences

.

Recherchez l'objet Préférences de Kupfer dans Kupfer lui-même. Appuyez sur Entrée pour l'ouvrir.

Utilisez le raccourci clavier Ctrl;

Sélectionnez l'onglet Extensions

Sélectionnez un greffon dans la liste pour afficher les informations le concernant et cochez la case adjacente pour l'activer. Décochez la case pour le désactiver.

Si le greffon possède des paramètres, ils sont visibles en dessous des informations concernant le greffon.

Le greffon Greffons Kupfer permet un accès rapide à chaque page d'informations sur les greffons ainsi qu'à l'action « Afficher le code source » qui laisse voir la mise en œuvre.

# Impossibilité d'activer un greffon

Si l'activation d'un greffon échoue à cause de l'absence d'un module logiciel, les informations du greffon affichent un message de ce type :

Plugin could not be read due to an error:

Python module 'gdata' is needed

Cela signifie que vous devez installer un module python indispensable en fonction de votre distribution. La documentation du greffon vous indiquera probablement comment procéder.

Le chargement du greffon peut aussi échouer de façon inattendue et afficher un message d'erreur différent. Il peut s'agir d'une erreur de programme dans le greffon ou dans Kupfer.

# Installation de greffons supplémentaires

Vous pouvez installer des greffons personnalisés dans le dossier `~/.local/share/kupfer/plugins`. Chaque greffon est soit un simple fichier `.py`, soit un paquet Python (un dossier contenant un fichier appelé `__init__.py`). Les greffons sous forme de paquet peuvent inclure des fichiers d'icônes. Les paquets Python peuvent même être installés en tant que fichiers `.zip`.

Attention : traitez les greffons comme des programmes d'ordinateur. N'installez pas de greffons d'origine douteuse.

# Création de greffons

La documentation pour les créateurs de greffons se trouve dans le fichier `Documentation/Manual.rst` de la distribution source sur la page Web du Manuel de Kupfer. Une manière facile de démarrer est de copier un greffon existant et de s'entraîner avec.

# L'onglet Catalogue dans les Préférences

Chaque greffon peut exporter de nombreuses sources contenant des objets. Normalement, tous ces objets sont directement accessibles par une recherche dans le haut du catalogue. Certains greffons exportent des objets si spécialisés ou si nombreux qu'il vaut mieux qu'ils ne soient pas exportés vers le haut du catalogue. Dès lors, pour atteindre ces objets, vous devez d'abord rechercher le catalogue par son nom, puis l'ouvrir par l'action Recherche de contenu.

Dans l'onglet Catalogue des Préférences de Kupfer, une case cochée à côté de chaque source signifie que ses objets sont exportés. Une case non cochée signifie que son contenu est masqué dans le haut du catalogue.

Note : Kupfer peut ralentir si de trop gros sous-catalogues sont exportés vers le haut du catalogue.