<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="managing-plugins" xml:lang="fr">

  <info>
   <link type="guide" xref="index#usage"/>
   <desc>Utiliser des greffons avec <app>Kupfer</app>.</desc>
  </info>

  <title>Configuration des greffons</title>

  <p>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.</p>

  <section>
    <title>Configuration des greffons</title>
    <steps>
      <title>Ouverture des <app>Préférences de Kupfer</app> à l'onglet « Greffons ».</title>
      <item>
        <p>Utilisez l'une des méthodes suivantes :</p>
        <list>
          <item><p>Click the Kupfer icon in the notification area and select
              the item <em>Preferences</em></p>.
          </item>
          <item>
            <p>Recherchez l'objet <app>Préférences de Kupfer</app> dans Kupfer lui-même. Appuyez sur <key>Entrée</key> pour l'ouvrir.</p>
          </item>
          <item><p>Utilisez le raccourci clavier <keyseq><key>Ctrl</key><key>;</key></keyseq></p>
          </item>
        </list>
      </item>
      <item>
        <p>Sélectionnez l'onglet <em>Extensions</em></p>
      </item>
    </steps>

    <p>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.</p>
    <p>Si le greffon possède des paramètres, ils sont visibles en dessous des informations concernant le greffon.</p>
    <p>Le greffon <app>Greffons Kupfer</app> 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.</p>
  </section>
  <section>
    <title>Impossibilité d'activer un greffon</title>
      <p>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 :</p>
      <p><em>Plugin could not be read due to an error:</em>
      </p><p><em>Python module 'gdata' is needed</em></p>
      <p>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.</p>
      <p>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 <app>Kupfer</app>.</p>
  </section>
  
  <section>
    <title>Installation de greffons supplémentaires</title>
    <p>Vous pouvez installer des greffons personnalisés dans le dossier <code>~/.local/share/kupfer/plugins</code>. Chaque greffon est soit un simple fichier <code>.py</code>, soit un paquet Python (un dossier contenant un fichier appelé <code>__init__.py</code>). 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 <code>.zip</code>.</p>
    <note style="warning">
    <p><em>Attention :</em> traitez les greffons comme des programmes d'ordinateur. N'installez pas de greffons d'origine douteuse.</p>
    </note>
  </section>

  <section>
    <title>Création de greffons</title>
    <p>La documentation pour les créateurs de greffons se trouve dans le fichier <code>Documentation/Manual.rst</code> de la distribution source sur la page Web du <link href="http://kaizer.se/wiki/kupfer/Manual/">Manuel de Kupfer</link>. Une manière facile de démarrer est de copier un greffon existant et de s'entraîner avec.</p>
  </section>
  <section>
    <title>L'onglet <em>Catalogue</em> dans les Préférences</title>
    <p>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 <em>Recherche de contenu</em>.</p>
    <p>Dans l'onglet <em>Catalogue</em> des <app>Préférences de Kupfer</app>, 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.</p>
    <p><em>Note :</em> Kupfer peut ralentir si de trop gros sous-catalogues sont exportés vers le haut du catalogue.</p>
  </section>
</page>
