# Usando o &appname;

## Início Rápido

Por padrão, o &appname; começa com uma coleção de livros vazia. Para funcionar com outros tipos de coleção, crie-a com o item de menu Arquivo Novo ou o seu botão na barra de ferramentas. As coleções são preenchidas com alguns dos campos mais comuns, mas você poderá adicionar, modificar ou apagar campos de acordo com as suas necessidades.

Os itens novos poderão ser adicionados com o Editor de Itens. O item do menu Coleção Novo Item irá abrir o Editor de Itens com um item vazio, pronto para ser editado. O Editor de Itens pode também ser aberto se usar a opção Configurações Mostrar o 'Editor de Itens'. Assim que tiver inserido os valores para o item, poderá salvá-lo na coleção, usando o botão Salvar o Item na janela do Editor de itens, que permanece aberta no caso de continuar a querer adicionar itens novos. Assim que tiver salvo um item na coleção, você poderá modificá-lo se clicar nele na janela principal. Se o Editor de itens não estiver já aberto, poderá fazer duplo-clique sobre um item para abrir o editor e começar a edição.

Se você quiser incluir uma mensagem no elemento, poderá usar o Seletor de Arquivos padrão do &kde;, clicando para isso no botão Selecionar uma Imagem... no Editor de Itens, ou poderá ainda arrastar uma imagem do gerenciador de arquivos ou navegador Web para o Editor de Itens.

Quando selecionar um item, a Área de Itens irá mostrar uma janela formatada com o conteúdo do elemento. Você poderá modificar o modelo usado para apresentar o elemento na Janela de Configuração.

Os elementos da coleção são agrupados em conjunto, quando compartilham os mesmos valores para determinados campos, como o autor ou o realizador. Você poderá modificar o campo usado para o agrupamento, usando a lista na barra de ferramentas ou a opção do menu Configurações Seleção do Grupo.

Você poderá usar o Filtro Rápido na barra de ferramentas para limitar rapidamente os itens visíveis para os que contenham a palavra que digitar. O filtro também é útil quando quiser encontrar rapidamente um elemento. Você poderá inserir o título ou outra palavra única que identifique o elemento, para que a Exibição em coluna mostre apenas os elementos correspondentes ao filtro. Filtragens mais complexas podem usar nomes de campos diretamente, como como author=stephenson. A barra de estado mostra quantos elementos existem na coleção, bem como os que estão sendo filtrados no momento.

## Uso Geral

A janela principal possui três áreas distintas, todas elas apresentando informações sobre a coleção de maneiras diferentes. A área primária é a Exibição em coluna no canto superior direito, onde você poderá ver o valor de todos os campos de cada item. Do lado esquerdo, as páginas contêm a Área de Grupos, que poderá ser usada para ordenar os itens por grupos numa estrutura em árvore, a Área de Filtros, que é usada para verificar os itens que correspondem a determinados critérios e a Área de Empréstimos, onde aparecem todos os empréstimos. Finalmente, a Área de Itens mostra uma vista formatada dos dados para um determinado item, ou então uma vista em ícones de um grupo de itens, no canto inferior direito.

A Janela Principal do &appname;
A Janela Principal do &appname;

### Exibição em coluna

Qualquer um dos campos nas coleções poderá ser apresentado na Exibição em coluna, ainda que o Parágrafo, a Imagem e a Tabela possam não ser muito úteis. Clicar com o botão direito no cabeçalho da janela, abrirá um menu para selecionar os campos visíveis. As colunas poderão ser dimensionadas e reordenadas de qualquer forma, sendo que a configuração será salva entre sessões.

### Área de Grupos

A Área de Grupos agrupa os itens em árvore por qualquer campo que permita o agrupamento. O número de itens em cada grupo aparece após o nome do mesmo. Os grupos poderão ser expandidos ou recolhidos, se clicar na seta ou se fizer duplo-clique no item. A expansão e fecho de todos os grupos são opções no menu de contexto do botão direito do mouse. A árvore poderá ser ordenada pelo nome do grupo ou pela quantidade, clicando no cabeçalho. Um grupo também poderá ser usado como filtro na Exibição em coluna, se clicar com o botão direito no item do grupo.

Quando mais de um campo na coleção tiver a opção Formatar como nome ativada, será adicionado um novo grupo para combinar todos esses campos num único pseudo-grupo Pessoas.

Se um elemento não contiver um valor para o campo que é usado para formar os grupos, será colocado no grupo (Vazio), que usa uma pasta vermelha.

### Área de Filtros

Se forem salvos alguns filtros para a coleção, a Área de Filtros fica ativa. À medida que for adicionando ou modificando os elementos, eles serão validados automaticamente pelos filtros e adicionados ou removidos, conforme o resultado. Você poderá modificar o filtro se fizer duplo-clique no item para abrir a Janela avançada de filtros. Se clicar com o botão direito, poderá apagá-los em conjunto.

A Área de Filtros
A Área de Filtros

### Área de Empréstimos

Assim que os elementos vão saindo por empréstimo ou aluguel, é adicionada a Área de Empréstimos à janela, para que esses item emprestados possam ser acompanhados. Os empréstimos são seguidos com base em cada elemento, assim se clicar com o botão direito num item, você pode modificar o empréstimo com a Janela de Empréstimos.

A Área de Empréstimos
A Área de Empréstimos

### Área de Itens

É visível uma representação dos valores do elemento na Área de Itens. Os modelos são usados para a formatação e todos os gráficos adicionais. Você poderá indicar modelos separados para cada tipo de coleção, na Janela de Configuração, em conjunto com tipos de fonte e cores personalizados.

Todos os modelos padrão respeitam a seleção das cores e tipos de fonte, mas poderão existir outros modelos personalizados que não o façam. Os modelos padrão também tornam os campos de &URL; ativos, o que irá abrir os itens com a associação de arquivos padrão do &kde;. Ao exportar para &HTML;, é usado o modelo atual para exportar os arquivos individuais dos elementos.

### Barra de status

A barra de status é usada para apresentar o que o &appname; está fazendo no momento. Inclui também a quantidade total de elementos na coleção e, se estiver sendo usado um filtro, quantos estão visíveis no momento.

## Editar os Itens

O Editor de Itens é usado para adicionar e modificar itens na coleção. Se fizer duplo-clique num item, seja na Área de Grupos ou na Exibição em coluna, você irá abrir o Editor de Itens com esse item. Os itens novos podem ser criados com o menu Coleção, o ícone da barra de ferramentas ou o botão no Editor de Itens propriamente dito.

Se fechar o Editor de Itens com alterações feitas, mas não salvas, irá aparecer uma mensagem de aviso. Os campos são agrupados por categorias e aparecem na ordem indicada na Janela de Campos da Coleção. Eles poderão também ser reordenados.

O Editor de Itens
O Editor de Itens

Se clicar no título de um campo &URL;, irá abrir a ligação com a associação de arquivos padrão do &kde;. O botão seletor do &URL; ao lado do campo de texto irá abrir a janela de Abertura de Arquivos do &kde;, mas o campo não estará limitado a arquivos locais.

Para os campos Imagem, o botão Selecionar a Imagem... abre a janela de seleção de arquivos do &kde;. A imagem é salva na coleção com o formato original, sendo apresentada uma versão escalonada no Editor de Itens. A imagem poderá ser limpa se usar o botão Limpar. As imagens limpas são removidas da coleção.

O Editor de Itens para campos de Imagem
O Editor de Itens para campos de Imagem

O item de edição também suporta o arrastamento. Se arrastar um arquivo de imagem de um gerenciador de arquivos ou janela de navegador, fará o mesmo que selecionar uma imagem no Seletor de Arquivos. Se arrastar uma imagem do item de edição para uma janela de gerenciamento de arquivos do &konqueror;, irá salvar a imagem nessa pasta.

Por padrão, as imagens são salvas no arquivo de dados da coleção, estando tudo contido apenas num local. Contudo, muitas imagens farão com que o &appname; se torne significativamente mais lento, uma vez que irá resultar num arquivo de dados muito grande. Em alternativa, o &appname; poderá salvar as imagens separadamente, seja na pasta `$`KDEHOME`/share/apps/tellico/data/` ou numa pasta no mesmo local do arquivo de dados. O carregamento e salvamento dos arquivos de dados é muito mais rápido se as imagens forem salvas em separado, mas os arquivos de dados deixarão de ser portáteis ou fáceis de arquivar. Os dados auto-contidos poderão sempre ser criados se usar a opção do menu Arquivo Exportar Exportar para ZIP....

Os campos de Tabela começam com cinco linhas, mas se mover o cursor para a última linha, irá adicionar automaticamente outra. Para as tabelas multi-colunas, só é usada a primeira coluna para agrupar ou formatar.

O Editor de Itens para campos de Tabela
O Editor de Itens para campos de Tabela

### Editar Vários Itens

Você poderá editar vários itens ao mesmo tempo, se selecionar mais de um na Área de Grupos ou na Área de Colunas. Se selecionar vários itens, os campos que contêm o mesmo valor em cada item estarão ativos. Se os itens tiverem valores diferentes, então os campos ficarão desativados. São adicionadas opções de marcação do lado direito de cada item do campo, que controlam se o campo está ativo ou não, como aparece na imagem abaixo.

Somente os campos ativos serão modificados quando forem salvos os itens, o que torna a edição em grande escala muito mais simples. Por exemplo, para definir o Disco de todos os itens de vídeo na coleção, certifique-se de que este campo está ativo. Mude-o para DVD e salve depois os itens. Só será modificado o campo Disco, preservando todos os outros valores para os itens.

O Editor de Itens para vários itens
O Editor de Itens para vários itens

### Atualizar os Dados dos Itens

Os itens poderão ser atualizados automaticamente, consultando as fontes de dados disponíveis para o tipo de coleção atual, o que é muito útil para combinar as informações de várias fontes. Por exemplo, você poderá adicionar um filme à sua coleção com os Serviços Web da Amazon, atualizando depois o item com informações adicionais da IMDB (Internet Movie Database).

Só são atualizados os campos vazios, a menos que a configuração dessa fonte permita que os resultados substituam a informação existente. Para os programas externos, deverá ser indicado um campo de atualização nas opções da fonte.

A atualização do item poderá ser iniciada com o menu do botão direito para um item, ou então usando a opção do menu Coleção Atualizar o Item.

## Editar os Campos

A Janela de Campos da Coleção permite-lhe adicionar campos novos à coleção, modificar os existentes ou apagar alguns campos em conjunto.

A Janela de Campos da Coleção do &appname;
A Janela de Campos da Coleção do &appname;

### Lista de Campos

Do lado esquerdo da janela, existe a lista com os campos atuais. Os campos modificados são mostrado em negrito e itálico. Os botões abaixo da lista irão adicionar ou remover um campo, podendo usar também as setas para modificar a sua ordem. A ordem dos campos na lista é importante, porque o Editor de Itens usa a ordem para a sua formatação. Para cada categoria, os campos serão dispostos da esquerda para a direita, de acordo com a ordem de cima para baixo dos campo na lista.

### Propriedades do Campo

Um campo é definido pelo seu título, tipo, categoria, descrição e, possivelmente, um valor padrão ou alguns valores permitidos. O título é usado para referenciar o campo na interface do usuário. O Editor de Itens usa-o para pedir valores. A Exibição em coluna usa-o como cabeçalho da coluna. Os diferentes tipos de campos são explicados na seção dos Tipos de Campos. A descrição é usada como dica no Editor de Itens, talvez para oferecer uma explicação sobre o conteúdo do campo. Além disso, para os campos Derivados, a descrição é usada para formatar o valor do campo. O valor padrão é adicionado automaticamente ao criar um item novo. A lista de valores permitidos para os campos Escolha deverá ser separada por ponto e vírgula.

Os campos novos poderão ser de qualquer tipo, mas a alteração do tipo dos campos existente está restringida a campos compatíveis, como é apresentado na tabela abaixo:

#### Mudanças de Tipo de Campo Permitidas

Tipo Atual | Novo Tipo Permitido
--- | ---
Texto simples | Texto Simples, Parágrafo, Número, &URL;, Tabela
Parágrafo | Texto Simples, Parágrafo
Escolha | Texto Simples, Parágrafo, Escolha, Número, &URL;, Tabela
Opção | Texto Simples, Parágrafo, Opção, Número, &URL;, Tabela
Número | Texto Simples, Parágrafo, Número, &URL;, Tabela
&URL; | Texto Simples, Parágrafo, Número, &URL;, Tabela
Data | Texto Simples, Data
Tabela | Texto Simples, Parágrafo, Tabela
Imagem | Imagem
Classificação | Escolha, Classificação

### Formatação do Campo

O &appname; oferece alguma capacidade de formatação automática dos valores dos campos. A forma mais simples é a capitalização automática, que coloca todas as palavras começando em maiúsculas, excetuando os artigos. A formatação de títulos move certos artigos do início para o fim do campo; por exemplo, a alteração de "O Regresso do Rei" para "Regresso do Rei, O". Os artigos do título são configuráveis. Finalmente, a formatação de nomes tenta quebrar o texto, de modo que o último nome, ou apelido, da pessoa seja apresentado em primeiro lugar. Os prefixos e sufixos dos nomes são configuráveis. Do mesmo modo, o grupo especial Pessoas usa todos os campos com a formatação de nomes, mesmo que essa configuração global esteja desligada.

Toda a formatação automática poderá ser desativada, alterando as opções globais na Janela de Configuração. A nível global, capitalização é uma opção distinta da formatação, por isso um título poderá ser auto-formatado sem ser capitalizado. Nem todos os tipos permitem a formatação automática.

#### Exemplos de Formatação

Tipo de Formato | Valor do Campo | Auto-Capitalizado | Auto-Formatado | Auto-Capitalizado & Auto-Formatado
--- | --- | --- | --- | ---
Título | o regresso do rei | O Regresso do Rei | regresso do rei, o | Regresso do Rei, O
Nome | tom swift, jr. | Tom Swift, Jr. | swift, jr., tom | Swift, Jr., Tom

### Opções do campo

Os campos também possuem três opções gerais. Se o completamento automático estiver ativo, o &appname; faz 'cache' dos valores para cada campo, oferecendo o Editor de Itens o completamento automático, usando a configuração-padrão do &kde;. Nem todos os tipos de campos permitem o completamento automático. O &appname; também necessita saber se um campo poderá ter vários valores ou se poderá ser usado para agrupar os itens. É usado um ponto e vírgula para separar os vários valores, ao editar um item.

Por questões de eficiência, não ative o completamento automático, a menos que necessite dele para os campos. Quanto mais campos com completamento automático tiver na coleção, mais lento se torna o &appname; ao carregar o arquivo.

## Filtrar os Itens

A Janela de Filtros permite-lhe limitar os itens visíveis na Área de Colunas para os que correspondam a uma ou mais regras do filtro. O filtro poderá ser usado para descobrir os itens que correspondam a todas as regras na janela, ou simplesmente para descobrir os que correspondam a qualquer uma delas. A Janela de Filtros também é útil para a pesquisa avançada dentro de uma coleção.

A Janela de Filtros Avançados do &appname;
A Janela de Filtros Avançados do &appname;

Cada linha contém uma regra única de filtragem. Selecione o campo correspondente na primeira opção da linha, e selecione depois uma regra correspondente ao centro. As regras poderão corresponder a determinados valores ou que sejam exatamente iguais. Você poderá também usar uma expressão regular para fazer a correspondência dos itens; nesse caso, o botão Editar... fica ativo para editar a expressão, se o &kregexpeditor; estiver instalado no seu computador. Finalmente, a palavra ou texto correspondente deverão ser inseridos no campo de texto. Para campos de imagem, o tamanho da imagem pode ser usado para filtragem, onde o valor do filtro é comparado com a maior dimensão da imagem, seja largura ou altura.

Você poderá usar até oito (8) regras no filtro. Poderá usar os botões Mais e Menos para adicionar ou remover regras.

Os filtros poderão ser salvos, de modo que todos os itens correspondentes possam ser agrupados em conjunto na Área de Filtros. A área é dinâmica, para que os itens possam ser adicionados e/ou modificados e o grupo seja atualizado automaticamente. Para salvar o filtro, indique um nome no campo de texto e clique no botão Salvar o Filtro.

Os filtros salvos anteriormente poderão ser modificados, se clicar com o botão direito do mouse no item do filtro na Área de Filtros e selecionar a opção Modificar o Filtro. A janela do Janela de Filtros é aberta, e você poderá fazer as alterações ao nome ou às regras do filtro.

Para descobrir os livros de ficção científica que não leu, assinale a opção Corresponder a todos os seguintes, defina a primeira regra como Gênero contém Ficção Científica e a segunda como Lido não contém 'true'. (Para os campos Opção, o valor interno é true - verdadeiro).

Para descobrir os livros de Bujold ou Weber, assinale a opção Corresponder a qualquer dos seguintes, configure a primeira regra como Autor contém Bujold e a segunda como Autor contém Weber.

## Gerar Relatórios

O &appname; consegue gerar vários relatórios sobre a sua coleção atual. A Janela de Relatórios verifica todos os modelos em &xslt; que existam no local de instalação e na pasta `$`KDEHOME`/share/apps/tellico/report-templates/`. Assim, você poderá criar novos, para que eles sejam descobertos automaticamente e incluídos como opções na Janela de Relatório. Alguns relatórios mais complexos poderão levar algum tempo para gerar, no caso de coleções grandes.

Os modelos que são instalados com o &appname; incluem uma lista apenas com os títulos, a exibição em coluna (padrão), uma vista agrupada, um resumo de todos os grupos e os valores mais conhecidos nesses grupos, um relatório de empréstimos e um grande relatório com as imagens de capa. Selecione o modelo desejado e clique no botão Gerar. Todos os relatórios também poderão ser impressos ou salvos num arquivo &HTML;.

A Janela de Relatórios do &appname;
A Janela de Relatórios do &appname;

Os itens incluídos no relatório serão limitados aos que constam na Exibição em coluna, por isso, se tiver um filtro ativo, a Janela de Relatórios irá usá-lo.

## Registro de Empréstimos

O &appname; suporta o registro de empréstimos de quaisquer itens na coleção. A Janela de Empréstimos poderá ser aberta se usar o item Dar Saída ou se clicar com o botão direito num item. Você poderá dar saída a vários itens de uma vez.

O nome da pessoa a quem foi emprestado poderá ser inserido diretamente ou obtido a partir do livro de endereços padrão do &kde;, clicando no botão após o item do nome. A data da saída assume-se como sendo a data atual, mas poderá ser alterada. A data-limite é opcional, e poderá ainda adicionar algumas notas sobre o empréstimo.

Se for inserida uma data-limite e se o &appname; for compilado com o suporte para a 'libkcal', você poderá adicionar uma notificação ao calendário padrão do &kde; como um item Por-Fazer. O &korganizer; poderá ser usado para ver esses itens.

Quando for dada saída a um item, o campo Emprestado ficará true (verdadeiro). Se não existir nenhum campo 'emprestado' na coleção, será adicionado um. Não modifique esse campo diretamente! Os itens emprestados poderão ser declarados como devolvidos com o item do menu ou clicando com o botão direito num item da Área de Empréstimos.

A Janela de Empréstimos do &appname;
A Janela de Empréstimos do &appname;

## Dicas gerais

Se um livro possui vários autores, você deve separar os nomes deles com um ponto e vírgula. O Tellico saberá separá-los e utilizar de forma independente. Qualquer outro campo que permita múltiplos valores deverá ter a mesma estrutura, com um ponto e vírgula (;) separando cada valor.

Você pode alterar quais os campos mostrar na lista, clicando para isso com o botão direito sobre o cabeçalho das colunas.

Você pode adicionar, editar, ou modificar os campos da coleção, usando a Janela de Campos da Coleção. Os botões com uma seta sob a lista dos campos permitem modificar a posição do campo na lista, o que irá afetar a sua posição no editor do item.

Você pode editar mais de um item de cada vez, mantendo pressionada a tecla &Shift; ou &Ctrl; e selecionando vários itens.

Você pode converter uma coleção de livros já existente numa bibliografia, que pode em seguida, ser exportada em formato BibTeX ou BibTeXML.

Se mais de um campo for formatado como nome, então será adicionado um grupo suplementar chamado "Pessoas" à coleção, autorizando que os autores e editores sejam classificados ou impressos juntos, por exemplo.

Você pode modificar a aparência da impressão alterando o arquivo `tellico-printing.xsl`. O arquivo produz &HTML;, e os estilos &CSS; determinam os tipos de fonte, as margens, etc.

Um duplo-clique sobre um item permite abrir o Editor de Itens.

Você pode adicionar marcas &HTML; a um campo de tipo Parágrafo para a sua formatação, como por exemplo <b>bold</b> ou <i>italic</i>.

Na Exibição em coluna, pode pressionar uma letra para ir diretamente para o item seguinte que começar por essa letra.

Você pode usar valores derivados para combinar campos múltiplos separados num só campo. Basta selecionar o tipo Dependente e usar uma descrição similar a "`Valor: %{fielda}%{fieldb}`", onde o %{...} é substituído pelo valor do campo apropriado. Isto é útil para colecionar campos múltiplos num simples campo; &eg;: para melhorar o agrupamento e para combinar campos de diferentes tipos, respeitando a devida ordem ao mesmo tempo. Considere por exemplo um campo numérico seguido de um subcampo de texto com elementos 3b, 14a.