Používání zásuvných modulů v aplikaci Kupfer.

# Jak nastavit zásuvné moduly

Funkcionalita v aplikaci Kupfer je dána rozšiřujícími moduly nazývanými „zásuvné moduly“. Každý zásuvný modul funkcionalitu nějakým způsobem doplňuje, například integrací externí aplikace.

# Nastavování zásuvných modulů

## Otevřete Předvolby Kupfer na kartě Zásuvné moduly

Použijte jeden z následujících postupů:

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

.

Vyhledejte objekt Předvolby Kupfer přímo v aplikaci Kupfer. Zmáčknutím Enter jej pak otevřete.

Použijte klávesovou zkratku Ctrl;

Vyberte kartu Zásuvné moduly

Vyberte zásuvný modul v seznamu a můžete si o něm přečíst informace. Zaškrtnutím políčka vedle jeho názvu jej můžete aktivovat, zrušením zaškrtnutí deaktivovat.

Pokud má zásuvný modul nějaké parametry nastavení, budou zobrazeny pod informacemi o něm.

Zásuvný modul Zásuvné moduly Kupfer umožňuje rychlý přístup k informační stránce jednotlivých zásuvných modulů. Nabízí i akci „Zobrazit zdrojový kód“, která prozradí, jak je implementován.

# Když nejde zásuvný modul aktivovat

Když aktivace zásuvného modulu selže, protože vyžaduje softwarový modul, který není dostupný, zobrazí se informace v podobě takovéto zprávy:

Plugin could not be read due to an error:

Python module 'gdata' is needed

Znamená to, že potřebujete nainstalovat požadovaný modul jazyka Python ve své distribuci – a jak na to vám snad poradí dokumentace k zásuvnému modulu.

Zásuvný modul může také neočekávaně selhat při načítání a zobrazit jinou chybovou zprávu. Může se jednat o programovou chybu buď v zásuvném modulu nebo aplikaci Kupfer.

# Instalace dalších zásuvných modulů

Vlastní zásuvné moduly můžete instalovat do složky `~/.local/share/kupfer/plugins`. Každý zásuvný modul má podobu buď jediného souboru `.py` nebo balíčku python (složka která přímo obsahuje soubor s názvem `__init__.py`). Zásuvné moduly ve formátu balíčku mohou zahrnovat soubory ikon. Balíčky python mohou být instalovány také v podobě souborů `.zip`.

Varování: Přistupujte k zásuvným modulům jako k jiným počítačovým programům. Neinstalujte neověřené zásuvné moduly.

# Vytváření zásuvných modulů

Dokumentace pro autory zásuvných modulů je dostupná v souboru `Documentation/Manual.rst` ve zdrojových kódech na webové stránce Příručka aplikace Kupfer. Nejjednodušší způsob, jak začít, je zkopírovat existující zásuvný modul a experimentovat s ním.

# Karta Katalog v předvolbách

Každý zásuvný modul může exportovat řadu zdrojů, které obsahují objekty. Normálně jsou všechny tyto objekty přímo přístupné z nejvyšší úrovně hledání. Některé zásuvné moduly jsou příliš specializované nebo obsahují příliš mnoho objektů na to, aby bylo vhodné exportovat jejich objekty do nejvyšší úrovně. Abyste se k jejich objektům dostali, musíte nejprve podle názvu vyhledat katalog a pak do něj vstoupit pomocí akce Prohledat obsah.

Na kartě Katalog v Předvolbách Kupfer najdete u každého zdroje zaškrtávací políčko. Zaškrtnuté znamená, že jeho objekty jsou exportovány, nezaškrtnuté, že jeho obsah je pro nejvyšší úroveň skryt.

Poznámka: Když jsou do nejvyšší úrovně exportovány opravdu rozsáhlé katalogy, může se Kupfer zpomalit.