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

  <info>
   <link type="guide" xref="index#usage"/>
   <desc>Uporaba vtavkov v programu <app>Kupfer</app>.</desc>
  </info>

  <title>Kako nastaviti vstavke</title>

  <p>Zmožnost v Kupferju je organizirana po modulih razširitev, ki se imenujejo "vstavki". Vsak vstavek zagotavlja dodatno zmožnost na primer vključitev v zunanji program.</p>

  <section>
    <title>Nastavljanje vstavkov</title>
    <steps>
      <title>Odprite zavihek Vstavki v <app>Možnostih Kupfer</app></title>
      <item>
        <p>Uporabite enega od naslednjih načinov:</p>
        <list>
          <item><p>Kliknite na ikono Kupfer v obvestilnem področju in izberite predmet <em>Možnosti</em></p>.</item>
          <item>
            <p>Iščite predmet <app>Možnosti Kupfer</app> v Kupferju. Pritisnite <key>Enter</key> za odprtje.</p>
          </item>
          <item><p>Uporabite tipkovno bližnjico <keyseq><key>Ctrl</key><key>;</key></keyseq></p>
          </item>
        </list>
      </item>
      <item>
        <p>Izberite zavihek <em>Vstavki</em></p>
      </item>
    </steps>

    <p>Izberite vstavke s seznama za branje o njih in izberite polje poleg njegovega imena za njegovo omogočitev ali oznako odstranite za onemogočitev.</p>
    <p>V primeru da ima vstavek nastavljive parametre, bodo vidni pod podatki o vstavku.</p>
    <p>Vstavek <app>Vstavki Kupfer</app> omogoča hiter dostop do strani s podatki o vstavkih kot tudi do dejanja "Pokaži izvorno kodo", ki prikaže izvedbo.</p>
  </section>
  <section>
    <title>V primeru da vstavka ni mogoče omogočiti</title>
      <p>V primeru da vstavka ni mogoče omogočiti, ker zahteva programski modul, ki ni na voljo, bodo podatki o vstavku prikazali sporočilo kot je:</p>
      <p><em>Vstavka ni mogoče prebrati zaradi napake:</em>
      </p><p><em>Zahtevan je modul Python 'gdata'</em></p>
      <p>To pomeni, da morate namestiti zahtevan modul python s svoje distribucije -- morda vam dokumentacija vstavka lahko pove kako.</p>
      <p>Nalaganje vstavka lahko tudi nepričakovano spodleti in prikaže durgačno sporočilo o napaki. To je lahko programska napaka v vstavku ali v <app>Kupferju</app>.</p>
  </section>
  
  <section>
    <title>Nameščanje več vstavkov</title>
    <p>Vstavke po meri lahko namestite v mapo <code>~/.local/share/kupfer/plugins</code>. Vsak vstavek je ena datoteka <code>.py</code> ali paket python (mapa, ki vsebuje datoteko z imenom <code>__init__.py</code>). Vstavki v obliki paketa lahko vključujejo datoteke ikone. Pakete Python lahko namestite tudi kot datoteke <code>.zip</code>.</p>
    <note style="warning">
    <p><em>Pozor:</em> Vstavek obravnavajte kot računalniški program. Vstavkov, ki jim ne zaupajte, ne nameščajte.</p>
    </note>
  </section>

  <section>
    <title>Ustvarjanje vstavkov</title>
    <p>Dokumentacija za ustvarjalce vstavkov je na voljo v datoteki <code>Documentation/Manual.rst</code> v izvorni distribuciji na spletni strani <link href="http://kaizer.se/wiki/kupfer/Manual/">priročnika Kupfer</link>. Enostaven način za začetek je kopiranje obstoječega vstavka in njegovo preizkušanje.</p>
  </section>
  <section>
    <title>Zavihek <em>Katalog</em> v možnostih</title>
    <p>Vsak vstavek lahko izvozi številne vire, ki vsebujejo predmete. Običajno lahko do teh predmetov dostopate neposredno iz iskanja vrhne ravni. Nekateri vstavki izvozijo specializirane ali tako veliko predmetov, da je boljše, da njihovi katalogi predmetov ne izvažajo na vrhnjo raven. </p>
    <p>V zavihku <em>Katalog</em> v <app>Možnostih Kupfer</app> je poleg vsakega vira izbrano polje, ki pomeni, da so njegovi predmeti izvoženi. Neizbrano polje pomeni, da je vsebina na vrhnji ravni skrita.</p>
    <p><em>Opomba:</em> Kupfer lahko postane počasen, če v vrhnjo raven izvozite dovolj velike podkataloge.</p>
  </section>
</page>
