Manual do Tellico

# Manual do Tellico

Robby Stephenson `<robby@periapsis.org>`

Tradução: Marcus Gama
Tradução: André Marcelo Alvarenga
revisão Tellico 3.2 (12/05/2019)

Copyright © 2001-2019 Robby Stephenson

Para informações de licenciamento do programa e sua documentação, por favor acesse a última seção.

Este documento é um manual para usar o Tellico, um aplicativo para gerenciar coleções.

Lista de Tabelas

2.1. Mudanças de Tipo de Campo Permitidas
2.2. Exemplos de Formatação
7.1. Valores do Tipo de Coleção
7.2. Valores do Tipo de Campo
7.3. Valores das Opções dos Campos
7.4. Valores dos Formatos dos Campos

Capítulo 1. Introdução
Introdução

# Capítulo 1. Introdução

## Tellico

O Tellico é um programa para gerenciar coleções. Ele começou com um gestor de coleções de livros simples, expandindo-se para incluir modelos de coleções padrão para bibliografias, revistas em quadrinhos, vídeos, música, moedas, selos, cartões, jogos de console, vinhos, jogos de tabuleiro e listagens de arquivos. Além disso, você poderá criar coleções personalizadas para qualquer outro tipo de item colecionável.

### O que é o Tellico

O Tellico mantém um registro dos itens numa coleção, oferecendo uma forma simples de inserir dados para cada item. Oferece diversos tipos de campos, permitindo um número ilimitado de campos definidos pelo usuário. Os itens de uma coleção poderão ser agrupados por qualquer campo, para uma organização simples, e você poderá personalizar vistas que mostram tanta informação quanta desejar.

Empréstimos de itens da sua coleção podem ser rastreados, incluindo a data de vencimento. Poderá importar ou exportar as coleções em uma variedade de formatos, para permitir um intercâmbio ou publicação simples de dados.

### O que o Tellico não é

O Tellico não é um leitor de áudio ou vídeo. Não oferece capacidades de ler ou modificar arquivos multimídia. Também não oferece nenhuma capacidade de edição de imagens. Ainda que o Tellico tenha alguma funcionalidade para gerenciar listas bibliográficas, ele não é um gestor de referências bibliográficas completo. O Tellico também não pretende ter todas as potencialidades de uma base de dados relacional completa.

Como uma espécie de nota final, o Tellico é um passatempo do autor, e não são dadas quaisquer garantias sobre a sua funcionalidade, utilidade, etc. Você poderá encontrar mais informações na declaração da licença.

Terminologia
Terminologia

## Terminologia

### Coleções

No Tellico, uma coleção é o documento. Só poderá existir uma coleção em cada arquivo do Tellico. Uma coleção contém um número qualquer de campos e itens. O Tellico suporta 12 tipos de coleções específicos por padrão: livros, itens bibliográficos, revistas em quadrinhos, vídeos, música, cartões para troca, moedas, selos, jogos de console, vinhos, jogos de tabuleiro e listagens de arquivos. Além disso, está disponível um modelo de coleção genérico e vazio para outros tipos de itens colecionáveis.

### Campos da Coleção

Cada coleção poderá ter um número ilimitado de campos. O Tellico suporta onze tipos de campos, que permitem uma gama de dados diferente. Os campos poderão ser editados com o Janela dos Campos da Coleção e são explicados mais à frente na seção de Tipos de Campos.

### Itens da Coleção

Um item é o registro básico no Tellico. Cada item contém um único valor para cada campo da coleção. Uma coleção poderá ter um número ilimitado de itens, em teoria, se bem que a coleção completa está sempre residente em memória, o que poderá contribuir para diminuir o desempenho da aplicação, no caso de ter muitos itens.

O Tellico foi testado com uma coleção de 10.000 itens, e a velocidade foi considerada satisfatória. Contudo, se incluir muitas imagens grandes na coleção, o tempo de carregamento e processamento poderão aumentar drasticamente. A performance poderá ser melhorada se o Tellico guardar as imagens em separado do arquivo de dados, seja na pasta da aplicação ou numa pasta relativa ao arquivo de dados. Você poderá obter mais informações na seção de configuração.

Capítulo 2. Usando o Tellico
Usando o Tellico

# Capítulo 2. Usando o Tellico

## Início Rápido

Por padrão, o Tellico 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. A barra de estado mostra quantos elementos existem na coleção, bem como os que estão sendo filtrados no momento.

Uso Geral
Uso Geral

## 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.

### 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 de Filtros. Se clicar com o botão direito, poderá apagá-los em conjunto.

### Á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.

### Á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 Tellico 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
Editar os Itens

## 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.

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 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.

### Atenção

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 Tellico se torne significativamente mais lento, uma vez que irá resultar num arquivo de dados muito grande. Em alternativa, o Tellico 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.

### 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.

### 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
Editar os Campos

## 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.

### 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:

Tabela 2.1. 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 Tellico 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.

Tabela 2.2. 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 Tellico 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 Tellico 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 Tellico ao carregar o arquivo.

Filtrar os Itens
Filtrar os Itens

## 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.

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.

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
Gerar Relatórios

## Gerar Relatórios

O Tellico 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 Tellico 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.

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
Registro de Empréstimos

## Registro de Empréstimos

O Tellico 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 Tellico 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.

Dicas gerais
Dicas gerais

## Dicas gerais

Este é o conjunto de dicas contido na lista "Dica do Dia" para o Tellico.

### Dica

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.

### Dica

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

### Dica

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.

### Dica

Se você 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 seguintes, 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).

### Dica

Se um caractere 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.

### Dica

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

### Dica

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

### Dica

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.

### Dica

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.

### Dica

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

### Dica

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>.

### Dica

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

### Dica

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; por exemplo: 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.

Capítulo 3. Detalhes do Tellico
Detalhes do Tellico

# Capítulo 3. Detalhes do Tellico

## Tipos de Campos

Cada coleção poderá ter um número ilimitado de campos. O Tellico 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 URLs 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 URLs relativas. Eles são interpretados em relação à localização do arquivo de dados do Tellico. 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 Tellico 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
Tipos de Coleções

## Tipos de Coleções

O Tellico 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 Tellico 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 Tellico 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 27 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, Resumo da Ação 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 Tellico 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 Tellico 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 Tellico tem de fato algumas funções especializadas para bibliografias. Você pode adicionar, modificar ou apagar macros do texto do Bibtex dentro do Tellico; 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 23 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, Resumo da ação 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, Tempo de Jogo, Idade Mínima, 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.

Capítulo 4. Importar e Exportar Dados
Importar e Exportar Dados

# Capítulo 4. Importar e Exportar Dados

O Tellico é capaz de importar e exportar uma grande variedade de arquivos de dados, assim como pesquisar em vários serviços da Internet para obter informações.

## Importando da Internet

O Tellico é capaz de pesquisar em vários serviços da Internet com a Janela de Pesquisa na Internet. Os itens poderão ser importados e adicionados diretamente à sua coleção atual. Os vários fornecedores são configurados com as Opções das Fontes de Dados.

As pesquisas poderão usar critérios diferentes: o Título, a Pessoa, o ISBN, o UPC/EAN o LCCN ou a Palavra-Chave. Nem todos os critérios estão disponíveis para todas as fontes de dados. Os valores do ISBN e do LCCN são somente para livros, enquanto os valores do UPC e do EAN podem ser aplicados a qualquer tipo de item.

Logo que inicie uma pesquisa, o botão Procurar tornar-se-á Parar, de modo a interromper uma pesquisa. À medida que forem encontrados resultados, eles são adicionados diretamente à lista sob o campo de pesquisa; a seleção de um item irá mostrar o resultado sem o adicionar à coleção. Se clicar no botão Adicionar um Item, irá adicionar todos os itens selecionados à sua coleção. Se a fonte de dados tiver mais resultados do que os pedidos inicialmente, o botão Obter Mais Resultados ficará ativo. Clicar em Limpar, irá remover todos os resultados atuais e limpar a pesquisa.

Somente os itens correspondentes ao tipo de coleção atual serão encontrados. A coluna da Descrição oferece informações adicionais sobre o item, de modo a diferenciar entre os vídeos com diferentes formatos ou os livros com diferentes encadernações, por exemplo. Assim que um item for adicionado com sucesso à coleção, é feita uma marcação na primeira coluna na lista.

Você poderá adicionar vários itens de uma vez, usando o método-padrão do KDE de seleção múltipla, que envolve normalmente a utilização das teclas Shift ou Ctrl enquanto clica num item.

Para facilitar a utilização de leitores de códigos de barras, as pesquisas poderão incluir vários valores de ISBN/UPC. A seleção da opção Pesquisa por ISBN/UPC múltipla irá desativar o campo de pesquisa e ativar o botão Editar os valores de ISBN/UPC..., que irá abrir um campo de inserção de texto multi-linhas. Cada ISBN deverá ser inserido numa linha própria. Depois de fechar a janela, cada um dos ISBNs será validado à procura da formatação correta. A validação do ISBN é capaz de converter os valores de 13 algarismos do EAN, assim como os códigos completos do UPC, para uma formatação correta. A lista de ISBNs poderá também ser lida a partir de um arquivo de texto.

Importar Dados
Importar Dados

## Importar Dados

O Tellico oferece três ações diferentes quando importa os dados. A Substituir a coleção atual irá fechar a coleção atual, criando uma nova com os dados do arquivo importado. A Adicionar à coleção atual diz ao Tellico para adicionar todos os itens na coleção importada à atual, assim como para adicionar os campos que atualmente não existam. A ação Mesclar a coleção é a mesma que a adição, exceto que cada item importado é comparado com os atuais, sendo que os itens idênticos são descartados. O Tellico tenta identificar entradas correspondentes que não são completamente idênticas, comparando campos significativos e, em seguida, fará a mesclagem das entradas. Por exemplo, as coleções de músicas comparam o artista e o álbum, sendo que as faixas deveriam ser mescladas para os itens correspondentes. O módulo de importação de arquivos de áudio é capaz de construir corretamente as listagens de faixas ao mesclar os itens.

### Importação de dados a partir de outro software

O Tellico consegue importar dados diretamente de uma variedade de outros programas de gerenciamento de coleções, como GCstar, Alexandria, Delicious Library, Ant Movie Catalog, Referencer e Griffith.

### Importação de outros formatos de dados

O Tellico pode importar os dados de uma variedade de outros formatos de arquivo, incluindo CSV, Bibtex, discos de áudio e arquivos, MODS, PDF e RIS.

#### Importar Dados do Tellico

Poderão ser importados diretamente outros arquivos de dados do Tellico. A substituição da coleção atual, através da importação de um arquivo de dados do Tellico, é a mesma coisa que abrir o próprio arquivo. O valor da importação dos dados do Tellico é apenas para adicionar ou mesclar duas coleções.

#### Importando os Dados em CSV

Os valores separados por vírgulas (CSV) são uma forma comum de importar e exportar dados em tabelas. Cada valor do campo é separado por uma vírgula, com um item por linha. Os títulos dos campos podem ser incluídos na primeira linha. O módulo de importação de CSV não está limitado apenas a usar uma vírgula como separador. Você poderá usar qualquer caractere ou sequência de texto.

Primeiro, selecione o tipo de coleção que está importando. Se estiver adicionando ou mesclando à coleção atualmente aberta, o tipo é limitado ao tipo da sua coleção atual. Se a primeira linha do arquivo CSV tiver os títulos dos campos, clique na opção para que o módulo de importação compare automaticamente os títulos com os campos da coleção atual. Se o título de um campo corresponder, o cabeçalho dessa coluna muda para mostrar que a coluna foi associada a esse campo. Se o arquivo usar um separador que não seja uma vírgula, certifique-se de alterar a opção de acordo com isso.

Para que o Tellico importe convenientemente o arquivo, ele deverá saber qual o campo que corresponde a cada coluna. Se a coluna só tiver um número no cabeçalho, os dados nessa coluna não serão importados. Você deverá atribuir os campos a cada coluna, selecionando uma coluna com o mouse ou alterando número da coluna em si, e depois selecionando o campo a atribuir a partir da lista e, finalmente, clicando no botão Atribuir o Campo. Se quiser adicionar um campo novo à coleção, o último item na lista abre a Janela de Campos da Coleção.

Por questões de compactação, apenas as primeiras cinco linhas do arquivo CSV importado serão mostradas na caixa de diálogo. Contudo, serão importadas todas as linhas do arquivo.

#### Importar Dados de CD's de Áudio

O Tellico é capaz de usar o serviço do freedb.org para consultar informações sobre um CD, incluindo a lista de faixas. Dependendo da sua distribuição, a configuração do acesso ao serviço poderá ser definida nas Configurações do sistema do KDE. O artista do CD, o título, o gênero, o ano e a lista das faixas são todos adicionados.

Além disso, se o disco tiver CD-Text, essa informação é lida e adicionada ao item importado.

#### Importar os metadados dos arquivos de áudio

O Tellico é capaz de percorrer uma pasta e ler as marcas dos formatos de arquivos de áudio comuns, como o `mp3` e o `ogg`. As músicas são inseridas numa coleção de músicas, onde cada item é um álbum. Se os arquivos de música tiverem o número de faixa, o nome da música é inserido no local correto da lista de faixas. A informação do artista e do gênero também é adicionada ao item. Se as marcas da música tiverem comentários, estes serão adicionados ao campo de 'comentários' do item, antecedido pelo nome do arquivo.

Além disso, se uma pasta tiver um arquivo `.directory` e o nome da pasta corresponder ao título de um álbum, o item `Ícone` no arquivo '.desktop' é usado como imagem de capa para o álbum.

O módulo de importação de metadados de arquivos de áudio pode percorrer uma pasta de forma recursiva, de modo a encontrar todos os arquivos de áudio em qualquer subpasta, ainda que as ligações simbólicas não sejam seguidas. O Tellico usa a biblioteca TagLib para ler os metadados do arquivo de áudio, para que possa importar os dados de qualquer tipo de arquivo que esta biblioteca reconheça.

#### Importar Dados do Bibtex

Bibtex é um formato bibliográfico usado com o sistema de preparação de documentos LaTeX. Você poderá incluir diversos tipos de referências bibliográficas no arquivo. O Tellico importa os arquivos do 'bibtex' como uma coleção bibliográfica.

Se o módulo de importação do 'bibtex' encontrar campos no arquivo que não estejam na coleção bibliográfica padrão, eles serão adicionados como campos de Texto Simples, com duas exceções. Se o valor do campo tiver mais de 100 caracteres, tornar-se-á um campo de Parágrafo. Se o valor do campo parecer ter um URL ou uma referência de arquivos, então será criado um campo de URL. O Tellico usa uma cópia interna da biblioteca do 'btparse' para processar os arquivos do bibtex.

Bibtexml é uma representação em XML dos dados do 'bibtex', onde os dados do arquivo 'bibtexml' são tratados da mesma forma que seriam os dados do 'bibtex'.

#### Importar Dados do MODS

O MODS é um formato para representar diversos tipos de coleções de conteúdos. Atualmente, só são importados livros pelo Tellico, como uma coleção bibliográfica.

#### Importar Dados em PDF

Se o Tellico foi compilado com o suporte para o exempi ou o poppler, os metadados dos arquivos PDF poderão ser importados. Os metadados poderão incluir o título, o autor e a informação da data, assim como alguns identificadores bibliográficos que são então usados para atualizar outros dados.

#### Importar Dados do RIS

O RIS é um formato de arquivos bibliográficos usado pelo EndNote, Reference Manager, entre outros. O Tellico importa arquivos RIS como uma coleção bibliográfica.

### Importação de coleções online

O Tellico consegue-se conectar e importar dados de páginas Web que gerenciam coleções pessoais.

#### Importar coleção do BoardGameGeek

O BoardGameGeek é um recurso online de jogo de tabuleiro e comunidade. O Tellico pode importar os jogos de computador na coleção do usuário, desde que a coleção esteja definida para ser publicamente acessível. A coleção importada pode ser limitada a esses itens marcados como seus.

#### Importar coleção do Goodreads

O Goodreads é uma rede social online de leitores para procurar por coleções de livros. O Tellico pode importar a lista de livros em uma coleção de usuário, fornecendo-se o nome do usuário ou sua ID, caso a coleção esteja configurada como pública.

### Importar Listagens de Arquivos

A melhor forma de criar um Catálogo de arquivos é importar o conteúdo de uma pasta. A mesma pasta poderá ser percorrida de forma recursiva, para adicionar todos os arquivos encontrados dentro dela. Esta importação é mais útil para as listagens de cópias de segurança e para o catálogo de conteúdos, como as listagens de CDs ou DVDs. Além disso, as previsões das imagens do conteúdo do arquivo poderão ser geradas, ainda que isso leve algum tempo para ler uma grande quantidade de arquivos. As previsões dos arquivos são as mesmas que aparecem no gerenciador de arquivos do KDE.

### Importar Dados em XML com XSLT

Qualquer arquivo XML poderá ser importado para o Tellico, desde que exista uma folha de estilo XSL disponível para converter o arquivo para o formato do Tellico. O Tellico carrega automaticamente essa folha de estilo e aplica o processamento de XSLT necessário para carregar o arquivo.

Arrastar e Soltar
Arrastar e Soltar

## Arrastar e Soltar

O arrastamento de arquivos de dados para a janela principal do Tellico e a posterior soltura dos mesmos irá importá-los, como se fosse invocado o comando de importação a partir dos menu. O processo de 'arrastar e soltar' funciona para os seguintes formatos de arquivos: Tellico, Bibtex, RIS e PDF. A importação de vários arquivos de uma vez também é suportada.

Por isso, por exemplo, se quiser catalogar diversos arquivos PDF, selecione-os no gerenciador de arquivos e arraste-os para a janela do Tellico. O Tellico irá importar tantos metadados dos arquivos quanto conseguir, obtendo depois a informação adicional a partir das diversas fontes na Internet configuradas.

Exportar Dados
Exportar Dados

## Exportar Dados

Ao exportar os dados na coleção, os valores dos itens poderão ser exportados tal como foram inseridos, ou então com a formatação automática oferecida pelo Tellico. Adicionalmente, a exportação poderá estar limitada aos itens selecionados atualmente na coleção, onde a barra de estado mostra o número de itens selecionados.

Os arquivos de texto exportados, como o Bibtex ou o CSV, poderão usar a codificação de caracteres Unicode (UTF-8) ou ainda a codificação local do sistema operacional.

### Exportar para XML

O formato do arquivo de dados do Tellico é um arquivos XML comprimido com o ZIP. A exportação para XML simplesmente cria o arquivo XML sem o comprimir. As imagens poderão ser incluídas no arquivo XML como dados codificados em 'base64' num elemento de imagem; porém, ao fazê-lo, poderá criar arquivos de dados muito grandes.

### Exportar para ZIP

O formato de arquivo padrão para o Tellico é um arquivo comprimido com o ZIP, contendo o arquivo de coleção em XML e, opcionalmente, todas as imagens referenciadas na coleção. Se as imagens forem guardadas na pasta da aplicação, a exportação para um arquivo ZIP irá criar um arquivo de dados autônomo, que contém todas as imagens na coleção.

### Exportar para HTML

A exportação para HTML usa a folha de estilo `tellico2html.xsl`. As imagens são exportadas para uma pasta com o mesmo nome que o arquivo HTML exportado, adicionando o texto `_files`.

O formato padrão é similar ao resultado impresso, permitindo várias opções para modificar o HTML. Os cabeçalhos dos campos poderão ser impressos no topo de cada coluna; porém, infelizmente, o KDE não permite ainda a repetição dos cabeçalhos das tabelas em cada página. Os itens também poderão ser agrupados, como acontece na Área de Grupos.

Além disso, você poderá criar arquivos individuais para cada item na coleção, com as referências criadas no arquivo HTML de topo. Os arquivos dos itens serão criados na mesma pasta que as imagens. Os arquivos HTML dos itens irão usar o modelo da folha de estilo atual, tal como aparece na Área de Itens.

### Exportar para CSV

Os valores separados por vírgulas (CSV) são uma forma comum de importar e exportar dados em formato de tabela. Cada valor do campo é separado por uma vírgula, existindo um item por cada linha. Os títulos dos campos poderão ser incluídos como cabeçalhos na primeira linha. Todos os caracteres ou sequências de texto que não sejam uma vírgula também poderão ser usados para delimitar os campos.

### Exportar para o Alexandria

Alexandria é um gerenciador de coleção de livros alternativo para o ambiente de trabalho GNOME. O Tellico é capaz de exportar um subconjunto limitado dos campos das coleções de livros para a localização padrão do Alexandria.

### Exportar para o ONIX

ONIX é um formato em XML para representar e comunicar informações de produtos da indústria de livros, principalmente para os vendedores de livros. O Tellico consegue exportar as coleções de livros com um subconjunto do ONIX.

### Exportar para o Bibtex

Ao exportar para o Bibtex, os valores dos campos poderão ser marcados com parênteses ou marcas de citação. Se forem usadas algumas macros de texto na coleção, elas poderão ser exportadas opcionalmente como macros ou expandidas. Para os campos URL, o Tellico poderá envolver os valores dos campos com a marca `\url{...}`. Finalmente, os itens sem chave de citação poderão ser ignorados em vez de ter o Tellico gerando automaticamente a chave.

### Exportar para GCstar

O GCstar é outro gerenciador de coleções de filmes. O Tellico é capaz de exportar a maioria dos tipos de coleção para um arquivo de dados GCstar.

### Exportar para XML com o XSLT

Finalmente, o Tellico consegue processar a sua representação interna em XML dos dados da coleção, através de uma folha de estilo XSL externa, antes da exportação. Este tipo de exportação poderá ser útil para gerar relatórios de texto ou outros tipos de arquivos.

Trabalhar com Citações
Trabalhar com Citações

## Trabalhar com Citações

Ao trabalhar numa bibliografia, as citações para os itens selecionados poderão ser geradas e usadas em muitos outros aplicativos. Uma citação no formato 'bibtex' poderá ser copiada para a área de transferência e depois colada num arquivo em LaTeX. As citações do Bibtex poderão também ser enviadas para um aplicativo externo, como o LyX ou o Kile, usando o mecanismo conhecido do lyxpipe.

Capítulo 5. Uso avançado
Uso avançado

# Capítulo 5. Uso avançado

## Opções de Linha de Comando

Ao executar o Tellico a partir da linha de comando, existem várias opções para abrir os arquivos de dados. Elas poderão ser consultadas com o comando `tellico --help`.

    Uso: tellico [opções] [arquivo]

    Tellico - um gerenciador de coleções do KDE

    Opções:
      --nofile                  Não reabrir o último arquivo aberto
      --bibtex                  Importar o <arquivo> como um arquivo bibtex
      --mods                    Importar o <arquivo> como um arquivo MODS
      --ris                     Importar o <arquivo> como um arquivo RIS

    Argumentos:
      arquivo                  O arquivo a abrir

Interface D-Bus
Interface D-Bus

## Interface D-Bus

O Tellico tem uma interface mínima de D-Bus, que pode ser usada para programar ou interagir com uma aplicação em execução, a partir da linha de comando. Como acontece com todas as chamadas de D-Bus, você terá que indicar a aplicação com que deseja interagir, assim como a interface em particular. O nome do serviço de D-Bus é `org.kde.tellico`.

### Comandos do D-Bus

Estão disponíveis dois objetos D-Bus na interface do Tellico: `Tellico` e `Collections`.

#### O Objeto `Tellico`

A lista completa de comandos de D-Bus do objeto `tellico` encontra-se disponível abaixo:

    bool importTellico(QString arquivo, QString ação)
    bool importBibtex(QString arquivo, QString ação)
    bool importMODS(QString arquivo, QString ação)
    bool importRIS(QString arquivo, QString ação)
    bool exportXML(QString arquivo, bool filtrado)
    bool exportZip(QString arquivo, bool filtrado)
    bool exportBibtex(QString arquivo, bool filtrado)
    bool exportHTML(QString arquivo, bool filtrado)
    bool exportCSV(QString arquivo, bool filtrado)
    QList<int> selectedEntries()
    QList<int> filteredEntries()
    void openFile(QString arquivo)
    void setFilter(QString texto)
    bool showEntry(int id)

Para os quatro comandos de importação, o primeiro argumento é o arquivo a importar, e o segundo é a ação de importação. Três ações estão disponíveis: replace (substituir), append (adicionar), e merge (mesclar). Quatro formatos de arquivo são suportados para importação: arquivos XML Tellico, arquivos Bibtex, arquivos MODS e arquivos RIS.

A coleção atualmente aberta no Tellico poderá ser exportada para um arquivo no formato XML ou ZIP, ambos do Tellico, em Bibtex, HTML ou valores separados por vírgulas (CSV). Os comandos de exportação recebem um argumento opcional para indicar se a coleção deve ser limitada ao filtro atual ou não.

Uma lista dos IDs dos elementos atualmente selecionados ou filtrados permite facilitar a apresentação ou atualização dos itens na janela.

Você poderá abrir um novo arquivo de dados com o comando openFile(). Deverá indicar a localização completa.

Poderá definir um novo filtro com o comando setFilter(), o qual é o equivalente a escrever o mesmo filtro no campo respectivo da janela principal.

Fornecido um ID de um elemento, o showEntry() irá selecionar esse item e mostrar os seus detalhes na janela principal.

#### O Objeto `Collections`

A lista completa de comandos D-Bus do objeto `Collections` encontra-se descrita abaixo:

    int addEntry()
    bool removeEntry(int idItem)
    QStringList allValues(QString nomeCampo)
    QStringList entryValues(int idItem, QString nomeCampo)
    QStringList selectedBibtexKeys()
    QString entryBibtexKey(int idItem)
    bool setEntryValue(int idItem, QString nomeCampo, QString valor)
    bool addEntryValue(int idItem, QString nomeCampo, QString valor)

Você poderá criar um novo elemento vazio na coleção atual, usando o comando addEntry(). O valor devolvido é o ID do elemento, que poderá ser usado para definir os valores dos campos do mesmo elemento. Você poderá apagar um elemento da coleção com o comando removeEntry().

Se invocar o allValues() com apenas um nome de campo, irá devolver todos os valores desse campo, para os itens selecionados no momento. Se não for selecionado nenhum elemento, é devolvida uma lista vazia. Se for incluído um ID de elemento no comando, são devolvidos os valores dos campos para esse elemento em particular.

Se a coleção atual for uma bibliografia, a invocação do selectedBibtexKeys() irá devolver a citação do Bibtex para todos os itens selecionados. A 'bibtexKey' de um item específico poderá ser obtida com o comando entryBibtexKey().

Você poderá editar os elementos diretamente com a interface D-Bus. Fornecido um ID de elemento, o setEntryValue() irá configurar o valor do campo diretamente. Para adicionar um valor, sem afetar os valores existentes, use o addEntryValue(). O novo valor é adicionado ao fim da lista existente.

### Exemplos de D-Bus

Aqui estão alguns exemplos de programação da Tellico usando a interface D-Bus.

    Abrir um arquivo do Bibtex
    % qdbus org.kde.tellico /Tellico org.kde.tellico.importBibtex "/home/roberto/referência.bib" "replace"
    true

    Exportar um arquivo do Bibtex
    % qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documentos/referência.bib
    true

    Exportar um arquivo do Bibtex usando o filtro atual
    % qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documentos/referência.bib true
    true

    Apresentar a chave de citação da seleção atual
    % qdbus org.kde.tellico /Collections org.kde.tellico.selectedBibtexKeys
    stephenson2004

    Adicionar um novo elemento e modificar o título
    % o_meu_id=`qdbus org.kde.tellico /Collections org.kde.tellico.addEntry`
    % qdbus org.kde.tellico /Collections org.kde.tellico.setEntryValue $meu_id título "Meu Livro Novo"
    true

Capítulo 6. Configuração
Configuração

# Capítulo 6. Configuração

A Janela de Configuração contém todas as opções para alterar algum comportamento padrão do Tellico.

Clicar no botão Aplicar, fará com que as alterações tenham efeito imediato sem fechar a janela, enquanto o OK aplica as alterações e fecha a janela. O Cancelar fecha a janela, mas irão permanecer as opções anteriores. O botão Padrões reverte as opções na página atual da janela para os seus valores padrão, enquanto a Ajuda abre o KHelpCenter com a seção relativa do manual do Tellico.

Algumas opções menores só poderão ser alteradas se editar o próprio arquivo de configuração. Veja as Opções Ocultas.

## Opções gerais

As Opções Gerais controlam o comportamento geral. As imagens poderão ser incluídas nos arquivos de dados ou salvas separadamente na pasta da aplicação Tellico. Do mesmo modo, quando for iniciado o Tellico, você poderá reabrir automaticamente o último arquivo de dados que foi aberto. A janela da Dica do Dia contém sugestões úteis sobre a utilização do Tellico e aparece na inicialização do programa. Você poderá querer seguir algumas das sugestões e depois desativar a janela.

As Opções de Formatação controlam o nível de formatação automática que o Tellico efetua. Por exemplo, veja a seção de Formatação dos Campos. A capitalização e a formatação são opções distintas, uma vez que um campo poderá ser capitalizado sem ter a ordem das palavras alterada e vice-versa. A capitalização automática poderá ser alterada para ignorar certas palavras. A formatação automática inclui os artigos gramaticais nos títulos, em conjunto com os prefixos e sufixos para os nomes pessoais. Os valores não fazem distinção de maiúsculas e deverão estar separados por um ponto e vírgula.

As regras de formatação seguem o uso geral do Inglês, que poderá não funcionar para as outras línguas. Os nomes pessoais são formatados para ter o último nome em primeiro lugar, seguido de uma vírgula e, finalmente, pelo primeiro nome. Os sufixos pessoais, como o Jr., são salvos com o último nome. Os prefixos, como o von, são mantidos com o último nome, mas são ignorados quando os valores forem ordenados.

John Q. von Public, III tornar-se-ia von Public, III, John Q. e Public seria usado como chave de ordenação.

Só são suportados os prefixos de palavra únicas. Se um nome incluir van der, por exemplo, tanto o van como o der deveriam ser incluídos na lista de prefixos do apelido. Os artigos terminando com um apóstrofo são suportados para fins de ordenação, também.

### Nota

Os valores atuais na coleção não são alterados; apenas o texto visível usado para a interface. Assim, as opções de formatação poderão ser alteradas de volta, sem alterar nenhum dos dados na coleção.

Opções de Impressão
Opções de Impressão

## Opções de Impressão

O Tellico usa um serviço de XSLT para criar HTML e depois passa-o ao serviço de impressão do KDE. Somente os campos visíveis na Área de Colunas são impressos. Além disso, se a coleção for filtrada, só são impressos os itens visíveis. Inicialmente, uma mensagem de aviso será apresentada se a filtragem estiver ativa.

As Opções de Impressão permitem-lhe alterar alguma da formatação ao imprimir uma coleção. Se a opção Formatar os títulos e os nomes estiver assinalada, então os campos serão formatados automaticamente quando forem impressos. Caso contrário, serão impressos tal como foram inseridos.

A folha de estilo para impressão padrão imprime a coleção com os valores dos campos por colunas. A opção Imprimir os cabeçalhos dos campos controlam se o título do campo é impresso no topo da coluna.

Na impressão, os itens serão ordenados como aparecem na Área de Colunas. Além disso, poderão ser agrupados como estão na Área de Grupos.

Finalmente, quando são incluídos campos de imagens na impressão, elas poderão ser dimensionadas, embora mantenham as suas proporções. A largura e altura máximas da imagem definem o maior tamanho possível da imagem, se bem que isto nunca será aumentado.

Opções do Modelo
Opções do Modelo

## Opções do Modelo

A Área de Itens usa os modelos para mostrar os valores dos campos. Você poderá indicar um modelo diferente para cada tipo de coleção. Alguns modelos, como os de Álbum ou Vídeo são para um tipo específico de coleção, sendo que aparecerá uma breve mensagem de erro na Área de Itens se forem usados para outros tipos. O botão de Previsão mostra uma janela que lhe permite antever como irá ficar o modelo. Você poderá passar tipos de fonte e cores personalizados ao modelo; de fato, todos os modelos padrão respeitam essa configuração. Contudo, os modelos personalizados poderão optar por ignorá-los.

Você poderá instalar modelos adicionais diretamente, ou ainda obtê-los a partir do store.kde.org, clicando no botão Baixar. Todos os modelos instalados pelo usuário poderão também ser removidos. Os modelos dos itens são guardados em `$`KDEHOME`/share/apps/tellico/entry-templates/`.

Se você criar um novo modelo, pense por favor em enviá-lo para o store.kde.org!

Opções da fonte de dados
Opções da fonte de dados

## Opções da fonte de dados

O Tellico poderá usar diversas fontes para importar os dados, que poderão ser configuradas na Janela de Fontes de Dados. Existem diversos tipos e fontes disponíveis. Alguns deles estão listados abaixo, mas a lista completa está disponível na página Web do Tellico.

- Serviços Web da Amazon.com,
- a Internet Movie Database,
- AlloCiné,
- servidores z39.50,
- servidores SRU,
- bases de dados Entrez (PubMed),
- AnimeNfo.com,
- BDGest,
- ISBNdb.com,
- arxiv.org,
- Discogs.com,
- TheMovieDB.org,
- TheGamesDB.net,
- OMDBAPI.com,
- MusicBrainz.org,
- GiantBomb.com,
- OpenLibrary.org,
- outros programas ou aplicativos externos e
- combinações de quaisquer umas das fontes acima.

Você poderá adicionar fontes novas clicando no botão Nova..., enquanto poderá modificar ou apagar as existentes, usando os botões Modificar... ou Apagar. A ordem das fontes, que aparece nos menus de atualização dos itens, também poderá ser alterada.

### Atenção

Nunca instale nem execute um programa de uma fonte desconhecida. Eles são executados com as mesmas permissões do usuário; por consequência, podem modificar ou apagar arquivos ou ainda embaralhar o seu sistema.

Muitas das fontes de dados oferecem mais informações que os campos padrão do Tellico. Esses outros campos aparecem à direita da área de configuração. Se qualquer desses campos estiver assinalado, serão adicionados à coleção quando um item for adicionado a partir dessa fonte.

### Fontes de Dados Bibliográficas

#### Servidores z39.50

O protocolo z39.50 é usado para acessar a bibliotecas e a fornecedores de informações bibliográficas por todo o mundo. As listas dos servidores públicos de z39.50 estão disponíveis no indexdata.dk, entre outros. O Tellico vem com diversas configurações predefinidas para as bibliotecas principais, sendo que você pode ainda indicar manualmente a informação da conexão.

O Tellico é capaz de ler dados nos formatos MODS, USMARC/MARC21 ou UNIMARC, usando a biblioteca 'yaz'. Além disso, existe um suporte limitado para o formato GRS-1.

Para usar uma das bibliotecas predefinidas, assinale a opção e selecione depois a biblioteca. Os outros itens de configuração ficarão inativos. Se precisar definir manualmente a informação, desligue a opção predefinida.

A porta padrão para os servidores z39.50 é a 210, mas alguns servidores poderão usar uma diferente. O Tellico assume que o servidor usa a codificação de caracteres MARC-8, a menos que seja configurado em contrário. Caso seja usada uma codificação errada, irá aparecer uma mensagem de erro no resultado do programa, ou possivelmente nenhum item será obtido.

Alguns servidores necessitam de um usuário e uma senha para o acesso. O Tellico pode usar e salvar essa senha, mas saiba que ela é salva no arquivo de configuração do Tellico como texto simples, não sendo assim segura. Para a maioria dos servidores públicos, o usuário e a senha poderão ser deixados em branco.

#### Servidores SRU

SRU significa Search/Retrieve via URL e é um protocolo de pesquisa-padrão para pesquisas na Internet. Algumas bibliotecas usam-no para oferecer o acesso aos seus catálogos de dados. Entre elas, a Biblioteca do Congresso dos EUA é provavelmente a mais conhecida.

#### Bases de Dados Entrez

O Entrez é o sistema integrado, de pesquisa por texto e de extração usado no National Center for Biotechnology Information (NCBI). A base de dados Entrez mais conhecida é a PubMed, a base de dados dos artigos de ciência viva de muitos jornais biológicos. Atualmente, a única base de dados Entrez suportada pelo Tellico é a PubMed.

#### Bases de Dados Bibliográficas

O arXiv.org, Bibsonomy e o CrossRef são bases de dados online sobre artigos acadêmicos e informações bibliográficas. Para acessar o recurso do CrossRef, você deve solicitar uma conta e adicionar as informações da conta à configuração da fonte de dados.

#### ISBNdb.com

A ISBNdb.com é uma base de dados online de livros online de bibliotecas por todo o mundo.

#### OpenLibrary.org

A OpenLibrary.org é uma base de dados 'online' de livros que pretende ter uma página por cada livro.

### Fontes de Dados de Revistas em Quadrinhos

#### AnimeNfo.com

O AnimeNfo é um serviço conhecido para obter informações sobre Anime, ou seja, animação Japonesa.

#### Bedetheque

Bedetheque é um banco de dados de quadrinhos franceses gerenciada pela BDGest.

### Fontes de Dados de Filmes

#### Base de dados de filmes na Internet

A Internet Movie Database oferece informações sobre filmes e vídeos. Quando é conduzida uma pesquisa sobre uma Pessoa, se for devolvido mais de um resultado, aparece uma janela que lhe permite selecionar a pessoa correta. As opções de configuração incluem a seleção de qual nacionalidade do IMDb será usada e se as imagens são baixadas ou não. Uma vez que a IMDb poderá devolver um grande número de membros do elenco, você poderá limitá-los a um determinado número.

#### TheMovieDB.org

A TheMovieDB.org é uma base de dados 'online' livre e aberta de filmes. É necessário o registro de uma conta gratuita.

#### OMDBAPI.com

O The Open Movie Database é um serviço Web gratuito para obter informações de filmes.

#### AlloCiné

AlloCiné é um serviço de informações de filmes online, com base na França.

### Fontes de Dados de Músicas

#### Discogs.com

O Discogs.com é uma base de dados de músicas, criada pelos usuários, que contém informações sobre os artistas, editoras e as suas gravações. É necessário o registro de uma conta gratuita.

#### MusicBrainz.org

O MusicBrainz.org é uma metabase de dados comunitária de músicas que tenta criar um serviço de informação musical abrangente.

### Fontes de Dados de Jogos de Consoles

#### GiantBomb.com

A GiantBomb.com é uma grande base de dados de jogos de consoles. É necessário o registro de uma conta gratuita.

#### TheGamesDB.net

O TheGamesDB.net é uma base de dados 'online' gratuita para fãs de vídeo games.

### Fontes de Dados de Diversos Tipos de Coleções

#### Amazon.com

Usando os Serviços Web da Amazon, o Tellico poderá procurar em qualquer um dos 14 serviços internacionais operados pela Amazon.com por informações: Estados Unidos, Reino Unido, Alemanha, Japão, França, Canadá, China, Espanha, Itália, Brasil, Austrália, Índia, México e Turquia.

A configuração de cada fonte da Amazon.com envolve três opções: a localização do servidor, o tamanho da imagem e o ID do associado. Algumas das informações da Amazon.com poderão incluir uma imagem, como a capa de um livro ou de um vídeo. Essa imagem poderá ser obtida com três diferentes tamanho, dependendo do item. O ID do associado deverá ser usado para acessar aos Serviços Web da Amazon.com, sendo incluído nas referências de volta para o item, como é necessário de acordo com a licença de utilização dos Serviços Web da Amazon.com.

O acesso à API de Marketing de Produtos da Amazon poderá ter restrições relacionadas com as referências de vendas ou com a publicidade. Leia a documentação da Amazon para obter mais informações de quando se registrar para acesso à API.

#### Scripts ou aplicativos externos

Como uma forma mais simples de o Tellico se integrar com plugins de terceiros, ele poderá usar programas ou aplicativos externos como interface para pesquisar em outras fontes de informação. O Tellico irá executar o comando e passar os termos de pesquisa como opções da linha de comando.

Alguns scripts são distribuídos com o próprio Tellico. O Python é necessário para pesquisar no Dark Horse Comics, um distribuidor de quadrinhos, por exemplo.

O tipo de coleção devolvido pelo programa deverá estar definido, em conjunto com o formato de dados. Não só o Tellico consegue importar os dados do programa que usarem o formato em XML padrão do Tellico, como também poderá importar outros formatos, como o 'bibtex'.

A localização completa da aplicação deverá ser inserida nas opções da fonte. Observe que a aplicação é executada no sistema com as mesmas permissões que o usuário atual, por isso não use programas de fontes não fidedignas. Assinale as opções a seguir às chaves de pesquisa suportadas pela aplicação, inserindo as opções da linha de comando necessárias no campo de texto. O valor a procurar será introduzido onde aparecer o `%1`.

Para atualizar os itens que já estão na coleção, a última opção e campo de texto servem para determinar as opções da linha de comando. Os campos dos itens usados para procurar uma atualização deverão ser inseridos, no mesmo formato que é usado nos campos de valores derivados.

### Fontes de Dados Combinadas e Múltiplas

Poderá usar combinações de até oito fontes de dados existentes como se fossem uma única fonte, na qual os resultados da pesquisa de todas as fontes são reunidos. O tipo de coleção a ser usado terá que ser definido antes de adicionar as fontes.

Somente fontes de dados existentes poderão ser usadas em combinação. O pedido de pesquisa é enviado a cada fonte, sendo combinados todos os resultados. Uma vez que os resultados reunidos dependem da ordem dos resultados da pesquisa, o conjunto combinado poderá ser diferente, dependendo da velocidade da rede e da fonte.

Capítulo 7. Modificar o Tellico
Modificar o Tellico

# Capítulo 7. Modificar o Tellico

Segundo o espírito do 'Software' Livre, você é bem-vindo para modificar o Tellico tanto quanto desejar. Você poderá criar programas para importar, exportar ou modificar os dados com muita facilidade. Este capítulo fornece mais informações sobre como fazer isso.

## Formato de arquivo

O arquivo de dados padrão do Tellico é um pacote ZIP, normalmente com uma extensão de arquivos `.tc`. Dentro do pacote, existe um arquivo de topo `tellico.xml`. As imagens poderão ser incluídas dentro da pasta `images/` do pacote, podendo também ser incluídas diretamente no XML, com uma codificação 'base64'. As imagens poderão também ser salvas dentro da pasta de dados da aplicação; nesse caso, não estarão no arquivo de dados. O Tellico também pode carregar o arquivo XML propriamente dito, no formato não-comprimido.

### Dados XML

#### Coleção

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE tellico PUBLIC "-//Robby Stephenson/DTD Tellico V11.0//EN" "http://periapsis.org/tellico/dtd/v11/tellico.dtd">
    <tellico xmlns="http://periapsis.org/tellico/" syntaxVersion="11">
     <collection title="Meus Livros" type="2">
     </collection>
    </tellico>

O arquivo começa com a declaração e codificação obrigatória do XML, seguida do tipo de documento. Quando for adicionado um novo tipo de campo ou forem definidas propriedades adicionais nos campos predefinidos, a versão da DTD para o tipo de documento será incrementada. O Tellico será sempre capaz de abrir e ler qualquer versão anterior da DTD, mas só irá salvar os arquivos na versão atual. A localização da DTD aponta de fato para um arquivo de DTD atual.

O elemento de topo é um <tellico>, que contém a declaração do espaço de nomes padrão e a versão da sintaxe do arquivo, que deverá corresponder sempre à DTD.

O elemento <tellico> contém um elemento <collection>. São ignoradas várias coleções, por enquanto. O atributo title contém o título da coleção, enquanto o type define os tipos de itens que estão contidos na coleção. Os tipos permitidos são apresentados numa seção posterior. Existe um atributo entryTitle opcional que poderá ser usado para definir o título dos itens numa coleção personalizada, devendo estar no plural.

#### Campos

      <fields>
       <field flags="8" title="Título" category="Geral" format="1" type="1" name="titulo" />
       <field flags="7" title="Autor" category="Geral" format="2" type="1" name="autor" />
       <field flags="2" title="Formato" category="Geral" allowed="Capa Dura;Capa de Papel;Capa de Papel Comercial;E-Book;Revista;Jornal" format="4" type="3" name="formato" >
        <prop name="default"
    >Revista</prop>
       </field>
       <field flags="6" title="Publicação" category="Publicação" format="0" type="1" name="publicacao" />
       <field flags="4" title="Edição" category="Publicação" format="0" type="1" name="edicao" />
       <field flags="3" title="Ano do 'Copyright'" category="Publicação" format="4" type="6" name="ano_copyright" />
       <field flags="2" title="Ano de Publicação" category="Publicação" format="4" type="6" name="ano_publicacao" />
       <field flags="0" title="ISBN#" category="Publicação" format="4" type="1" name="isbn" description="International Standard Book Number" />
       <field flags="7" title="Gênero" category="Classificação" format="0" type="1" name="genero" />
       <field flags="7" title="Palavras-Chave" category="Classificação" format="0" type="1" name="palavraschave" />
       <field flags="0" title="Capa" category="Capa" format="4" type="10" name="capa" />
       <field flags="0" title="Comentários" category="Pessoal" format="4" type="1" name="comentarios" />
       <field title="Classificação" flags="2" category="Pessoal" format="4" type="14" name="classificacao">
        <prop name="maximum"
    >5</prop>
        <prop name="minimum"
    >1</prop>
       </field>
       <field title="ID" flags="32" category="Pessoal" format="4" type="6" name="id">
        <prop name="template"
    >%{@id}</prop>
       </field>

      </fields>

Todos os campos são definidos dentro de um elemento <fields>, nos quais só poderá existir um. Toda a informação de um campo, exceto as propriedades estendidas, são incluídas como atributos do elemento <field>. Os valores permitidos para os atributos flags, format e type são fornecidos na seguinte seção.

As propriedades dos campos são usadas para definir os valores padrão para os campos, os intervalos dos valores de classificações, os modelos dos valores derivados, etc. Os exemplos acima incluem um valor padrão, um valor máximo de classificação e um modelo para um campo de ID derivado.

#### Elementos

      <entry>
       <title
    >A Linguagem de Programação C++</title>
       <authors>
        <author
    >Stroustrup, Bjarne</author>
       </authors>
       <publisher
    >Addison-Wesley Pub Co</publisher>
       <edition
    >3a</edition>
       <pub_year
    >1997</pub_year>
       <isbn
    >0-201-88954-4</isbn>
       <genres>
        <genre
    >Não-Ficção</genre>
       </genres>
       <keywords>
        <keyword
    >Programação</keyword>
        <keyword
    >Computadores</keyword>
       </keywords>
       <cover
    >cf65a2f023b6cb9e9233323dca10ac7c.jpeg</cover>
      </entry>

Para cada um dos campos da coleção, existe um <entry> que poderá conter um elemento, cujo nome é idêntico ao nome do campo. Se forem permitidos vários valores para o campo, então será adicionada a letra s ao nome do campo, ao criar um elemento, e cada um dos valores é adicionado como um filho do elemento, como acontece no caso dos campos 'author', 'genre' e 'keyword' acima.

Como resultado, se forem adicionados campos extras à coleção, o arquivo de dados já não ficará mais em conformidade com a DTD. Contudo, o Tellico usa um processador de XML sem validação, assim os campos adicionais não causam problemas.

#### Imagens

      <images>
       <image width="111" format="JPEG" height="140" id="cf65a2f023b6cb9e9233323dca10ac7c.jpeg" />
      </images>

Dentro do elemento <images>, é enumerada cada uma das imagens referenciadas por um elemento, em conjunto com os atributos que descrevem o tamanho, o formato e o identificador da imagem. Se a imagem estiver contida dentro do arquivo ZIP, o elemento está em branco. Caso contrário, os dados da imagem poderão estar contidos na sequência de XML, sob o formato de texto codificado em base64.

Valores do Tipo de Coleção
Valores do Tipo de Coleção

## Valores do Tipo de Coleção

O tipo de coleção é fornecido no atributo 'type' do elemento 'collection'. O valor é igual ao valor enumerado Type em `src/collection.h`.

Tabela 7.1. Valores do Tipo de Coleção

Tipo de Coleção | Valor
--- | ---
Coleção Personalizada | 1
Coleção de Livros | 2
Coleção de Vídeos | 3
Coleção de Músicas | 4
Bibliografia | 5
Coleção de Revistas em Quadrinhos | 6
Coleção de Vinhos | 7
Coleção de Moedas | 8
Coleção de Selos | 9
Coleção de Cartões Comerciais | 10
Coleção de Jogos de Console | 11
Catálogo de Arquivos | 12
Coleção de jogos de tabuleiro | 13

Valores do Tipo de Campo
Valores do Tipo de Campo

## Valores do Tipo de Campo

O Tellico irá incluir todos os campos padrão de uma coleção, caso o elemento do primeiro campo tenha o nome _default. Para os campos de Parágrafo, Tabela ou Imagem, a categoria do campo deverá ser idêntica ao título do campo.

O tipo de campo é fornecido no atributo 'type' do elemento 'field'. O valor é igual ao valor enumerado FieldType em `src/field.h`.

Tabela 7.2. Valores do Tipo de Campo

Tipo do Campo | Valor
--- | ---
Texto simples | 1
Parágrafo | 2
Escolha | 3
Opção | 4
Número | 6
URL | 7
Tabela de Coluna Única | 8
Imagem | 10
Data | 12
Classificação | 14

O campo poderá ter diferentes opções ativas, indicado como um valor em OR's do atributo 'flags' do elemento 'field'. A opção para impedir o usuário de apagar um campo é necessária para algumas coisas, como a chave de citação dos itens bibliográficos.

Tabela 7.3. Valores das Opções dos Campos

Opções do Campo | Valor
--- | ---
Permitir Valores Múltiplos | `0x01`
Permitir o Agrupamento | `0x02`
Permitir o Completamento | `0x04`
Proibir a Remoção | `0x08`
Proibir a edição | `0x10`
Valor derivado | `0x20`

O formato do campo é indicado no atributo 'format' do elemento 'field'. A Formatação de Datas não é usada no momento. O agrupamento por Pessoas usa todos os campos que usam a Formatação de Nomes. Atribuir a opção Valor derivado, implica que o valor do campo seja gerado a partir da propriedade do modelo e dos valores dos outros campos.

Tabela 7.4. Valores dos Formatos dos Campos

Formato do Campo | Valor
--- | ---
Apenas com Capitalização | 0
Formatação de Títulos | 1
Formatação de Nomes | 2
Formatação de Datas | 3
Sem Formatação | 4

Opções Ocultas de Configuração
Opções Ocultas de Configuração

## Opções Ocultas de Configuração

O Tellico tem algumas opções adicionais de configuração que não estão visíveis na Janela de Configuração. Não são importantes o suficiente para que tenham que encher a janela de configuração, mas representam opções que poderão apelar a vários usuários, sendo que a aplicação as lê do arquivo de configuração.

A configuração do Tellico é salva num arquivo da pasta pessoal do usuário, nomeadamente o `$`KDEHOME`/share/config/tellicorc`. Dentro desse arquivo, a configuração é distribuída por grupos, os quais aparecem entre colchetes, como em '[General Options]'. Para adicionar uma opção ao grupo General Options, descubra a linha no arquivo de configuração com esse nome de grupo. Se esta não existir, então adicione-a você mesmo, acrescentando uma linha que diga [General Options]. Depois, você poderá adicionar a opção abaixo do nome do grupo.

### [General Options]

Estas opções deverão ser colocadas no grupo General Options.

#### Max Icon Size

Você poderá alterar o tamanho máximo dos ícones na Área de Ícones com esta opção. O valor padrão é 96. O tamanho deverá estar no intervalo entre 32 e 512.

#### Exemplo

`Max Icon Size=128`

#### Icon Cache Size

O número máximo de ícones que serão guardados na memória pode ser mudado com esta opção. O valor padrão é 1000.

#### Exemplo

`Icon Cache Size=100`

#### Exemplo

`Max Icon Size=128`

#### Image Cache Size

A quantidade máxima de memória em bytes usada para guardar todas as imagens pode ser mudada com esta opção. O valor padrão é 67108864.

#### Exemplo

`Image Cache Size=256000000`

### [Options - bibtex]

Estas opções deverão ser colocadas no grupo Options - bibtex.

#### lyxpipe

Esta opção serve para a localização do 'pipe' do Lyx, para onde deverá enviar as citações bibliográficas. Não deverá incluir o sufixo `.in`.

#### Exemplo

`lyxpipe=$HOME/.lyx/lyxpipe`

Bibtex Character Translation
Bibtex Character Translation

## Bibtex Character Translation

Quando os arquivos 'bibtex' são importados ou exportados, certos caracteres são traduzidos entre os seus equivalentes em TeX e os caracteres em Unicode. Esses mapeamentos de caracteres constam no arquivo `bibtex-translation.xml`, que se localiza na pasta de dados de instalação. Os mapeamentos poderão ser modificados como desejar. O elemento 'key' contém o caracter Unicode, enquanto os elementos 'string' dentro dele contêm os equivalentes em TeX, os quais poderão ser uma associação de um-para-muitos. O primeiro deles será usado na exportação para o 'bibtex'.

      <key char="À">
        <string
    >{\`A}</string>
        <string
    >\`{A}</string>
      </key>

Truques de XSLT
Truques de XSLT

## Truques de XSLT

Aqui estão algumas sugestões de programação em XSLT para processar os dados em XML do Tellico: (POR FAZER).

Capítulo 8. Perguntas e respostas
Perguntas e respostas

# Capítulo 8. Perguntas e respostas

8.1. Como eu insiro vários autores?
8.2. Eu posso modificar a aparência da página impressa?
8.3. Como eu agrupo por uma propriedade que não esteja listada na barra de ferramentas?
8.4. Porque aparece tanto lixo quando rodo o Tellico?
8.5. Como eu altero as colunas que são apresentadas?
8.6. Como eu filtro por algo, como o campo "Lido"?
8.7. Como eu adiciono novos modelos de itens?
8.8. A compilação e a instalação correram bem; porém, quando o Tellico é iniciado, a janela aparece em branco. O que está errado?
8.9. Como eu exporto os campos adicionais do Bibtex?
8.10. O que aconteceu ao Bookcase?
8.11. De onde veio o nome Tellico?
8.12. Porque você inclui as referências à Amazon.com nos resultados da pesquisa?
8.13. Porque você não usou um banco de dados real?

8.1. | Como eu insiro vários autores?

Os nomes dos autores deverão ser separados por ponto e vírgula, como o seguinte: `Brian W. Kernighan; Dennis M. Ritchie`. Não inclua a palavra "and" (e) ou algo semelhante, mesmo que tenha 20 autores. Se tiver a opção de formatação automática, assinalada, então será apresentado o último nome em primeiro lugar para cada autor.

As outras propriedades que permitem valores múltiplos, como o "gênero" e as "palavras-chave", são inseridas da mesma forma, com um ponto e vírgula (;) separando cada um dos valores.

8.2. | Eu posso modificar a aparência da página impressa?

Sim, claro que sim. Encontre o arquivo `tellico-printing.xsl`, que deverá estar na pasta $`KDEDIR`/share/apps/tellico/. Você poderá copiá-lo para $`KDEHOME`/share/apps/tellico/ para as suas modificações pessoais. Você terá que saber XSLT, mas a modificação desse arquivo é a forma como irá mudar o layout da impressão. É gerado HTML a partir do arquivo, e a forma mais simples de alterar a aparência da impressão é modificar o CSS na seção de topo.

Lembre-se que o arquivo `tellico-printing.xsl` faz referência a outro arquivo, o `tellico-common.xsl`, que contém alguns modelos comuns em XSLT. Se copiar o arquivo `tellico-printing.xsl` para o $`KDEHOME`, deverá então modificar o elemento <xsl:import> para apontar para a localização atual do arquivo `tellico-common.xsl` ou copiar o arquivo comum também.

8.3. | Como eu agrupo por uma propriedade que não esteja listada na barra de ferramentas?
| Para permitir agrupar por um campo que não permita agrupamentos por padrão, assinale a opção "Permitir o Agrupamento", para esse campo em particular, na janela de "Campos da Coleção".
8.4. | Porque aparece tanto lixo quando rodo o Tellico?

Se aparecer algo do tipo:

    Tellico::updateCollectionToolBar
    GroupView::setGroupAttribute - author
    GroupView::slotAddCollection
    QCheckBox::property( "title" ) failed: property invalid
    or does not exist

, isso é informação de depuração. No momento da compilação, isso pode ser interrompido com a opção ``--disable-debug``. Você poderá também querer usar a opção ``--enable-final``, o que irá ocupar um pouco mais de memória na compilação, mas que será mais eficiente ao executar a aplicação.

A última mensagem é ligeiramente diferente; simplesmente significa que a sua instalação do Qt™ foi compilada com alguma informação de depuração.

Ou, caso o Tellico já esteja instalado, execute `kdebugdialog` e certifique-se de que o "0 (generic)" está desligado. Isso desliga todas as mensagens de depuração para todos os aplicativos genéricos do KDE, isto é, os que não são distribuídos oficialmente pelo KDE.

8.5. | Como eu altero as colunas que são apresentadas?
| Clique com o botão direito na barra do cabeçalho. Você poderá também arrastar os cabeçalhos para reordenar as colunas, clicando depois nelas para ordenar por esse campo.
8.6. | Como eu filtro por algo, como o campo "Lido"?

Internamente, os campos de opções de marcação são guardados como "true" (verdadeiro) no Tellico; por isso, se quiser filtrar para mostrar apenas os livros de ficção científica que ainda não leu, por exemplo, então você terá duas regras. Certifique-se de que a opção "Corresponder a todos os seguintes" está ativa. Configure a primeira regra para ter "Gênero" "contém" "Ficção Científica" (sem as aspas) e a segunda regra configurada como "Lido" "não contém" "true" (sem as aspas).

Do mesmo modo, o filtro rápido na barra de ferramentas irá corresponder a qualquer campo e, se existir um caracter que não faça parte de uma palavra, o texto é interpretado como uma expressão regular. Por isso, se quiser filtrar rapidamente os seus livros para mostrar os que pertençam a Weber ou Bujold, então escreva "weber|bujold" (sem as aspas) na barra de ferramentas.

8.7. | Como eu adiciono novos modelos de itens?

Os modelos dos itens deverão ser salvos em `$`KDEHOME`/share/apps/tellico/entry-templates/`, para ficarem acessíveis para um único usuário, ou em `$`KDEDIR`/share/apps/tellico/entry-templates/` para ficar acessível para todos. Os modelos em $`KDEHOME` sobrepor-se-ão aos arquivos com o mesmo nome em $`KDEDIRS`. Os modelos de itens poderão ser definidos, por tipo de coleção, na janela de configuração.

Os modelos para a Janela de Relatórios estão salvos em `$`KDEHOME`/share/apps/tellico/report-templates/`.

8.8. | A compilação e a instalação correram bem; porém, quando o Tellico é iniciado, a janela aparece em branco. O que está errado?

Os programas do KDE procuram por dados nos locais definidos na variável de ambiente $`KDEDIRS`. Se instalar na `/usr/local` por exemplo, mas se a variável $`KDEDIRS` estiver em branco ou com `/usr`, então o Tellico não irá conseguir encontrar os arquivos que necessita. Isto acontece principalmente no SuSE; nesse caso, você deverá compilar com ``--prefix`=`/opt/kde3``. Em alternativa, poderá adicionar uma linha ao seu arquivo `.profile` que configure a variável $`KDEDIRS`. Veja a documentação sobre a sua linha de comando.

8.9. | Como eu exporto os campos adicionais do Bibtex?
| O Tellico usa a propriedade bibtex para saber como exportar os campos do Bibtex. Se você quiser adicionar campos extra à exportação, como um resumo, abra a Janela de Campos da Coleção e clique no botão Propriedades Estendidas. Adicione uma propriedade bibtex com o valor abstract. Depois, quando exportar para 'bibtex' ou 'bibtexml', essa propriedade será usada para o nome do campo 'bibtex'.
8.10. | O que aconteceu ao Bookcase?
| Devido a um conflito de marcas registradas, o Bookcase mudou de nome para Tellico em Setembro de 2004. O Tellico 0.12 foi então lançado, sendo idêntico ao Bookcase 0.11, excetuando a mudança no nome.
8.11. | De onde veio o nome Tellico?
| O autor pensou em diversos nomes, sendo alguns deles relacionados com coleções de livros. Contudo, o Tellico pode lidar com mais do que apenas livros; além disso, isto é um passatempo, assim o autor escolheu um nome que lhe soasse bem, retirado de uma cidade próxima do local onde cresceu.
8.12. | Porque você inclui as referências à Amazon.com nos resultados da pesquisa?
| O termos do acordo de acesso aos Serviços Web da Amazon.com obrigam a que todas as imagens obtidas do serviço sejam referenciadas de volta à Amazon.com, assim como possuir uma ligação adicional. O ID de sócio da Amazon.com é incluído por necessidade, para que todos os pagamentos de referência sejam devidamente feitos.
8.13. | Porque você não usou um banco de dados real?

Uma das razões pelas quais o Tellico foi iniciado foi a aprendizagem de C++. O autor não sabia nada sobre SQL naquela época e, atualmente, só possui um conhecimento vago de como usá-lo. Em resumo, o Tellico não começou como um banco de dados relacional, e isso não irá mudar até que o autor aprenda SQL e tenha o tempo e motivação para modificar o modelo de dados. Se isso o incomodar, então não use o Tellico.

Obviamente, toda a ajuda é bem-vinda para fazer as alterações necessárias ao código-fonte.

Capítulo 9. Referência de comandos
Referência de comandos

# Capítulo 9. Referência de comandos

## A janela principal do Tellico

Cada item do menu é discutido abaixo. Quando existir um atalho de teclado que efetue a função de um determinado item do menu, é mostrada a combinação de teclas padrão em conjunto com o item do menu.

### Menu Arquivo

Arquivo → Novo

  Este comando cria uma coleção nova. O Tellico suporta 12 tipos de coleções padrão, em conjunto com uma coleção personalizada vazia definida pelo usuário.

Arquivo → Abrir... (Ctrl+O)

  Este comando abre um arquivo do Tellico.

Arquivo → Abrir recente

  Este comando abre um arquivo a partir de um submenu que contém uma lista com os arquivos abertos recentemente.

Arquivo → Salvar... (Ctrl+S)

  Este comando salva a coleção. Se o arquivo for Sem Título, então o Salvar... será equivalente ao Salvar Como. Só ficará ativo quando a coleção tiver sido modificada.

Arquivo → Salvar como... (Ctrl+Shift+S)

  Este comando salva a coleção num arquivo novo.

Arquivo → Imprimir... (Ctrl+P)

  Este comando imprime a coleção. As opções de impressão poderão ser definidas na Janela de Configuração.

Arquivo → Importar

  Este comando importa os dados de outro arquivo. O Tellico pode importar dados a partir de um conjunto de outros formatos.

Arquivo → Exportar

  Este comando exporta a coleção para outro formato. O Tellico pode exportar os dados para um conjunto de outros formatos.

Arquivo → Sair (Ctrl+Q)

  Este comando fecha a janela do Tellico. Se a coleção tiver alterações não salvas, será questionado se deseja salvá-las antes de continuar.

### Menu Editar

Editar → Desfazer (Ctrl+Z)

  Este comando anula a ação anterior. Nem todas as ações são suportadas por esta opção.

Editar → Refazer (Ctrl+Shift+Z)

  Este comando reverte uma ação Desfazer anterior.

Editar → Recortar (Ctrl+X)

  Este comando remove o texto selecionado, se existir, e coloca uma cópia do texto removido na área de transferência.

Editar → Copiar (Ctrl+C)

  Este comando copia o texto selecionado, se existir, para a área de transferência.

Editar → Colar (Ctrl+V)

  Este comando cola o texto na área de transferência, se existir, na posição do cursor no editor.

Editar → Selecionar tudo (Ctrl+A)

  Este comando seleciona todos os itens da coleção na Área de Colunas.

Editar → Desmarcar (Ctrl+Shift+A)

  Este comando desmarca todos os itens na coleção.

Editar → Pesquisa na Internet... (Ctrl+I)

  Este comando abre a Janela de Pesquisa na Internet para procurar e importar itens de várias fontes na Internet, incluindo a Amazon.com.

Editar → Filtro Avançado... (Ctrl+J)

  Este comando abre a Janela de Filtros Avançados.

### Menu Coleção

Coleção → Novo Item (Ctrl+N)

  Este comando abre o Editor de Itens para editar um novo item.

Coleção → Editar o Item (Ctrl+E)

  Este comando abre o Editor de Itens para editar os itens selecionados.

Coleção → Duplicar o Item (Ctrl+Y)

  Este comando copia ou duplica os itens selecionados como itens novos da coleção.

Coleção → Apagar o Item (Ctrl+D)

  Este comando apaga os itens selecionados.

Coleção → Mesclar os Itens

  Este comando mescla os itens selecionados.

Coleção → Atualizar o Item

  Este menu contém uma lista com todas as fontes de dados disponíveis, podendo ser usada para consultar automaticamente a fonte e atualizar os itens selecionados.

Coleção → Dar Saída

  Este comando abre uma janela para marcar a saída dos itens selecionados..

Coleção → Dar Entrada

  Este comando dá entrada a todos os itens selecionados que estiverem emprestados ou alugados.

Coleção → Renomear a Coleção (Ctrl+R)

  Este comando abre uma janela para renomear a coleção.

Coleção → Campos da Coleção... (Ctrl+U)

  Este comando abre a Janela de Campos da Coleção.

Coleção → Gerar Relatórios...

  Este comando abre a Janela de Relatórios para gerar relatórios sobre a coleção.

Coleção → Bibliografia → Converter para uma Bibliografia

  Este comando converte uma coleção de livros para uma bibliografia, adicionando certos campos necessários na exportação para o Bibtex, só estando ativo quando tiver aberta uma coleção de livros.

Coleção → Bibliografia → Macros de String...

  Este comando abre uma janela para editar as macros de texto do Bibtex na coleção. Só está ativa quando editar uma bibliografia.

Coleção → Bibliografia → Procurar chaves duplicadas

  Este comando procura por chaves duplicadas do Bibtex e pode filtrar a coleção para mostrar os itens com chaves duplicadas.

Coleção → Bibliografia → Copiar o Bibtex para a área de transferência

  Este comando copia uma citação do Bibtex para a área de transferência, de modo que possa ser colada num documento em LaTeX.

Coleção → Bibliografia → Citar um item no Lyx

  Este comando envia uma citação dos itens selecionados para o lyxpipe, para que possa ser usado no LyX, Kile ou em outros aplicativos de LaTeX. Só ficará ativo ao editar uma bibliografia.

### Menus Configurações e Ajuda

Além dos menus Configurações e Ajuda normais do KDE, descritos no capítulo Menu dos Fundamentos do KDE, o Tellico tem estes itens de menu específicos do aplicativo:

Configurações → Mostrar a Área de Grupos

  Este comando ativa/desativa a visibilidade da Área de Grupos.

Configurações → Mostrar o Editor de Itens

  Este comando ativa/desativa a visibilidade do Editor de Itens.

Configurações → Seleção do Grupo

  Este comando altera o campo usado para agrupar os itens na coleção.

Capítulo 10. Créditos e Licença
Créditos e Licença

# Capítulo 10. Créditos e Licença

Tellico

Direitos autorais do programa 2001-2019 Robby Stephenson `(robby AT periapsis.org)`

Direitos autorais da documentação 2001-2019 Robby Stephenson `(robby AT periapsis.org)`

Tradução de Marcus Gama `(marcus.gama AT gmail.com)`

Este programa é licenciado sob os termos da Licença Pública Geral GNU.

Esta documentação é licenciada sob os termos da Licença de Documentação Livre GNU.

O autor desta documentação também lhe concedeu permissão para usar o conteúdo segundo os termos da FreeBSD Documentation License, se assim o desejar. Se optar por permitir o uso da sua versão para este conteúdo apenas segundo os termos da Licença de Documentação do FreeBSD, e não permitir que os outros usem a sua versão deste arquivo segundo os termos da GFDL, indique a sua decisão, apagando o aviso da GFDL e substituindo-a pelo aviso e pelas outras notas necessárias pelas Licença de Documentação do FreeBSD. Se não apagar o aviso da GFDL acima, um destinatário poderá usar a sua versão deste arquivo segundo os termos da GFDL ou da Licença de Documentação do FreeBSD.