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

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

    • Klikněte na ikonu Kupfer v oznamovací oblasti a vyberte položku Předvolby

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

    • Použijte klávesovou zkratku Ctrl+;

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

Zásuvný modul nemohl být načten kvůli výskytu chyby:

Je zapotřebí modul Python „gdata“

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.