# El manual del &basket;

## AVÍS: Encara no s'ha escrit el manual

El &basket; encara no té el manual, per tant, donem la benvinguda a col·laboradors! Reviseu la documentació de KDE per a trobar consells sobre el format DocBook.

Mentrestant, podeu buscar ajuda a Internet. En particular, doneu una ullada al lloc web antic o consulteu les revistes del Linux si hi teniu accés, per exemple:

- «Tutorial: Basket: Capture your thoughts» Linux Format 120 (Andy Channelle)

- «A Virtual Basket. Storing, sorting, and filing with KDE's Basket» Linux Magazine 54 (Stefanie Teufel)

## Introducció

El &basket; és principalment per a prendre tota mena de notes, però una en particular:

## Ús del BasKet

### Sincronització de versions

Quan està activat, la sincronització de versions posa les vostres cistelles i notes sota un control de versió. Actualment es tracta d'una característica experimental i només s'implementen funcions molt bàsiques, per la qual cosa pot requerir programari addicional i alguna configuració manual. Aquestes són algunes de les coses que es poden fer utilitzant eines externes (però encara no estan a la interfície de Basket):

- extreure revisions antigues i revertir els canvis

- sincronitzar cistelles en diversos ordinadors (fusiona els canvis)

- pujar còpies de seguretat de les cistelles a repositoris remots

Per a activar-lo, seleccioneu Configuració Configura els quaderns de notes del BasKet → Sincronitza la versió i Activa el control de versions distribuïdes. Inicialitzarà el repositori «git» a `~/.kde/share/apps/basket/baskets`, sobre el qual es poden utilitzar les eines estàndard del «git».

#### Neteja de l'historial de versions

Netejar l'historial pot ser útil en aquests casos:

- heu bloquejat una cistella i voleu eliminar qualsevol versió sense encriptar anterior (que encara s'emmagatzema al sistema)

- voleu alliberar una mica d'espai en disc (pot ser important si inseriu moltes imatges o altres fitxers al Basket)

Tingueu en compte que haureu de refer qualsevol configuració manual que hàgiu fet al repositori «git».

## Estructura del fitxer BasKet

### Introducció

### Format de fitxer d'arxiu BasKet

El format de fitxer BasKet (.baskets) és una estructura que embolcalla un «tar» comprimit i una imatge de vista prèvia. La darrera versió del format d'arxiu és 0.6.1.

#### Estructura de fitxers

El fitxer d'arxiu es divideix en les estructures: capçalera de fitxer, una capçalera d'imatge de vista prèvia, una imatge de vista prèvia (.png), una capçalera d'arxiu i un arxiu «tar» comprimit amb «gunzip» (.tar.gz) que conté un arbre de fitxers de cistelles com s'il·lustra en l'esbós següent

#### Capçalera del fitxer d'arxiu

La capçalera del fitxer és una estructura curta, que consisteix en línies de cadenes, el declarador del fitxer i la versió del format

Els primers 17 bytes contenen la cadena literal `BasKetNP:archive` seguida d'un símbol de línia nova (0x0A) en la codificació ISO-8859-1.

La segona cadena és una cadena literal `versió:0.6.1` seguida d'un símbol de línia nova (0x0A) en la codificació ISO-8859-1.

Un exemple:

    BasKetNP:archive
    version:0.6.1

#### Capçalera de la imatge de vista prèvia

Actualment, el fitxer d'arxiu de la cistella conté un fitxer de vista prèvia que es deriva del primer contingut de la cistella.

Seguint directament la capçalera del fitxer, una cadena literal `preview*:<size>` en la codificació ISO-8859-1, de nou seguida d'un símbol de línia nova. El paràmetre `<size>` és una cadena de nombres decimals. Declara la mida en bytes de la imatge de vista prèvia. `<size>` és de tipus llarg sense signe.

Un exemple:

    preview*:12000

#### Fitxer d'imatge de la vista prèvia

La imatge de vista prèvia és del tipus «.png». La seva mida s'especifica a la capçalera de la vista prèvia de la imatge. El fitxer d'imatge de vista prèvia s'insereix com a flux de fitxers, i segueix directament la capçalera de la imatge de vista prèvia.

#### Capçalera d'arxiu de contingut del BasKet

Igual que per al fitxer d'imatge de vista prèvia, l'arxiu de contingut està precedit per una cadena que especifica la seva mida. Aquesta cadena segueix directament el flux de fitxers de l'arxiu.

Aquesta cadena ha de ser `archive*:<size>` seguida d'un símbol de línia nova en la codificació ISO-8869-1. El paràmetre `<size>` és un enter llarg sense signe en format de cadena.

Un exemple:

    archive*:1245000

#### Arxiu de contingut del BasKet

L'arxiu de contingut conté l'arbre de fitxers BasKet comprimit a un arxiu «tar» comprimit amb «gzip» (.tar.gz). La seva mida s'especifica a la capçalera de contingut.

#### Exemple de flux de bytes

La taula següent mostra les parts clau del contingut del fitxer d'arxiu «basket». La columna esquerra especifica el desplaçament en el flux de fitxers. La columna central dona el flux de bytes en el desplaçament actual en format hexadecimal. La columna dreta mostra els caràcters imprimibles dins del flux de fitxers en el desplaçament actual.

## Preguntes, respostes i consells

## Preguntes més freqüents

Pregunta 1

La resposta