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

  1. Utilisez l'une des méthodes suivantes :

    • Cliquez sur l'icône « Kupfer » dans la zone de notification et sélectionnez l'élément Préférences

    • 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+;

  2. 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 :

Le greffon n'a pas pu être lu à cause d'une erreur :

Le module Python « gdata » est requis

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.