# Het handboek van &basket;

## OPMERKING: handboek nog niet geschreven

&basket; heeft nog steeds geen handboek, dus zijn medewerkers welkom! Bekijk de KDE documentatie voor de tips over het DocBook-format.

Ondertussen kunt u op het internet zoeken naar hulp. Zoek speciaal in de oude website of, bijvoorbeeld, kijk in Linux magazines als u er toegang toe hebt:

- Inleiding: Basket: vang uw gedachten. Linux Format 120 (Andy Channelle)

- Een virtuele mand. Opslaan, sorteren en vullen met KDE's Basket Linux Magazine 54 (Stefanie Teufel)

## Inleiding

&basket; is hoofdzakelijk een maker voor notities, maar een speciale:

## BasKet gebruiken

### Versiesynchronisatie

Indien ingeschakeld zet Version Sync uw mandjes en notities onder versiecontrole. Dit is nu een experimentele functie en alleen erg basis functies zijn geïmplementeerd, het kan dus extra software en enig handmatig opzetten vereisen. Dit zijn enige van de dingen die gedaan kunnen worden met externe hulpmiddelen (maar nog geen Basket interface):

- bekijk oude revisies en draai de wijzigingen terug

- synchroniseer mandjes op verschillende computers (merg de wijziging)

- verstuur reservekopieën van mandjes naar opslagruimte op afstand

Om het in te schakelen, selecteer Instellingen Notepads van BasKet configureren → Synchronisatie van versie en Gedistribueerde controle op versie inschakelen. Het zal de git-opslagruimte initialiseren in `~/.kde/share/apps/basket/baskets`, waarop standaard git-hulpmiddelen gebruikt kunnen worden.

#### Versiegeschiedenis wordt gewist

Versiegeschiedenis wissen kan in deze gevallen nuttig zijn:

- u hebt een mandje vergrendeld en wilt elke vorige niet versleutelde versies verwijderen (die nog steeds in het systeem zijn opgeslagen)

- u wilt enige schijfruimte vrij maken (kan nodig zijn als u heel wat afbeeldingen of andere bestanden in Basket hebt opgeslagen)

Merk op dat u elke handmatige opzet opnieuw moet doen die deed op de git-opslagruimte.

## Bestandsstructuur van BasKet

### Inleiding

### Bestandsformaat van BasKet-archief

Het bestandsformaat van BasKet (.baskets) is een structuur die een gecomprimeerde tar en een voorbeeldafbeelding inpakt. De laatste versie van het archiefformaat is 0.6.1.

#### Bestandsstructuur

Het archiefbestand is opgedeeld in de structuren: bestandskop, voorbeeldafbeeldingkop, een voorbeeldafbeelding (.png), archiefkop en een gunzipped tar-archief (.tar.gz) een boomstructuur van basketbestanden bevat zoals geïllustreerd in de volgende schets

#### Archiefbestandskop

De bestandskop is een korte structuur, bestaande uit regels van tekenreeksen, de bestandsdeclarator en de versie van het formaat

De eerste 17 bytes bevatten de letterlijke tekenreeks `BasKetNP:archive` gevolgd door een symbool nieuwe-regel (0x0A) in ISO-8859-1 codering.

De tweede tekenreeks de letterlijke tekenreeks `version:0.6.` gevolgd door een symbool nieuwe-regel (0x0A) in ISO-8859-1 codering.

Een voorbeeld:

    BasKetNP:archive
    version:0.6.1

#### Voorbeeldafbeeldingskop

Op dit moment bevat het basket-archiefbestand een voorbeeldbestand die is afgeleid uit de inhoud van het eerste mandje.

Direct na de bestandskop een letterlijke tekenreeks `preview*:<size>` in ISO-8859-1 codering, opnieuw gevolgd door een symbool nieuwe-regel. De parameter `<size>` is een tekenreeks van decimale cijfers. Het geeft de grootte in bytes van de voorbeeldafbeelding. `<size>` is van het type lang zonder teken.

Een voorbeeld:

    preview*:12000

#### Voorbeeldafbeeldingsbestand

De voorbeeldafbeelding is van het type .png. Zijn grootte is gespecificeerd door de voorbeeldafbeeldingskop. Het voorbeeldafbeeldingsbestand is ingevoegd als bestandsstream en volgt direct op de voorbeeldafbeeldingskop.

#### Kop van inhoud van archief van BasKet

Net als voor het voorbeeldafbeeldingsbestand wordt de inhoud van het archief voorafgegaan door een tekenreeks die zijn grootte specificeert. Die tekenreeks wordt direct gevolgd door de bestandsstream van het archief.

Die tekenreeks moet `archive*:<size>` zijn gevolgd door een symbool nieuwe-regel in ISO-8869-1 codering. De parameter `<size>` is een lang geheel getal zonder teken in formaat tekenreeks.

Een voorbeeld:

    archive*:1245000

#### Inhoud van archief van BasKet

De inhoud van het archief bevat de bestandsboomstructuur van BasKet gecomprimeerd naar een gzipped tar-archief (.tar.gz). Zijn grootte is gespecificeerd door de inhoudskop.

#### Voorbeeld byte-stream

De volgende tabel toont sleuteldelen van de inhoud van het archiefbestand van basket. De linker kolom specificeert de offset in de bestandsstream. De middelste kolom geeft de bytestream op de huidige offset in hexadecimaal formaat. De rechter kolom toont afdrukbare tekens in de bestandsstream op de huidige offset.

## Vragen, antwoorden en tips

## Veel voorkomende vragen

Vraag 1

Het antwoord