Uporaba vtavkov v programu Kupfer.

# Kako nastaviti vstavke

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.

# Nastavljanje vstavkov

## Odprite zavihek Vstavki v Možnostih Kupfer

Uporabite enega od naslednjih načinov:

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

.

Iščite predmet Možnosti Kupfer v Kupferju. Pritisnite Enter za odprtje.

Uporabite tipkovno bližnjico Ctrl;

Izberite zavihek Vstavki

Izberite vstavke s seznama za branje o njih in izberite polje poleg njegovega imena za njegovo omogočitev ali oznako odstranite za onemogočitev.

V primeru da ima vstavek nastavljive parametre, bodo vidni pod podatki o vstavku.

Vstavek Vstavki Kupfer omogoča hiter dostop do strani s podatki o vstavkih kot tudi do dejanja "Pokaži izvorno kodo", ki prikaže izvedbo.

# V primeru da vstavka ni mogoče omogočiti

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:

Plugin could not be read due to an error:

Python module 'gdata' is needed

To pomeni, da morate namestiti zahtevan modul python s svoje distribucije -- morda vam dokumentacija vstavka lahko pove kako.

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 Kupferju.

# Nameščanje več vstavkov

Vstavke po meri lahko namestite v mapo `~/.local/share/kupfer/plugins`. Vsak vstavek je ena datoteka `.py` ali paket python (mapa, ki vsebuje datoteko z imenom `__init__.py`). Vstavki v obliki paketa lahko vključujejo datoteke ikone. Pakete Python lahko namestite tudi kot datoteke `.zip`.

Pozor: Vstavek obravnavajte kot računalniški program. Vstavkov, ki jim ne zaupajte, ne nameščajte.

# Ustvarjanje vstavkov

Dokumentacija za ustvarjalce vstavkov je na voljo v datoteki `Documentation/Manual.rst` v izvorni distribuciji na spletni strani priročnika Kupfer. Enostaven način za začetek je kopiranje obstoječega vstavka in njegovo preizkušanje.

# Zavihek Katalog v možnostih

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.

V zavihku Katalog v Možnostih Kupfer je poleg vsakega vira izbrano polje, ki pomeni, da so njegovi predmeti izvoženi. Neizbrano polje pomeni, da je vsebina na vrhnji ravni skrita.

Opomba: Kupfer lahko postane počasen, če v vrhnjo raven izvozite dovolj velike podkataloge.