# Manual do &basket;

## AVISO: manual ainda não escrito

O &basket; ainda não possui um manual, então contribuições são bem-vindas! Confira a documentação do KDE para dicas sobre o formato DocBook.

Entretanto, você pode procurar ajuda na internet. Em particular, consulte o site antigo ou verifique revistas de Linux, se tiver acesso a elas, por exemplo:

- Tutorial: Basket: Capture seus pensamentos. Linux Format 120 (Andy Channelle)

- Uma cesta virtual. Armazene, organize e arquive com o KDE's Basket Linux Magazine 54 (Stefanie Teufel)

## Introdução

O &basket; é principalmente um aplicativo para anotações de uso geral, mas com uma finalidade específica:

## Usando o BasKet

### Sincronização de versão

Quando ativada, a sincronização de versões coloca suas cestas e notas sob controle de versão. Atualmente, este é um recurso experimental e apenas funções muito básicas estão implementadas, portanto, pode exigir software adicional e alguma configuração manual. Estas são algumas das coisas que podem ser feitas usando ferramentas externas (mas ainda não pela interface do Basket):

- check out de versões antigas e reversão de alterações

- sincronizar cestas em vários computadores (mesclar as alterações)

- enviar backup das cestas para o repositório remoto

Para habilitá-la, selecione Configurações Configurar blocos de notas do Basket → Sincronização de versões e Habilitar controle de versão distribuído. Isso inicializará o repositório git em `~/.kde/share/apps/basket/baskets`, no qual as ferramentas git padrão podem ser usadas.

#### Limpar histórico de versões

Limpar o histórico pode ser útil nestes casos:

- você bloqueou uma cesta e deseja remover quaisquer versões anteriores não criptografadas (que ainda estejam armazenadas no sistema)

- você deseja liberar espaço em disco (pode ser relevante se você inserir muitas imagens ou outros arquivos na cesta)

Observe que você terá que refazer qualquer configuração manual que tenha feito no repositório git.

## Estrutura de arquivo do Basket

### Introdução

### Formato de arquivamento do Basket

O formato de arquivo BasKet (.baskets) é uma estrutura que envolve um arquivo compactado tar e uma imagem de pré-visualização. A versão mais recente do formato de arquivo é a 0.6.1.

#### Estrutura de arquivo

O arquivo compactado é dividido nas seguintes estruturas: cabeçalho do arquivo, cabeçalho da imagem de pré-visualização, uma imagem de pré-visualização (.png), cabeçalho do arquivo compactado e um arquivo tar descompactado (.tar.gz) contendo uma árvore de arquivos do Baskets, conforme ilustrado no seguinte esboço

#### Cabeçalho do arquivo

O cabeçalho do arquivo é uma estrutura curta, composta por linhas de strings, o declarador de arquivo e a versão do formato

Os primeiros 17 bytes contêm a string literal `BasKetNP:archive` seguida por um símbolo de nova alimentação de linha (0x0A) na codificação ISO-8859-1.

A segunda string é uma string literal `version:0.6.1` seguida por um símbolo de alimentação de linha (0x0A) na codificação ISO-8859-1.

Um exemplo:

    BasKetNP:archive
    version:0.6.1

#### Imagem de pré-visualização do cabeçalho

Atualmente, o arquivo de cesta contém um arquivo de pré-visualização que é derivado do conteúdo da primeira cesta.

Imediatamente após o cabeçalho do arquivo, uma string literal `preview*:<size>` em codificação ISO-8859-1, novamente seguida por um símbolo de quebra de linha. O parâmetro `<size>` é uma string de números decimais. Ele declara o tamanho em bytes da imagem de pré-visualização. `<size>` é do tipo unsigned long.

Um exemplo:

    preview*:12000

#### Arquivo da imagem de pré-visualização

A imagem de pré-visualização é do tipo .png. Seu tamanho é especificado pelo cabeçalho da imagem de pré-visualização. O arquivo de imagem de pré-visualização é inserido como um fluxo de arquivo e segue diretamente o cabeçalho da imagem de pré-visualização.

#### Cabeçalho do arquivo de conteúdo BasKet

Assim como no arquivo de imagem de pré-visualização, o arquivo de conteúdo é precedido por uma string que especifica seu tamanho. Essa string segue diretamente o fluxo de arquivo do arquivo.

Essa string deve ser `archive*:<size>` seguida por um símbolo de quebra de linha, na codificação ISO-8869-1. O parâmetro `<size>` é um inteiro longo sem sinal no formato de string.

Um exemplo:

    archive*:1245000

#### Conteúdo do arquivo BasKet

O arquivo de conteúdo contém a árvore de arquivos BasKet compactada em um arquivo gzip tar (.tar.gz). Seu tamanho é especificado pelo cabeçalho de conteúdo.

#### Exemplo de fluxo de bytes

A tabela a seguir mostra partes importantes do conteúdo do arquivo compactado. A coluna da esquerda especifica o deslocamento no fluxo do arquivo. A coluna central fornece o fluxo de bytes no deslocamento atual em formato hexadecimal. A coluna da direita mostra os caracteres imprimíveis dentro do fluxo do arquivo no deslocamento atual.

## Perguntas, respostas e dicas

## Perguntas frequentes

Pergunta 1

A resposta