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

  1. Uporabite enega od naslednjih načinov:

    • Kliknite na ikono Kupfer v obvestilnem področju in izberite predmet Možnosti

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

    • Uporabite tipkovno bližnjico Ctrl+;

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

Vstavka ni mogoče prebrati zaradi napake:

Zahtevan je modul Python 'gdata'

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.