# &basket; priročnik

## OBVESTILO: priročnik še ni napisan

&basket; še vedno nima priročnika, zato so sodelujoči dobrodošli! Preverite dokumentacijo KDE za namige o formatu DocBook.

Medtem lahko pomoč poiščete na internetu. Še posebej si oglejte staro spletno stran ali preverite revije za Linux, če imate dostop do njih, na primer:

- Vadnica: Basket: Zajemite svoje misli. Linux Format 120 (Andy Channelle)

- Virtualna košarica. Shranjevanje, razvrščanje in arhiviranje s KDE's Basket Revija Linux 54 (Stefanie Teufel)

## Uvod

&basket; je večinoma večnamenski zapisovalnik, vendar še posebej:

## Uporaba Basket-a

### Sinhronizacija različice

Ko je omogočeno, Version Sync postavi vaše košarice in opombe pod nadzor različic. Trenutno je to poskusna funkcija in izvajajo se samo zelo osnovne funkcije, zato bo morda zahtevala dodatno programsko opremo in nekaj ročnih nastavitev. To je nekaj stvari, ki jih je mogoče narediti z zunanjimi orodji (vendar še ne z vmesnikom Basket):

- preverite stare revizije in razveljavite spremembe

- sinhronizacija košaric na več računalnikih (spojitev sprememb)

- potisni varnostno kopijo košaric v oddaljeno skladišče

Če ga želite omogočiti, izberite Nastavitve Konfiguriraj beležnice BasKet → Sinhronizacija različic in Omogoči porazdeljeni nadzor različic. Inicializiral bo repozitorij git v `~/.kde/share/apps/basket/baskets`, pri čemer je mogoče uporabiti standardna orodja git.

#### Čiščenje zgodovine različic

Brisanje zgodovine je lahko koristno v teh primerih:

- ste zaklenili košarico in želite odstraniti vse prejšnje nešifrirane različice (ki so še vedno shranjene v sistemu)

- želite sprostiti nekaj prostora na disku (lahko je aktualno, če v košarico vstavljate veliko slik ali drugih datotek)

Upoštevajte, da boste morali ponoviti vse ročne nastavitve, ki ste jih izvedli v repozitoriju git.

## Struktura datoteke Basket

### Uvod

### Format datoteke Basket Archive

Datotečni format BasKet (.baskets) je struktura, ki ovije stisnjen tar in sliko predogleda. Najnovejša različica zapisa arhiva je 0.6.1.

#### Struktura datoteke

Arhivska datoteka je razdeljena na strukture: glava datoteke, glava slike za predogled, slika za predogled (.png), glava arhiva in arhiviran arhiv tar (.tar.gz), ki vsebuje drevo datotek košaric, kot je prikazano na naslednji skici

#### Glava arhivske datoteke

Glava datoteke je kratka struktura, sestavljena iz vrstic nizov, deklaratorja datoteke in različice formata

Prvih 17 bajtov vsebuje dobesedni niz `BasKetNP:archive`, ki mu sledi nov simbol za pomik vrstice (0x0A) v kodiranju ISO-8859-1.

Drugi niz je dobesedni niz `version:0.6.1`, ki mu sledi simbol za pomik vrstice (0x0A) v kodiranju ISO-8859-1.

Primer:

    BasKetNP:archive
    version:0.6.1

#### Predogled glave slike

Trenutno arhivska datoteka košarice vsebuje datoteko predogleda, ki izhaja iz vsebine prve košarice.

Neposredno za glavo datoteke dobesedni niz `preview*:<size>` v kodiranju ISO-8859-1, ki mu spet sledi simbol za pomik vrstice. Parameter `<size>` je niz decimalnih števil. Deklarira velikost predogledne slike v bajtih. `<size>` je vrste unsigned long.

Primer:

    preview*:12000

#### Predogled slikovne datoteke

Slika za predogled je vrste .png. Njena velikost je določena z glavo predogleda slike. Datoteka s sliko za predogled je vstavljena kot tok datoteke in neposredno sledi glavi slike za predogled.

#### Glava arhiva vsebine Basket

Tako kot pri slikovni datoteki za predogled je pred arhivom vsebine niz, ki določa njegovo velikost. Ta niz neposredno sledi datotečnemu toku arhiva.

Ta niz mora biti `archive*:<size>`, ki mu sledi simbol za pomik vrstice, v kodiranju ISO-8869-1. Parameter `<size>` je nepredznačeno dolgo celo število v obliki niza.

Primer:

    archive*:1245000

#### Arhiv vsebin Basket

Arhiv vsebine vsebuje datotečno drevo BasKet, stisnjeno v gzipiran arhiv tar (.tar.gz). Njegova velikost je določena z glavo vsebine.

#### Primer toka bajtov

Naslednja tabela prikazuje ključne dele vsebine arhivske datoteke košarice. Levi stolpec določa odmik v toku datoteke. Sredinski stolpec podaja tok bajtov pri trenutnem odmiku v šestnajstiški obliki. Desni stolpec prikazuje natisljive znake znotraj toka datoteke pri trenutnem odmiku.

## Vprašanja, odgovori in nasveti

## Pogosto zastavljena vprašanja

Vprašanje 1

Odgovor