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

  <info>
   <link type="guide" xref="index#usage"/>
   <desc>Verwendung von Plugins in <app>Kupfer</app>.</desc>
  </info>

  <title>Konfigurieren der Plugins</title>

  <p>
    Functionality in Kupfer is organized by extentsion modules called
    "plugins". Each plugin provides additional functionality, for example
    integration with an external application.
  </p>

  <section>
    <title>Einrichten von Plugins</title>
    <steps>
      <title>Öffnen Sie die <app>Kupfer-Einstellungen</app> und wechseln Sie zum Plugins-Reiter</title>
      <item>
        <p>Verwenden Sie eine der folgenden Methoden:</p>
        <list>
          <item><p>Click the Kupfer icon in the notification area and select
              the item <em>Preferences</em></p>.
          </item>
          <item>
            <p>Suchen Sie nach dem Objekt <app>Kupfer-Einstellungen</app> in Kupfer selbst. Drücken Sie die <key>Eingabetaste</key> zum Öffnen.</p>
          </item>
          <item><p>Verwenden Sie das Tastenkürzel <keyseq><key>Strg</key><key>;</key></keyseq></p>
          </item>
        </list>
      </item>
      <item>
        <p>Wählen Sie den Reiter <em>Plugins</em>.</p>
      </item>
    </steps>

    <p>
      Select plugins in the list to read about them, and tick the box
      next to its name to activate the plugin, or untick to deactivate.
    </p>
    <p>
      If the plugin has any configurable parameters, they will be
      visible below the plugin information.
    </p>
    <p>The plugin <app>Kupfer Plugins</app> allows fast access to each plugin's
      information page as well as the action "Show Source Code" which
      reveals the implementation.
    </p>
  </section>
  <section>
    <title>Wenn ein Plugin nicht aktiviert werden kann</title>
      <p>Falls das Laden eines Plugins scheitert, weil ein bestimmtes benötigtes Softwaremodul nicht verfügbar ist, wird eine Meldung wie die folgende angezeigt:</p>
      <p><em>Plugin could not be read due to an error:</em>
      </p><p><em>Python module 'gdata' is needed</em></p>
      <p>Dies bedeutet, dass Sie ein Python-Modul aus ihrer Distribution installieren müssen. Die Dokumentation des Plugins gibt möglicherweise dazu nähere Auskünfte.</p>
      <p>Das Laden des Plugins könnte auch aus unerwartetem Grund scheitern und eine andere Fehlermeldung anzeigen. Es kann sich dann um einen Programmierfehler entweder im Plugin oder in <app>Kupfer</app> handeln.</p>
  </section>
  
  <section>
    <title>Weitere Plugins installieren</title>
    <p>Sie können benutzerdefinierte Plugins in den Ordner <code>~/.local/share/kupfer/plugins</code> installieren. Jedes Plugin ist entweder eine einzelne <code>.py</code>-Datei oder ein Python-Package (ein Ordner, der direkt eine Datei namens <code>__init__.py</code> enthält). Plugins im Paketformat können Symboldateien enthalten. Python-Pakete können auch als <code>.zip</code>-Dateien installiert werden.</p>
    <note style="warning">
    <p><em>Achtung:</em> Betrachten Sie Plugins als Computerprogramme. Installieren Sie keine Plugins aus Quellen, die nicht vertrauenswürdig sind.</p>
    </note>
  </section>

  <section>
    <title>Plugins erstellen</title>
    <p>
      Documentation for plugin creators is available in the file
      <code>Documentation/Manual.rst</code> in the source distribution on
      the webpage at
      <link href="http://kaizer.se/wiki/kupfer/Manual/">Kupfer Manual</link>.

      An easy way to start is to copy an existing plugin and experimenting
      with it.
    </p>
  </section>
  <section>
    <title>Der <em>Katalog</em>-Reiter in den Einstellungen</title>
    <p>
      Each plugin can export a number of sources which contain objects.
      Normally, all these objects are directly accessible from a top-level
      search.
      Some plugins export so specialized or so many objects that their
      catalogs should better not have their objects exported to the top
      level. To reach those objects, you have to first find the catalog by
      name, then enter the catalog using the action <em>Search
        Contents</em>.
    </p>
    <p>
      In the tab <em>Catalog</em> in <app>Kupfer Preferences</app>, 
      a ticked box next to each source means that its objects are exported.
      An unticked box means that its contents are hidden from the top level.
    </p>
    <p><em>Hinweis:</em> Kupfer kann sehr langsam werden, falls größere Unterkataloge in die oberste Ebene exportiert werden.</p>
  </section>
</page>
