# Підручник з &basket;

Gleb Baryshev gleb.baryshev@gmail.com
7 листопада 2016 року
2.11

Подбає про ваші ідеї.

KDE BasKet

## ЗАУВАЖЕННЯ: підручник ще не написано

У &basket; все ще немає підручника, тому ми будемо раді вашим внескам! Ознайомтеся із документацією KDE, щоб дізнатися більше про формат DocBook.

Тим часом, можете пошукати довідку в інтернеті. Зокрема, ознайомтеся зі старим сайтом або публікаціями з журналів про Linux, якщо ви маєте до них доступ. Приклад:

- Підручник: Basket: зафіксуйте ваші думки. Linux Format 120 (Andy Channelle)

- Віртуальний кошик. Збереження, упорядкування та архівування за допомогою Basket KDE Linux Magazine 54 (Stefanie Teufel)

## Вступ

&basket; — в основному універсальна програма для запису нотаток, але зокрема:

## Користування BasKet

### Синхронізація версій

Якщо увімкнено, синхронізація версій передає ваші кошики та нотатки у систему керування версіями. Наразі це експериментальна функція, і реалізовано лише найпростіші функції, тому може знадобитися додаткове програмне забезпечення та ручне налаштування. Ось деякі з речей, які можна зробити за допомогою зовнішніх інструментів (але поки не інтерфейсу Basket):

- отримання застарілих версій та скасування змін

- синхронізація кошиків на декількох комп'ютерах (об'єднання змін)

- записування резервних копій кошиків до віддаленого сховища

Щоб увімкнути її, скористайтеся пунктами Параметри Налаштувати нотатники BasKet → Синхронізація версій і Увімкнути розподілену систему керування версіями. Буде ініціалізовано сховище git у `~/.kde/share/apps/basket/baskets`, для якого можна використовувати стандартні інструменти git.

#### Спорожнення журналу версій

Створення журналу може бути корисним у таких випадках:

- ви замкнули кошик і хочете вилучити будь-які попередні незашифровані версії (які ще зберігаються у системі)

- ви хочете звільнити трохи місця на диску (може бути корисним, якщо ви вставляєте багато зображень та інших файлів у Basket)

Зауважте, що вам доведеться повторити будь-які налаштовування вручну, які ви виконували для сховища git.

## Структура файла BasKet

### Вступ

### Формат файлів архівів BasKet

Формат файлів BasKet (.baskets) має структуру, яка включає запаковані tar дані та зображення попереднього перегляду. Останньою версією формату архіву є 0.6.1.

#### Структура файлів

Файл архіву поділено на структури: заголовок файла, заголовок зображення попереднього перегляду, зображення попереднього перегляду (.png), заголовок архіву і запакований gunzip архів tar (.tar.gz), що містить ієрархію файла кошиків, як це проілюстровано на наведеному нижче ескізі

#### Заголовок файла архіву

Заголовок файла є короткою структурою, що складається з рядків даних, декларації файла та версії формату

У перших 17 байтах міститься буквально рядок `BasKetNP:archive`, за яким має бути символ заповнення рядка (0x0A) у кодуванні ISO-8859-1.

Другим рядком є буквально рядок `version:0.6.1`, наприкінці якого теж має бути символ заповнення рядка (0x0A) у кодуванні ISO-8859-1.

Приклад:

    BasKetNP:archive
    version:0.6.1

#### Заголовок зображення попереднього перегляду

У поточній версії файл архіву кошиків містить файл попереднього перегляду, який є похідним з початкових даних кошика.

Одразу після заголовка файла слід вказати буквально рядок `preview*:<розмір>` у кодуванні ISO-8859-1, знову ж таки із завершенням символом заповнення рядка. Параметр `<розмір>` є рядком з десяткових цифр. Він оголошує розмір зображення попереднього перегляду у байтах. `<розмір>` має належати до типу довгого цілого числа без знаку.

Приклад:

    preview*:12000

#### Файл зображення попереднього перегляду

Зображення попереднього перегляду належить до типу .png. Його розмір визначається заголовком зображення попереднього перегляду. Файл зображення попереднього перегляду буде вставлено як файловий потік, одразу після заголовка зображення попереднього перегляду.

#### Заголовок архіву даних BasKet

Подібно до файла зображення попереднього перегляду, перед архівом даних має бути вказано рядок, що визначає розмір архіву. За цим рядком безпосередньо слідує файловий потік архіву даних.

Цим рядком має бути рядок `archive*:<розмір>`, за яким слідує символ заповнення рядка у кодуванні ISO-8869-1. Параметр `<розмір>` має належати до типу довгих цілих чисел без знаку у рядковому форматі.

Приклад:

    archive*:1245000

#### Архів з даними BasKet

Архів даних містить ієрархію файлів BasKet, стиснуту за до стиснутого gzip архіву tar (.tar.gz). Його розмір визначається заголовком даних.

#### Приклад байтового потоку

У наведеній нижче таблиці показано ключові частини вмісту файла архіву basket. У лівому стовпчику вказано зміщення у файловому потоці. У центральному стовпчику подано байтовий потік з поточним зміщенням у шістнадцятковому форматі. У правому стовпчику показано придатні до друку символи у файловому потоці за поточним зміщенням.

## Питання. відповіді і підказки

Поширені питання та відповіді на них

Питання 1

Відповідь