# Das Handbuch zu &basket;

## Notiz: Das Handbuch wurde noch nicht verfasst

&basket; hat immer noch kein Handbuch, Mitwirkende sind also willkommen! Lesen Sie die KDE-Dokumentation, dort finden Sie Tipps und Anleitungen zum DocBook-Format.

Zwischenzeitlich können Sie im Internet nach Hilfe suchen. Sehen Sie sich speziell die alte Website durch oder schlagen Sie in Linux-Magazinen nach (wenn Sie Zugriff darauf haben), z. B.:

- 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)

## Einführung

&basket; ist hauptsächlich ein universelles Notizbuch, aber ein spezielles:

## BasKet verwenden

### Versionsabgleich

Wenn aktiviert, stellt Versionsabgleich Ihre Körbe und Notizen unter Versionsverwaltung. Zur Zeit ist dies eine experimentelle Funktion mit nur wenigen implementierten Basisfunktionen, sodass evtl. einige Zusatzprogramme und manuelles Einrichten erforderlich sind. Im Folgenden finden Sie einiges, was mithilfe von externen Hilfsprogrammen (aber noch ohne BasKet-Schnittstelle) bewerkstelligt werden kann:

- Ältere Versionen auschecken und Änderungen rückgängig machen

- Abgleich der Körbe auf verschiedenen Rechnern (Zusammenführen der Änderungen)

- Sicherung der Körbe in ein fernes Projektarchiv übertragen

Um es zu aktivieren, wählen Sie Einstellungen BasKet-Notizblätter einrichten → Versionsabgleich und Verteilte Versionskontrolle aktivieren. Dies wird ein Git-Projektarchiv in `~/.kde/share/apps/basket/baskets` initialisieren, bei dem übliche Git-Werkzeuge verwendet werden können.

#### Versionsverlauf leeren

Den Versionsverlauf zu leeren kann in folgenden Fällen nützlich sein:

- Sie haben einen Korb gesperrt und möchten alle unverschlüsselten Vorgängerversionen entfernen (die immer noch im System gespeichert sind)

- Wenn Sie Festplattenplatz freigeben möchten (kann wichtig werden, wenn Sie eine Menge Fotos oder anderer Dateien in BasKet eingefügt haben)

Beachten Sie, dass Sie jede manuelle Einstellung, die Sie am Git-Projektarchiv vorgenommen haben, rückgängig machen müssen.

## Dateistruktur von BasKet

### Einführung

### Archivdateiformat von BasKet

Das BasKet-Dateiformat (.baskets) ist eine Struktur, die ein komprimiertes tar-Archiv mit einem Vorschaubild verbindet. Die letzte Archivformat-Version ist 0.6.1.

#### Dateistruktur

Die Archivdatei ist in folgende Strukturen aufgeteilt: Dateikopf, Vorschaubild-Header, ein Vorschaubild (.png), Header für Inhaltsarchiv und ein mittels gzip komprimiertes tar-Archiv (.tar.gz), das einen Korb-Dateibaum enthält. Folgende Skizze veranschaulicht die oben beschriebene Struktur:

#### Archiv-Dateikopf

Der Dateikopf ist eine kurze Struktur, die aus Zeichenketten-Zeilen, der Datei-Beschreibung und der Format-Version besteht.

Die ersten 17 Bytes enthalten die Zeichenkette `BasKetNP:archive`, gefolgt von einem Zeilenvorschubzeichen (0x0A) in ISO-8869-1 Kodierung,

Der zweite String enthält die Zeichenkette `version:0.6.1`, gefolgt von einem Zeilenvorschubzeichen (0x0A) in ISO-8869-1 Kodierung,

Ein Beispiel:

    BasKetNP:archive
    version:0.6.1

#### Vorschaubild-Kopfeintrag

Zurzeit enthält die BasKet-Archivdatei eine Vorschaudatei, die aus dem Inhalt des ersten Korbes abgeleitet wird.

Direkt im Anschluss an den Dateikopf folgt eine Zeichenkette `preview*:<size>` in ISO-8869-1 Kodierung, wieder gefolgt von einem Zeilenvorschubzeichen. Der Parameter `<size>` ist eine Zeichenkette, die eine Dezimalzahl darstellt. Diese gibt die Größe des Vorschaubildes in Bytes an. Datentyp von `<size>` ist „unsigned long“.

Ein Beispiel:

    preview*:12000

#### Vorschaubild-Datei

Das Vorschaubild ist vom Typ „.png“. Seine Größe ist im Vorschaubild-Kopfeintrag angegeben. Die Vorschaubild-Datei folgt als Datenstrom direkt dem Vorschaubild-Kopfeintrag.

#### BasKet Inhaltsarchiv-Kopfeintrag

Genau wie bei der Vorschaubild-Datei beginnt das Inhaltsarchiv mit einer Zeichenkette, die dessen Größe angibt. Dieser Zeichenkette folgt direkt der Datenstrom des Archivs.

Diese Zeichenkette muss mit `archive*:<size>` beginnen, gefolgt von einem Zeilenvorschubzeichen, in ISO-8869-1 Kodierung. Der Parameter `<size>` ist eine Zeichenkette vom Datentyp „unsigned long integer“.

Ein Beispiel:

    archive*:1245000

#### BasKet Inhaltsarchiv

Das Inhaltsarchiv enthält den Dateibaum von BasKet als ein mittels gzip komprimiertes tar-Archiv (.tar.gz). Seine Größe ist im Inhaltsarchiv-Kopfeintrag angegeben.

#### Beispielhafter Bytestrom

Die folgende Tabelle zeigt Schlüsselteile des Basket-Archivdateiformats. Die linke Spalte gibt den Offset im Dateistrom an. Die mittlere Spalte gibt den Bytestrom am jetzigen Offset im hexadezimalen Format an. Die rechte Spalte zeigt die druckbaren Zeichen innerhalb dieses Bytestroms an.

## Fragen, Antworten und Tipps

## Häufig gestellte Fragen

Frage 1

Die Antwort