# Detalhes do &appname;

## Tipos de Campos

Cada colecçã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 item de introduçã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, exceptuando 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 carregada 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 introduçã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 ficheiros do &kde; para abrir os documentos referenciados. Não é feita nenhuma validação sobre o valor actual de um campo &URL;, mas as referências inválidas não são abertas. A introdução de dados é feita através de um campo de texto com um botão para abrir a janela normal da opção 'Ficheiro'->'Abrir', se bem que poderá usar qualquer &URL;. Os &URL;s relativos são interpretados em relação à localização do ficheiro de dados, uma vez estando esta gravada.

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

Poderá usar também &URL; relativos. Estes são interpretados em relação à localização do ficheiro de dados do &appname;. No Editor de Itens, o campo de texto oferece a completação automática para as localizações de ficheiros locais. Se quiser que o &URL; da Janela de Selecção de Ficheiros do &kde; seja interpretada em relação à localização do documento, então deverá definir a propriedade extendida 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 revisões deverão ser introduzidos com este tipo de dados.

### Escolha

Quando um campo tiver de ser limitado a alguns valores predefinidos, é usado um campo de Escolha. Os valores aceitáveis são apresentados numa lista para posterior selecçã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.

Deverá usar pontos-e-vírgulas (;) para separar os valores permitidos.

### Opção

Para os campos que aceita um valor 'sim' ou 'não', está disponível o campo Opção [de marcação]. Por omissã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 'oferta' 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 Selecção de Datas do &kde; poderá ser usada para escolher a data com o rato, assim como poderá ser introduzida directamente. O campo não é obrigatório ter o ano, o mês e o dia todos preenchidos; 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 folha de cálculo, com linhas numeradas. Quando for seleccionada a última linha, é adicionada uma nova. A completação automática 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 carregar 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, poderá reorganizar as linhas, arrastando o rato enquanto carrega na tecla &Ctrl;. Está disponível também um menu de contexto se carregar com o botão direito na tabela, o que permitirá introduzir 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 gravada dentro do ficheiro de dados do &appname; propriamente dito ou na pasta de dados da aplicação. O Selector de Ficheiros do &kde; pode ser usado tanto para um &URL; qualquer ou para um ficheiro local. As imagens poderão ser arrastadas a partir de um gestor de ficheiros 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 omissão, a classificação pode ter como máximo o valor 5. 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 Colecçã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 Dependente tiver uma descrição igual a `%{título} %{ano}`, então o valor do campo será o título, seguido do ano. Este tipo de campo é usado, por exemplo, para o campo do título das colecçõ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 seleccionar 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, pelo que o `%{autor:-1}` seria o último autor. 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 Colecções

O &appname; suporta doze tipos de colecções específicos por omissão: livros, itens bibliográficos, bandas desenhadas, vídeos, músicas, jogos de vídeo, cartas para troca, moedas, selos, vinhos, jogos de tabuleiro e catálogos de ficheiros. Para além disso, está disponível um modelo genérico de colecções para quaisquer outros itens de colecção. As colecções predefinidas só existem para incluir um conjunto geral de campos. Podê-los-á adicionar, modificar ou apagar de acordo com as suas necessidades. O único requisito é que uma colecção deverá ter sempre um campo de Título, para que o Área de Grupos funcione correctamente. Para alguns tipos de colecçã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 colecções. Poderá criar uma colecção personalizada para os seus livros de forma tão fácil como ao utilizar a colecção de livros predefinida. Todavia, o &appname; escolhe os ícones com base no tipo de colecção, pelo que poderá existir alguma funcionalidade especializada que seja única para uma dada colecção; por isso, se puder, use a versão predefinida. Deste modo, se quiser criar uma colecção de vinhos, mas se não gostar dos campos por omissão, siga e crie uma colecção de vinhos por omissão, apagando depois todas as predefinições. Deste modo, o &appname; continua a saber que é uma colecção de vinhos.

Por omissão, todos os tipos de colecções incluem um campo ID, o qual mostra o número identificador do registo. Para além disso, exceptuando o catálogo de ficheiros, cada colecção inclui campos que mostram a data em que o registo foi criado na colecção, bem como o último momento em que foi modificado.

### Colecções de Livros

As colecções de livros têm 26 campos predefinidos: Título, Sub-tí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, Prenda, Emprestado, Classificação, Capa Frontal e Comentários.

O campo ISBN# é especial, dado 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 o apagar, ou necessitar de o adicionar a outro tipo de colecçã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 actualizado posteriormente.

### Bibliografias

As bibliografias têm 25 campos predefinidos: 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 colecções bibliográficas não esteja ligadas especificamente ao bibtex, o conjunto predefinido de campos é definido a partir um conjunto típico de campos do bibtex. Ao exportar para esse formato, é usada uma propriedade extendida 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 que define a propriedade extendida bibtex.

O &appname; tem de facto algumas funções especializadas para bibliografias. 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 deste poderão ser enviadas para uma aplicação externa, como o LyX ou o Kile, usando o lyxpipe.

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

### Colecções de Bandas Desenhadas

As colecções de bandas desenhadas têm 22 campos predefinidos: Título, Sub-tí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, Prenda, Emprestado, Capa Frontal e Comentários.

### Colecções de Vídeos

As colecções de vídeo têm 30 campos predefinidos: 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 Acção, Classificação Pessoal, Data de Compra, Preço de Compra, Prenda, Emprestado, Capa e Comentários.

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

### Colecções de Músicas

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

### Colecções de Jogos

As colecções de jogos de vídeo têm 16 campos predefinidos: 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, Prenda, Emprestado, Capa e Comentários.

### Colecções de Cartões

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

### Colecções de Moedas

As colecçõ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, Prenda, Face, Reverso e Comentários.

### Colecções de Selos

As colecções de selos têm 18 campos predefinidos: 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, Prenda, Imagem e Comentários.

### Colecções de Vinhos

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

### Colecções de Jogos de Tabuleiro

As colecções de jogos de tabuleiro têm 15 campos predefinidos. 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, Prenda, Emprestado, Capa e Comentários,

### Catálogos de Ficheiros

Os catálogos de ficheiros têm 13 campos predefinidos: Nome, &URL;, Descrição, Volume, Tipo MIME, Tamanho, Permissões, Dono, Grupo, Criado, Modificado, Meta-Dados e Ícone,

### Colecções Personalizadas

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