# Detalhes do &appname;

## Tipos de Campos

Cada coleção poderá ter um número ilimitado de campos. O &appname; suporta onze tipos de campos, os quais permitem gamas de dados diferentes.

### Texto simples

O tipo de campo mais básico é o Texto Simples. Não são colocadas restrições sobre os valores do campo e o elemento de inserção de dados é um campo de texto normal. Este tipo é apropriado para os campos que supostamente não terão dados muito extensos, como o autor ou o gênero.

### Número

O tipo Número é idêntico ao Texto Simples, excetuando que os dados estão restritos a serem numéricos. Os itens serão ordenados de forma numérica na área das colunas, caso seja clicada a coluna de um campo Número. O campo de edição, em conjunto com pequenas setas para aumentar ou diminuir o valor, é usado para a inserção de dados. Não é aplicada nenhuma formatação.

### &URL;

O tipo &URL; permite ter referências para outros documentos, usando as associações-padrão de tipos de arquivos do &kde; para abrir os documentos referenciados. Não é feita nenhuma validação sobre o valor atual de um campo &URL;, mas as referências inválidas não são abertas. A inserção de dados é feita através de um campo de texto com um botão para abrir a janela normal da opção 'Arquivo'->'Abrir', se bem que você poderá usar qualquer &URL;. Os &URL;s relativos são interpretados em relação à localização do arquivo de dados, uma vez estando ela salva.

No Editor de Itens, a legenda torna-se a hiperligação, enquanto na Área de Itens é usada uma hiperligação de fato. Este tipo de dados é conveniente para referenciar arquivos PDF de elementos bibliográficos ou para resenhas de filmes, por exemplo. Não é aplicada nenhuma formatação.

Você poderá usar também &URL;s relativas. Eles são interpretados em relação à localização do arquivo de dados do &appname;. No Editor de Itens, o campo de texto oferece o completamento automático para as localizações de arquivos locais. Se você quiser que a &URL; da Janela de Seleção de Arquivos do &kde; seja interpretada em relação à localização do documento, então deverá definir a propriedade estendida do campo &URL; como relative : true.

### Parágrafo

Para os campos de texto mais extensos, o tipo Parágrafo oferece uma área de texto mais alargada, correspondente a uma categoria própria. O campo Parágrafo não poderá ter vários valores, nem é formatado automaticamente. Não poderá ser usado para agrupamentos. Os resumos, descrições ou resenhas deverão ser inseridos com este tipo de dados.

### Escolha

Quando um campo tiver que ser limitado a alguns valores predefinidos, é usado um campo de Escolha. Os valores aceitáveis são apresentados numa lista para posterior seleção. Obviamente, não são aplicáveis vários valores. Os campos como os tipos bibliográficos ou as classificações pessoais são campos do tipo Escolha.

Você deverá usar ponto e vírgula (;) para separar os valores permitidos.

### Opção

Para os campos que aceitam um valor 'sim' ou 'não', está disponível o campo Opção [de marcação]. Por padrão, o campo está desligado. Os campos Opção não são formatados e estão limitados a valores simples. Internamente, os valores dos campos são armazenados como valores `true` (verdadeiro) ou `false` (falso). Alguns exemplos são 'presente' ou 'emprestado'.

### Data

Um campo de Data poderá incluir um dia, um mês e um ano. A data é apresentada segundo o formato-padrão AAAA-MM-DD, o qual permite uma ordenação simples. A janela normal de Seleção de Datas do &kde; poderá ser usada para escolher a data com o mouse, assim como poderá ser inserida diretamente. O campo não é obrigatório ter o ano, o mês e o dia todos preenchidos; você poderá preencher apenas o ano, por exemplo. Não são permitidos valores múltiplos.

### Tabela

Os campos Tabela contém uma ou mais colunas de valores. No Editor de Itens, o campo é apresentado com uma vista semelhante a uma planilha, com linhas numeradas. Quando for selecionada a última linha, é adicionada uma nova. O completamento automático não está disponível. Este campo é útil para uma lista de capítulos de um livro, as cenas de um filme ou as músicas de um álbum. Os campos Tabela são sempre uma categoria por si só.

O número de colunas, até um máximo de dez, é definido ao adicionar uma propriedade columns à definição do campo. As colunas poderão ser legendadas se clicar com o botão direito no cabeçalho, ou definindo uma propriedade do campo chamada column1, etc.

Ao usar o Editor de Itens para os campos Tabela, você poderá reorganizar as linhas, arrastando o mouse enquanto pressiona a tecla &Ctrl;. Está disponível também um menu de contexto se clicar com o botão direito na tabela, o que permitirá inserir ou remover linhas.

### Imagem

Os campos Imagem guardam uma imagem em qualquer formato suportado pelo &kde;. Alguns dos formato típicos incluem o PNG ou o JPEG. A imagem poderá ser salva dentro do arquivo de dados do &appname; propriamente dito ou na pasta de dados da aplicação. O Seletor de Arquivos do &kde; pode ser usado tanto para uma &URL; qualquer ou para um arquivo local. As imagens poderão ser arrastadas a partir de um gerenciador de arquivos ou um navegador.

### Classificação

Os campos de Classificação mostram um número de estrelas que representam uma classificação numérica para um item. Por padrão, a classificação pode ter como valor máximo o 5. Você pode contudo definir o valor mínimo e máximo se definir as propriedades minimum e maximum na definição do campo na Janela dos Campos da Coleção.

### Campos de Valores Derivados

Os campos com valores derivados são um caso especial. O tipo de campo corresponde ao tipo típico do valor contido no campo, se bem que o valor do campo é construído a partir dos valores de outros campos, usando um texto de formato na descrição do campo. Por exemplo, se um campo tiver um valor de modelo igual a `%{título} %{ano}`, então o valor do campo será o título, seguido do ano. Esse tipo de campo é usado, por exemplo, para o título das coleções de moedas, selos, cartões e vinhos. Tanto o nome interno do campo como o seu título poderão ser usados na descrição para a formatação.

Para selecionar apenas um único valor para um campo de múltiplos valores adicione um índice de posição ao modelo, como por exemplo `%{autor:1}` para o primeiro autor. A posição poderá ser negativa, onde nesse caso irá contar a partir do fim, assim o `%{autor:-1}` seria o último autor. Você poderá usar valores em maiúsculas e minúsculas ao definir as opções do modelo, como por exemplo `%{autor:1/l}` para o primeiro autor em minúsculas e `%{autor:1/u}` para maiúsculas.

## Tipos de Coleções

O &appname; suporta doze tipos de coleções específicos por padrão: livros, itens bibliográficos, quadrinhos, vídeos, músicas, jogos de computador, cartas para troca, moedas, selos, vinhos, jogos de tabuleiro e catálogos de arquivos. Além disso, está disponível um modelo genérico de coleções para quaisquer outros itens de coleção. As coleções padrão só existem para incluir um conjunto geral de campos. Você poderá adicionar, modificar ou apagar os campos de acordo com as suas necessidades. O único requisito é que uma coleção deverá ter sempre um campo de Título, para que a Área de Grupos funcione corretamente. Para alguns tipos de coleção, esse é apenas um campo de valor derivado que combina dois ou mais dos outros campos.

De um modo geral, não existe nenhuma diferença funcional entre os tipos de coleções. Você poderá criar uma coleção personalizada para os seus livros de forma tão fácil como ao utilizar a coleção de livros padrão. Todavia, o &appname; escolhe os ícones com base no tipo de coleção, assim poderá existir alguma funcionalidade especializada que seja única para uma determinada coleção; por isso, se puder, use a versão padrão. Deste modo, se quiser criar uma coleção de vinhos, mas não gostar dos campos padrão, siga e crie uma coleção de vinhos padrão, apagando depois todas as predefinições. Deste modo, o &appname; continua sabendo que é uma coleção de vinhos.

Por padrão, todos os tipos de coleções incluem um campo ID, que mostra o número identificador do registro. Além disso, excetuando o catálogo de arquivos, cada coleção inclui campos que mostram a data em que o registro foi criado na coleção, bem como o último momento em que foi modificado.

### Coleções de Livros

As coleções de livros possuem 26 campos padrão: Título, Subtítulo, Autor, Encadernação, Data de Compra, Preço de Compra, Publicador, Edição, Ano de 'Copyright', Ano de Publicação, ISBN#, LCCN#, Páginas, Língua, Gênero, Palavras-chave, Série, Número de série, Condição, Assinado, Lido, Presente, Emprestado, Classificação, Capa Frontal e Comentários.

O campo ISBN# é especial, uma vez que os números ISBN são formatados automaticamente e é calculado o dígito de verificação. O &appname; reconhece o campo ISBN se o seu nome interno de campo for isbn. Se apagá-lo, ou necessitar adicioná-lo a outro tipo de coleção, crie o campo com o título ISBN e aplique a alteração, para que possa depois regressar e modificar o título ao seu gosto. O &appname; cria o nome interno com base no título inicial, mas nunca o altera se o título for atualizado posteriormente.

### Bibliografias

As bibliografias têm 25 campos padrão: Título, Tipo de Item, Autor, Chave do Bibtex, Título do Livro, Editor, Organização, Publicador, ISBN#, Endereço, Edição, Páginas, Ano, Jornal, Mês, Número, Modo de Publicação, Capítulo, Série, Número de Série, Volume, Referência Cruzada, Palavras-Chave, Resumo e Notas.

Ainda que as coleções bibliográficas não estejam ligadas especificamente ao bibtex, o conjunto padrão de campos é definido a partir um conjunto típico de campos do bibtex. Ao exportar para esse formato, é usada uma propriedade estendida chamada bibtex para definir o campo correspondente do 'bibtex' de cada campo. Se adicionar um campo extra a uma bibliografia e quiser exportá-la para o bibtex, certifique-se de que definiu a propriedade estendida bibtex.

O &appname; tem de fato algumas funções especializadas para bibliografias. Você pode adicionar, modificar ou apagar macros do texto do Bibtex dentro do &appname;; do mesmo modo, poderá expandir as macros na exportação para o Bibtex. As citações poderão ser enviadas para uma aplicação externa, como o LyX ou o Kile, usando o lyxpipe.

As coleções de livros poderão ser convertidas para bibliografias. São adicionados os campos padrão do 'bibtex', assim como são definidas as propriedades estendidas. Esta funcionalidade existe, a nível primário, para converter as coleções antigas, antes de o tipo 'bibliografia' ter sido dissociado da coleção de livros.

### Coleções de Quadrinhos

As coleções de quadrinhos têm 22 campos padrão: Título, Subtítulo, Escritor, Artista, Série, Número, Publicador, Edição, Ano de Publicação, Páginas, País, Língua, Gênero, Palavras-chave, Condição, Data de compra, Preço de compra, Assinado, Presente, Emprestado, Capa frontal e Comentários.

### Coleções de Vídeos

As coleções de vídeo têm 30 campos padrão: Título, Disco, Ano de Produção, Certificação, Gênero, Região, Nacionalidade, Formato, Elenco, Realizador, Produtor, Argumento, Compositor, Estúdio, Faixas de Línguas, Línguas das Legendas, Faixas de Áudio, Duração, Proporções, Panorâmico, Modo de Cor, Versão do Realizador, Resumo da Ação, Classificação Pessoal, Data de Compra, Preço de Compra, Presente, Emprestado, Capa e Comentários.

O campo do Elenco é uma tabela com duas colunas, em que o nome do ator se encontra na primeira coluna e a sua personagem na segunda. A Duração pretende ser em minutos, ainda que você possa mudar isso, obviamente.

### Coleções de Músicas

As coleções de músicas têm 15 campos padrão: Título, Disco, Artista, Editor, Ano, Gênero, Faixas, Classificação, Data de Compra, Preço de Compra, Presente, Emprestado, Palavras-Chave, Capa e Comentários.

### Coleções de Jogos

As coleções de jogos têm 16 campos padrão: Título, Plataforma, Gênero, Ano de Lançamento, Publicador, Desenvolvimento, Classificação do ESRB, Descrição, Classificação Pessoal, Completo, Data de Compra, Preço de Compra, Presente, Emprestado, Capa e Comentários.

### Coleções de Cartas

As coleções de cartas para troca têm 17 campos padrões: Título, Jogador, Equipe, Marca, Número do Cartão, Ano, Série, Tipo de Cartão, Data de Compra, Preço de Compra, Localização, Presente, Palavras-Chave, Quantidade, Imagem Frontal, Imagem Traseira e Comentários.

### Coleções de Moedas

As coleções de moedas têm 16 campos predefinidos: Título, Tipo, Denominação, Ano, Marca da Casa Emissora, País, Conjunto de Moedas, Classificação, Tipo de Classificação, Data de Compra, Preço de Compra, Localização, Presente, Face, Reverso e Comentários.

### Coleções de Selos

As coleções de selos têm 18 campos padrões: Título, Descrição, Denominação, País, Ano de Emissão, Cor, Scott#, Classificação, Cancelado, Articulado, Centrado, Colado, Data de Compra, Preço de Compra, Localização, Presente, Imagem e Comentários.

### Coleções de Vinhos

As coleções de vinhos têm 15 campos padrão: Título, Produtor, Apelação, Variedade, Tipo, País, Data de Compra, Preço de Compra, Localização, Quantidade, Bebido Por, Classificação, Presente, Etiqueta e Comentários.

### Coleções de Jogos de Tabuleiro

As coleções de jogos de tabuleiro têm 15 campos padrão. Título, Gênero, Mecanismo, Ano de Lançamento, Publicador, Desenhador, Número de Jogadores, Descrição, Classificação, Ano de Compra, Preço de Compra, Presente, Emprestado, Capa e Comentários,

### Catálogos de Arquivos

Os catálogos de arquivos têm 14 campos padrão: Nome, &URL;, Descrição, Volume, Pasta, Tipo MIME, Tamanho, Permissões, Dono, Grupo, Criado, Modificado, Metadados e Ícone,

### Coleções Personalizadas

As coleções personalizadas têm um campo predefinido, o Título. Elas devem ser usadas quando o item colecionável não é um dos tipos padrão.