Konfigurieren der Plugins

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

Einrichten von Plugins

Öffnen Sie die Kupfer-Einstellungen und wechseln Sie zum Plugins-Reiter

  1. Verwenden Sie eine der folgenden Methoden:

    • Klicken Sie auf das Kupfer-Symbol im Benachrichtigungsfeld und wählen Sie den Eintrag Einstellungen.

    • Suchen Sie nach dem Objekt Kupfer-Einstellungen in Kupfer selbst. Drücken Sie die Eingabetaste zum Öffnen.

    • Verwenden Sie das Tastenkürzel Strg+;

  2. Wählen Sie den Reiter Plugins.

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.

If the plugin has any configurable parameters, they will be visible below the plugin information.

The plugin Kupfer Plugins allows fast access to each plugin's information page as well as the action "Show Source Code" which reveals the implementation.

Wenn ein Plugin nicht aktiviert werden kann

Falls das Laden eines Plugins scheitert, weil ein bestimmtes benötigtes Softwaremodul nicht verfügbar ist, wird eine Meldung wie die folgende angezeigt:

Plugin kann wegen eines Fehlers nicht gelesen werden

Python-Modul »gdata« wird benötigt

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.

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 Kupfer handeln.

Weitere Plugins installieren

Sie können benutzerdefinierte Plugins in den Ordner ~/.local/share/kupfer/plugins installieren. Jedes Plugin ist entweder eine einzelne .py-Datei oder ein Python-Package (ein Ordner, der direkt eine Datei namens __init__.py enthält). Plugins im Paketformat können Symboldateien enthalten. Python-Pakete können auch als .zip-Dateien installiert werden.

Achtung: Betrachten Sie Plugins als Computerprogramme. Installieren Sie keine Plugins aus Quellen, die nicht vertrauenswürdig sind.

Plugins erstellen

Documentation for plugin creators is available in the file Documentation/Manual.rst in the source distribution on the webpage at Kupfer Manual. An easy way to start is to copy an existing plugin and experimenting with it.

Der Katalog-Reiter in den Einstellungen

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 Search Contents.

In the tab Catalog in Kupfer Preferences, 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.

Hinweis: Kupfer kann sehr langsam werden, falls größere Unterkataloge in die oberste Ebene exportiert werden.