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

  <info>
   <link type="guide" xref="index#usage"/>
   <desc>Používání zásuvných modulů v aplikaci <app>Kupfer</app>.</desc>
  </info>

  <title>Jak nastavit zásuvné moduly</title>

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

  <section>
    <title>Nastavování zásuvných modulů</title>
    <steps>
      <title>Otevřete <app>Předvolby Kupfer</app> na kartě Zásuvné moduly</title>
      <item>
        <p>Použijte jeden z následujících postupů:</p>
        <list>
          <item><p>Klikněte na ikonu Kupfer v oznamovací oblasti a vyberte položku <em>Předvolby</em></p>.</item>
          <item>
            <p>Vyhledejte objekt <app>Předvolby Kupfer</app> přímo v aplikaci Kupfer. Zmáčknutím <key>Enter</key> jej pak otevřete.</p>
          </item>
          <item><p>Použijte klávesovou zkratku <keyseq><key>Ctrl</key><key>;</key></keyseq></p>
          </item>
        </list>
      </item>
      <item>
        <p>Vyberte kartu <em>Zásuvné moduly</em></p>
      </item>
    </steps>

    <p>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.</p>
    <p>Pokud má zásuvný modul nějaké parametry nastavení, budou zobrazeny pod informacemi o něm.</p>
    <p>Zásuvný modul <app>Zásuvné moduly Kupfer</app> 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.</p>
  </section>
  <section>
    <title>Když nejde zásuvný modul aktivovat</title>
      <p>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:</p>
      <p><em>Zásuvný modul nemohl být načten kvůli výskytu chyby:</em>
      </p><p><em>Je zapotřebí modul Python „gdata“</em></p>
      <p>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.</p>
      <p>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 <app>Kupfer</app>.</p>
  </section>
  
  <section>
    <title>Instalace dalších zásuvných modulů</title>
    <p>Vlastní zásuvné moduly můžete instalovat do složky <code>~/.local/share/kupfer/plugins</code>. Každý zásuvný modul má podobu buď jediného souboru <code>.py</code> nebo balíčku python (složka která přímo obsahuje soubor s názvem <code>__init__.py</code>). Zásuvné moduly ve formátu balíčku mohou zahrnovat soubory ikon. Balíčky python mohou být instalovány také v podobě souborů <code>.zip</code>.</p>
    <note style="warning">
    <p><em>Varování:</em> Přistupujte k zásuvným modulům jako k jiným počítačovým programům. Neinstalujte neověřené zásuvné moduly.</p>
    </note>
  </section>

  <section>
    <title>Vytváření zásuvných modulů</title>
    <p>Dokumentace pro autory zásuvných modulů je dostupná v souboru <code>Documentation/Manual.rst</code> ve zdrojových kódech na webové stránce <link href="http://kaizer.se/wiki/kupfer/Manual/">Příručka aplikace Kupfer</link>. Nejjednodušší způsob, jak začít, je zkopírovat existující zásuvný modul a experimentovat s ním.</p>
  </section>
  <section>
    <title>Karta <em>Katalog</em> v předvolbách</title>
    <p>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 <em>Prohledat obsah</em>.</p>
    <p>Na kartě <em>Katalog</em> v <app>Předvolbách Kupfer</app> 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.</p>
    <p><em>Poznámka:</em> Když jsou do nejvyšší úrovně exportovány opravdu rozsáhlé katalogy, může se Kupfer zpomalit.</p>
  </section>
</page>
