# Usar o &appname;

## Arranque Rápido

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

Os itens novos poderão ser adicionados com o Editor de Itens. O item do menu Colecção Novo Item irá abrir o Editor de Itens com um item vazio, pronto a ser editado. O Editor de Itens pode também ser aberto se usar a opção Configuração Mostrar o Editor de Itens. Assim que tiver introduzido os valores para o item, podê-lo-á gravar na colecção, usando o botão Gravar o Item na janela do Editor de Itens, que permanece aberta no caso de continuar a querer adicionar itens novos. Assim que tiver gravado um item na colecção, podê-lo-á modificar se carregar nele na janela principal. Se o Editor de Itens não estiver já aberto, poderá fazer duplo-'click' sobre um item para abrir o editor e começar a edição.

Se quiser incluir uma mensagem no elemento, poderá usar o Selector de Ficheiros normal do &kde;, carregando para tal no botão Seleccionar uma Imagem... no Editor de Itens, ou poderá ainda arrastar uma imagem do gestor de ficheiros ou navegador Web para o Editor de Itens.

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

Os elementos da colecção são agrupados em conjunto, quando partilham os mesmos valores para determinados campos, como o autor ou o realizador. Poderá modificar o campo usado para o agrupamento, usando a lista na barra de ferramentas ou a opção do menu Configuração Selecção do Grupo.

Poderá usar o Filtro Rápido na barra de ferramentas para limitar rapidamente os itens visíveis para os que contenham a palavra que escrever. O filtro também é útil quando quiser encontrar rapidamente um elemento. Poderá escrever o título ou outra palavra única que identifique o elemento, para que a Área de Colunas mostre apenas os elementos correspondentes ao filtro. A barra de estado mostra quantos elementos existem na colecção, bem como os que estão a ser filtrados de momento.

## Utilização Geral

A janela principal tem três áreas distintas, todas elas apresentando informações sobre a colecção de maneiras diferentes. A área primária é a Área de Colunas no canto superior direito, onde 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 Financiamentos, onde aparecem todos os empréstimos. Finalmente, a Área de Itens mostra uma vista formatada dos dados para um dado 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;

### Área de Colunas

Qualquer um dos campos nas colecções poderá ser apresentado na Área de Colunas, ainda que o Parágrafo, a Imagem e a Tabela possam não ser muito úteis. Se carregar com o botão direito no cabeçalho da janela, abrirá um menu para seleccionar os campos visíveis. As colunas poderão ser dimensionadas e reordenadas de qualquer forma, sendo que a configuração será gravada 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 a seguir ao nome do mesmo. Os grupos poderão ser expandidos ou recolhidos, se carregar no sinal de '+' ou se fizer duplo-click no item. A expansão e fecho de todos os grupos são opções no menu de contexto do botão direito do rato. A árvore poderá ser ordenada pelo nome do grupo ou pela quantidade, carregando no cabeçalho. Um grupo também poderá ser usado como filtro na Área de Colunas, se carregar com o botão direito no item do grupo.

Quando mais que um campo na colecção tiver a opção Formatar como nome activada, 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 gravados alguns filtros para a colecção, a Área de Filtros fica activa. À medida que for adicionando ou modificando os elementos, estes serão validados automaticamente pelos filtros e adicionados ou removidos, conforme o resultado. Poderá modificar o filtro se fizer duplo-click no item para abrir a Janela de Filtros. Se carregar com o botão direito, poderá apagá-los em conjunto.

A Área de Filtros
A Área de Filtros

### Área de Financiamentos

Assim que os elementos vão saindo por empréstimo ou aluguer, é adicionada a Área de Financiamentos à janela, para que esses item emprestados possam ser seguidos. Os empréstimos são seguidos com base em cada elemento pelo que, se carregar com o botão direito num item, possa modificar o empréstimo com a Janela de Financiamentos.

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. Poderá indicar modelos separados para cada tipo de colecção, na Janela de Configuração, em conjunto com tipos de letra e cores personalizados.

Todos os modelos predefinidos respeitam a selecção das cores e tipos de letra, mas poderão existir outros modelos personalizados que não o façam. Os modelos por omissão também tornam os campos de &URL; activos, o que irá abrir os itens com a associação de ficheiros predefinida do &kde;. Ao exportar para &HTML;, é usado o modelo actual para exportar os ficheiros individuais dos elementos.

Para além disso, ao seleccionar vários objectos, aparecerá uma área de ícones, usando o primeiro campo de Imagem na colecção. Os elementos poderão ser seleccionados como acontece na Área de Colunas. Se carregar com o botão direito na área de ícones, irá mostrar um menu que altera os critérios de ordenação dos elementos.

### Barra de Estado

A barra de estado é usada para lhe apresentar o que o &appname; está a fazer de momento. Inclui também a quantidade total de elementos na colecção e, se estiver a ser usado um filtro, quantos estão visíveis de momento.

## Editar os Elementos

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

Os botões das setas no fundo irão mover para os itens anteriores ou seguintes na lista actual.

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

O Editor de Itens
O Editor de Itens

Se carregar no título de um campo &URL;, irá abrir a ligação com a associação de ficheiros predefinida do &kde;. O botão selector do &URL; ao lado do campo de texto irá abrir a janela de Abertura de Ficheiros do &kde;, mas o campo não estará limitado a ficheiros locais.

Para os campos Imagem, o botão Seleccionar a Imagem... abre a janela de selecção de ficheiros do &kde;. A imagem é gravada na colecção com o formato original, sendo apresentada uma versão à escada no Editor de Itens. A imagem poderá ser limpa se usar o botão Limpar. As imagens limpas são removidas da colecçã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 ficheiro de imagem de um gestor de ficheiros ou janela de navegador, fará o mesmo que seleccionar uma imagem no Selector de Ficheiros. Se arrastar uma imagem do item de edição para uma janela de gestão de ficheiros do &konqueror;, irá gravar a imagem nessa pasta.

Por omissão, as imagens são guardadas o ficheiro de dados da colecção, estando tudo contido apenas num local. Contudo, demasiadas imagens farão com que o &appname; se torne significativamente mais lento, dado que irá resultar num ficheiro de dados muito grande. Em alternativa, o &appname; poderá gravar as imagens em separado, seja na pasta `$`KDEHOME`/share/apps/tellico/data/` ou numa pasta no mesmo local do ficheiro de dados. O carregamento e gravação dos ficheiros de dados é muito mais rápido se as imagens forem gravadas em separado, mas os ficheiros 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 Ficheiro 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 Elementos

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

Só os campos activos é que serão modificados quando forem gravados 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 colecção, certifique-se que este campo está activo. Mude-o para DVD e grave 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

### Actualizar os Dados dos Itens

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

Só são actualizados 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 actualização nas opções da fonte.

A actualizaçã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 Colecção Actualizar o Item.

## Editar os Campos

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

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

### Lista de Campos

Do lado esquerdo da janela, existe a lista com os campos actuais. Os campos modificados são mostrado a negrito e itálico. Os botões por baixo 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 predefinido ou alguns valores permitidos. O título é usado em todo o lado para referenciar o campo na interface do utilizador. O Editor de Itens usa-o para pedir valores. A Área de Colunas usa-o como cabeçalho da coluna. Os diferentes tipos de campos são explicados na secçã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. Para além disso, para os campos Derivados, a descrição é usada para formatar o valor do campo. O valor por omissã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 Actual | 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 a começar em maiúsculas, exceptuando 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 desactivada, 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 dos Campos

Os campos também têm três opções gerais. Se a completação automática estiver activa, o &appname; faz 'cache' dos valores para cada campo, oferecendo o Editor de Itens a completação automática, usando a configuração-padrão do &kde;. Nem todos os tipos de campos permitem a completação automática. O &appname; também necessita de 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 active a completação automática, a menos que necessite dela para os campos. Quanto mais campos com completação automática tiver na colecção, mais lento se torna o &appname; a carregar o ficheiro.

## 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 colecçã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. Seleccione o campo correspondente na primeira opção da linha, e seleccione depois uma regra correspondente ao centro. As regras poderão corresponder a determinados valores ou que sejam exactamente iguais. Poderá também usar uma expressão regular para fazer a correspondência dos itens; nesse caso, o botão Editar... fica activo para editar a expressão. Finalmente, a palavra ou texto correspondente deverão ser introduzidos no campo de texto.

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 gravados, 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 actualizado automaticamente. Para gravar o filtro, indique um nome no campo de texto e carregue no botão Gravar o Filtro.

Os filtros gravados anteriormente poderão ser modificados, se carregar com o botão direito do rato no item do filtro na Área de Filtros e seleccionar a opção Modificar o Filtro. A janela do Janela de Filtros é aberta, e 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 colecção actual. 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/`. Como tal, poderá criar novos, para que estes sejam descobertos automaticamente e incluídos como opções na Janela de Relatórios. Alguns relatórios mais complexos poderão levar algum tempo a gerar, no caso de colecções grandes.

Os modelos que são instalados com o &appname; incluem uma lista apenas com os títulos, a vista das colunas por omissã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. Seleccione o modelo desejado e carregue no botão Gerar. Todos os relatórios também poderão ser impressos ou gravados num ficheiro &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 Área de Colunas, por isso, se tiver um filtro activo, a Janela de Relatórios usá-lo-á.

## Registo de Empréstimos

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

O nome da pessoa a quem foi emprestado poderá ser introduzido directamente ou obtido a partir do livro de endereços predefinido do &kde;, carregando no botão a seguir ao item do nome. A data da saída assume-se como sendo a data actual, mas poderá ser alterada. A data-limite é opcional, e poderá ainda adicionar algumas notas sobre o empréstimo.

Se for introduzida uma data-limite e se o &appname; for compilado com o suporte para a 'libkcal', poderá adicionar uma chamada de atenção ao calendário predefinido 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á a true (verdadeiro). Se não existir nenhum campo 'emprestado' na colecção, será adicionado um. Não modifique esse campo directamente! Os itens emprestados poderão ser declarados como devolvidos com o item do menu ou carregando com o botão direito num item da Área de Financiamentos.

A Janela de Financiamentos do &appname;
A Janela de Financiamentos do &appname;

## Sugestões Gerais

Este é o conjunto de dicas contido na lista "Dica do Dia" para o &appname;.

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

Pode alterar quais os campos a mostrar na lista, carregando para tal com o botão direito sobre o cabeçalho das colunas.

Pode adicionar, editar, ou modificar os campos da colecção, utilizando o Janela de Campos da Colecção. Os botões com uma seta sob a lista dos campos permitem modificar a posição do campo na lista, o que irá afectar a sua posição no editor do item.

Se quiser filtrar a partir de um campo do tipo Marcador, deverá ser definido um valor "verdadeiro". Se quiser, por exemplo, mostrar só os livros de ficção científica que ainda não leu, assinale a opção Corresponder a todas as seguinte, ajuste a primeira como se segue: "Género" "contém" "Ficção científica" (sem aspas) e a segunda regra assim: "Lido" "Não contém" "Verdadeiro" (sem aspas).

Se um carácter não alfabético for utilizado na filtragem rápida, o texto é interpretado como uma expressão regular. Para mostrar somente os livros de Weber ou Bujold por exemplo, escreva "weber|bujold" (sem aspas) no campo do filtro.

Pode editar mais de um item de cada vez, carregando e pressionando a tecla &Shift; ou &Ctrl; e seleccionando vários itens.

Pode converter uma colecçã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" à colecção, autorizando que os autores e editores sejam classificados ou impressos juntos, por exemplo.

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

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

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 Área de Colunas, pode carregar uma letra para ir directamente para o item seguinte que começar por essa letra.

Pode usar valores derivados para combinar campos múltiplos separados num só campo. Basta seleccionar 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 coleccionar 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 sub-campo de texto com elementos 3b, 14a.