O Manual do Tellico

# O Manual do Tellico

Robby Stephenson `<robby@periapsis.org>`

Tradução: José Pires
revisão 2.0 (28/08/2009)

Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Robby Stephenson

Por questões de licenças, tanto da aplicação como desta documentação, por favor veja a secção final.

Este documento é um manual para usar o Tellico, uma aplicação de gestão de colecçõ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 Colecçã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 gerir colecções. Começou com um gestor de colecções de livros simples, expandindo-se para incluir modelos de colecções predefinidos para bibliografias, bandas desenhadas, vídeos, música, moedas, selos, cartões, jogos de vídeo, vinhos, jogos de tabuleiro e listagens de ficheiros. Para além disso, poderá criar colecções personalizadas para qualquer outro tipo de item coleccionável.

### O Que é o Tellico

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

Poderá registar os empréstimos, com uma integração opcional com o KOrganizer. Poderá importar ou exportar as colecções numa 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 ficheiros multimédia. Também não oferece nenhuma capacidade de edição de imagens. Ainda que o Tellico tenha alguma funcionalidade para gerir listas bibliográficas, 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. Está muito longe de ser um pacote profissional de 'software'. Poderá encontrar mais informações na declaração da licença.

Terminologia
Terminologia

## Terminologia

### Colecções

No Tellico, uma colecção é o documento. Só poderá existir uma colecção em cada ficheiro do Tellico. Uma colecção contém um número qualquer de campos e itens. O Tellico suporta 12 tipos de colecções específicos por omissão: livros, itens bibliográficos, banda desenhada, vídeos, música, cartões para troca, moedas, selos, jogos de vídeo, vinhos, jogos de tabuleiro e listagens de ficheiros. Para além disso, está disponível um modelo de colecção genérico e vazio para outros tipos de itens coleccionáveis.

### Campos da Colecção

Cada colecçã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 Colecção e são explicados mais à frente na secção de Tipos de Campos.

### Itens da Colecção

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

O Tellico foi testado com uma colecção de 10 000 itens, e a velocidade foi considerada satisfatória. Contudo, se incluir muitas imagens grandes na colecçã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 ficheiro de dados, seja na pasta da aplicação ou numa pasta relativa ao ficheiro de dados. Poderá obter mais informações na secção de configuração.

Capítulo 2. Usar o Tellico
Usar o Tellico

# Capítulo 2. Usar o Tellico

## Arranque Rápido

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

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

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

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

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

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

Utilização Geral
Utilização Geral

## Utilização Geral

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

### Área de Colunas

Qualquer um dos campos nas colecções poderá ser apresentado na Área de Colunas, ainda que o Parágrafo, a Imagem e a Tabela possam não ser muito úteis. Se carregar com o botão direito no cabeçalho da janela, abrirá um menu para seleccionar os campos visíveis. As colunas poderão ser dimensionadas e reordenadas de qualquer forma, sendo que a configuração será gravada entre sessões.

### Área de Grupos

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

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

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

### Área de Filtros

Se forem gravados alguns filtros para a colecção, a Área de Filtros fica activa. À medida que for adicionando ou modificando os elementos, estes serão validados automaticamente pelos filtros e adicionados ou removidos, conforme o resultado. Poderá modificar o filtro se fizer duplo-click no item para abrir a Janela de Filtros. Se carregar com o botão direito, poderá apagá-los em conjunto.

### Área de Financiamentos

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

### Área de Itens

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

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

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

### Barra de Estado

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

Editar os Elementos
Editar os Elementos

## Editar os Elementos

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

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

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

Para os campos Imagem, o botão Seleccionar a Imagem... abre a janela de selecção de ficheiros do KDE. A imagem é gravada na colecção com o formato original, sendo apresentada uma versão à escada no Editor de Itens. A imagem poderá ser limpa se usar o botão Limpar. As imagens limpas são removidas da colecção.

O item de edição também suporta o arrastamento. Se arrastar um ficheiro de imagem de um gestor de ficheiros ou janela de navegador, fará o mesmo que seleccionar uma imagem no Selector de Ficheiros. Se arrastar uma imagem do item de edição para uma janela de gestão de ficheiros do Konqueror, irá gravar a imagem nessa pasta.

### Atenção

Por omissão, as imagens são guardadas o ficheiro de dados da colecção, estando tudo contido apenas num local. Contudo, demasiadas imagens farão com que o Tellico se torne significativamente mais lento, dado que irá resultar num ficheiro de dados muito grande. Em alternativa, o Tellico poderá gravar as imagens em separado, seja na pasta `$`KDEHOME`/share/apps/tellico/data/` ou numa pasta no mesmo local do ficheiro de dados. O carregamento e gravação dos ficheiros de dados é muito mais rápido se as imagens forem gravadas em separado, mas os ficheiros de dados deixarão de ser portáteis ou fáceis de arquivar. Os dados auto-contidos poderão sempre ser criados se usar a opção do menu Ficheiro+Exportar → Exportar para ZIP....

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

### Editar Vários Elementos

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

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

### Actualizar os Dados dos Itens

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

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

A actualização do item poderá ser iniciada com o menu do botão direito para um item, ou então usando a opção do menu Colecção → Actualizar o Item.

Editar os Campos
Editar os Campos

## Editar os Campos

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

### Lista de Campos

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

### Propriedades do Campo

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

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

Tabela 2.1. Mudanças de Tipo de Campo Permitidas

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

### Formatação do Campo

O 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 a começar em maiúsculas, exceptuando os artigos. A formatação de títulos move certos artigos do início para o fim do campo; por exemplo, a alteração de "O Regresso do Rei" para "Regresso do Rei, O". Os artigos do título são configuráveis. Finalmente, a formatação de nomes tenta quebrar o texto, de modo que o último nome, ou apelido, da pessoa seja apresentado em primeiro lugar. Os prefixos e sufixos dos nomes são configuráveis. Do mesmo modo, o grupo especial Pessoas usa todos os campos com a formatação de nomes, mesmo que essa configuração global esteja desligada.

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

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 dos Campos

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

Por questões de eficiência, não active a completação automática, a menos que necessite dela para os campos. Quanto mais campos com completação automática tiver na colecção, mais lento se torna o Tellico a carregar o ficheiro.

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 colecção.

Cada linha contém uma regra única de filtragem. Seleccione o campo correspondente na primeira opção da linha, e seleccione depois uma regra correspondente ao centro. As regras poderão corresponder a determinados valores ou que sejam exactamente iguais. Poderá também usar uma expressão regular para fazer a correspondência dos itens; nesse caso, o botão Editar... fica activo para editar a expressão, caso o KRegExpEditor esteja instalado no seu computador. Finalmente, a palavra ou texto correspondente deverão ser introduzidos no campo de texto.

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

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

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

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

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

Gerar Relatórios
Gerar Relatórios

## Gerar Relatórios

O Tellico consegue gerar vários relatórios sobre a sua colecção actual. A Janela de Relatórios verifica todos os modelos em XSLT que existam no local de instalação e na pasta `$`KDEHOME`/share/apps/tellico/report-templates/`. Como tal, poderá criar novos, para que estes sejam descobertos automaticamente e incluídos como opções na Janela de Relatórios. Alguns relatórios mais complexos poderão levar algum tempo a gerar, no caso de colecções grandes.

Os modelos que são instalados com o Tellico incluem uma lista apenas com os títulos, a vista das colunas por omissão, uma vista agrupada, um resumo de todos os grupos e os valores mais conhecidos nesses grupos, um relatório de empréstimos e um grande relatório com as imagens de capa. Seleccione o modelo desejado e carregue no botão Gerar. Todos os relatórios também poderão ser impressos ou gravados num ficheiro HTML.

Os itens incluídos no relatório serão limitados aos que constam na Área de Colunas, por isso, se tiver um filtro activo, a Janela de Relatórios usá-lo-á.

Registo de Empréstimos
Registo de Empréstimos

## Registo de Empréstimos

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

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

Se for introduzida uma data-limite e se o Tellico for compilado com o suporte para a 'libkcal', poderá adicionar uma chamada de atenção ao calendário predefinido do KDE como um item Por-Fazer. O KOrganizer poderá ser usado para ver esses itens.

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

Sugestões Gerais
Sugestões Gerais

## Sugestões Gerais

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

### Dica

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

Capítulo 3. Detalhes do Tellico
Detalhes do Tellico

# Capítulo 3. Detalhes do Tellico

## Tipos de Campos

Cada colecçã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 item de introdução de dados é um campo de texto normal. Este tipo é apropriado para os campos que supostamente não terão dados muito extensos, como o autor ou o género.

### Número

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

### URL

O tipo URL permite ter referências para outros documentos, usando as associações-padrão de tipos de ficheiros do KDE para abrir os documentos referenciados. Não é feita nenhuma validação sobre o valor actual de um campo URL, mas as referências inválidas não são abertas. A introdução de dados é feita através de um campo de texto com um botão para abrir a janela normal da opção 'Ficheiro'->'Abrir', se bem que poderá usar qualquer URL. Os URLs relativos são interpretados em relação à localização do ficheiro de dados, uma vez estando esta gravada.

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

Poderá usar também URL relativos. Estes são interpretados em relação à localização do ficheiro de dados do Tellico. No Editor de Itens, o campo de texto oferece a completação automática para as localizações de ficheiros locais. Se quiser que o URL da Janela de Selecção de Ficheiros do KDE seja interpretada em relação à localização do documento, então deverá definir a propriedade extendida do campo URL como relative : true.

### Parágrafo

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

### Escolha

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

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

### Opção

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

### Data

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

### Tabela

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

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

Ao usar o Editor de Itens para os campos Tabela, poderá reorganizar as linhas, arrastando o rato enquanto carrega na tecla Ctrl. Está disponível também um menu de contexto se carregar com o botão direito na tabela, o que permitirá introduzir ou remover linhas.

### Imagem

Os campos Imagem guardam uma imagem em qualquer formato suportado pelo KDE. Alguns dos formato típicos incluem o PNG ou o JPEG. A imagem poderá ser gravada dentro do ficheiro de dados do Tellico propriamente dito ou na pasta de dados da aplicação. O Selector de Ficheiros do KDE pode ser usado tanto para um URL qualquer ou para um ficheiro local. As imagens poderão ser arrastadas a partir de um gestor de ficheiros ou um navegador.

### Classificação

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

### Campos de Valores Derivados

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

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

Tipos de Colecções
Tipos de Colecções

## Tipos de Colecções

O Tellico suporta doze tipos de colecções específicos por omissão: livros, itens bibliográficos, bandas desenhadas, vídeos, músicas, jogos de vídeo, cartas para troca, moedas, selos, vinhos, jogos de tabuleiro e catálogos de ficheiros. Para além disso, está disponível um modelo genérico de colecções para quaisquer outros itens de colecção. As colecções predefinidas só existem para incluir um conjunto geral de campos. Podê-los-á adicionar, modificar ou apagar de acordo com as suas necessidades. O único requisito é que uma colecção deverá ter sempre um campo de Título, para que o Área de Grupos funcione correctamente. Para alguns tipos de colecção, esse é apenas um campo de valor derivado que combina dois ou mais dos outros campos.

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

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

### Colecções de Livros

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

O campo ISBN# é especial, dado que os números ISBN são formatados automaticamente e é calculado o dígito de verificação. O Tellico reconhece o campo ISBN se o seu nome interno de campo for isbn. Se o apagar, ou necessitar de o adicionar a outro tipo de colecção, crie o campo com o título ISBN e aplique a alteração, para que possa depois regressar e modificar o título ao seu gosto. O Tellico cria o nome interno com base no título inicial, mas nunca o altera se o título for actualizado posteriormente.

### Bibliografias

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

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

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

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

### Colecções de Bandas Desenhadas

As colecções de bandas desenhadas têm 22 campos predefinidos: Título, Sub-título, Escritor, Artista, Série, Número, Publicador, Edição, Ano de Publicação, Páginas, País, Língua, Género, Palavras-Chave, Condição, Data de Compra, Preço de Compra, Assinado, Prenda, Emprestado, Capa Frontal e Comentários.

### Colecções de Vídeos

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

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

### Colecções de Músicas

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

### Colecções de Jogos

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

### Colecções de Cartões

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

### Colecções de Moedas

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

### Colecções de Selos

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

### Colecções de Vinhos

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

### Colecções de Jogos de Tabuleiro

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

### Catálogos de Ficheiros

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

### Colecções Personalizadas

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

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 ficheiros de dados, assim como pesquisar em vários serviços da Internet para obter informações.

## Importar a Partir 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 directamente à sua colecção actual. Os vários fornecedores são configurados com as Opções das Fontes de Dados.

As pesquisas poderão usar cinco 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 certas fontes de dados. O ISBN e o LCCN são apenas para livros, enquanto o UPC ou o EAN se podem aplicar 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, estes são adicionados directamente à lista sob o campo de pesquisa; a selecção de um item irá mostrar o resultado sem o adicionar à colecção. Se carregar no botão Adicionar um Item, irá adicionar todos os itens seleccionados à sua colecção. Se a fonte de dados tiver mais resultados do que os pedidos inicialmente, o botão Obter Mais Resultados ficará activo. Se carregar em Limpar, irá remover todos os resultados actuais e limpar a pesquisa.

Só os itens correspondentes ao tipo de colecção actual 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 à colecção, é feita uma marcação na primeira coluna na lista.

Poderá adicionar vários itens de uma vez, usando o método-padrão do KDE de selecção múltipla, que envolve normalmente a utilização das teclas Shift ou Ctrl enquanto carrega 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 selecção da opção Pesquisa por ISBN/UPC múltipla irá desactivar o campo de pesquisa e activar o botão Editar os valores de ISBN/UPC..., que irá obter um campo de introdução de texto multi-linhas. Cada ISBN deverá ser introduzida numa linha própria. Depois de fechar a janela, cada um dos ISBN's será validado à procura da formatação correcta. 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 correcta. A lista de ISBN's poderá também ser lida a partir de um ficheiro de texto.

Importar Dados
Importar Dados

## Importar Dados

O Tellico oferece três acções diferentes quando importa os dados. A Substituir a colecção actual irá fechar a colecção actual, criando uma nova com os dados do ficheiro importado. A Adicionar à colecção actual diz ao Tellico para adicionar todos os itens na colecção importada à actual, assim como para adicionar os campos que não existam de momento. A acção Reunir a colecção é a mesma que a adição, excepto que cada item importado é comparado com os actuais, sendo que os itens idênticos são descartados. Nos planos futuros, existe uma heurística melhorada para identificar os itens correspondentes mas, de momento e exceptuando as colecções de músicas, eles deverão ser iguais em todos os campos. As colecções de músicas comparam apenas o artista e a música, sendo que as faixas são reunidas para os itens correspondentes. O módulo de importação de ficheiros de áudio é capaz de construir correctamente as listagens de faixas ao reunir os itens.

### Importar Dados do Tellico

Poderão ser importados outros ficheiros de dados do Tellico. A substituição da colecção actual, através da importação de um ficheiro de dados do Tellico, é a mesma coisa que abrir o próprio ficheiro. O valor da importação dos dados do Tellico é apenas para adicionar ou reunir duas colecções.

### A Importar 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. Poderá usar qualquer carácter ou sequência de texto.

Primeiro, seleccione o tipo de colecção que está a importar. Se estiver a adicionar ou a reunir à colecção actualmente aberta, o tipo é limitado ao tipo da sua colecção actual. Se a primeira linha do ficheiro CSV tiver os títulos dos campos, carregue na opção para que o módulo de importação compare automaticamente os títulos com os campos da colecção actual. 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 ficheiro usar um separador que não seja uma vírgula, certifique-se que altera a opção de acordo com isso.

Para que o Tellico importe convenientemente o ficheiro, 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. Deverá atribuir os campos a cada coluna, seleccionando uma coluna com o rato ou alterando número da coluna em si, e depois seleccionando o campo a atribuir a partir da lista e, finalmente, carregando no botão Atribuir o Campo. Se quiser adicionar um campo novo à colecção, o último item na lista abre a Janela de Campos da Colecção.

Só são apresentadas as primeiras cinco linhas do ficheiro CSV importado na janela.

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

O Tellico é capaz de usar o serviço do freedb.org para consultar informações acerca de um CD, incluindo a lista de faixas. Dependendo da sua distribuição, a configuração do acesso ao serviço poderá ser definida no Configuração 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.

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

### Importar os Meta-Dados dos Ficheiros de Áudio

O Tellico é capaz de percorrer uma pasta e ler as marcas dos formatos de ficheiros de áudio comuns, como o `mp3` e o `ogg`. As músicas são introduzidas numa colecção de músicas, onde cada item é um álbum. Se os ficheiros de música tiverem o número de faixa, o nome da música é introduzido no local correcto 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 ficheiro.

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

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

### Importar as Bibliotecas do Alexandria

O Alexandria é um gestor de colecção de livros alternativo para o ambiente de trabalho GNOME. O módulo de importação oferece a hipótese de importar qualquer uma das bibliotecas encontradas em `$`HOME`/.alexandria/`.

### Importar os Dados do Catálogo de Filmes Ant

O Catálogo de Filmes Ant é um gestor de colecções de filmes alternativo.

### Importar Dados do Bibtex

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

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

### Importar Dados do Bibtexml

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

### Importar Dados das Delicious Library

A Delicious Library é um gestor de colecções alternativos para o ambiente de trabalho Mac® OS X. O Tellico importa um sub-conjunto dos dados usados pela Delicious Library.

### Importar Dados do GCstar

O GCstar é um gestor de colecções alternativo. É suportada a importação de livros, filmes, músicas, moedas, jogos normais, jogos de tabuleiro e vinhos.

O Tellico também consegue importar os ficheiros de dados do GCfilms. O GCfilms é o antecessor do GCstar e era um gestor de colecções de filmes. Normalmente, os ficheiros de dados do GCfilms encontram-se em `$`HOME`/.local/share/gcfilms/`.

### Importar Dados do Griffith

O Griffith é um gestor de colecções de filmes alternativos. O Tellico é capaz de importar a maioria dos dados de uma base de dados do Griffith.

### Importar Dados do MODS

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

### Importar Dados em PDF

Se o Tellico foi compilado com o suporte para o exempi ou o poppler, os meta-dados dos ficheiros PDF poderão ser importados. Os meta-dados 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 actualizar outros dados.

### Importar Dados do Referencer

O Referencer é um organizador de documentos e um gestor bibliográfico para o ambiente de trabalho GNOME. O Tellico irá importar a maioria dos dados encontrados numa base de dados do Referencer.

### Importar Dados do RIS

O The formato RIS é um formato de ficheiros bibliográficos usado pelo Reference Manager entre outros. O Tellico importa os ficheiros RIS como uma colecção bibliográfica.

### Importar uma Colecção do Goodreads

O Goodreads é uma rede social para os leitores seguirem colecções de livros. O Tellico pode importar a lista de livros da colecção de um utilizador, dando para tal o nome ou o ID do utilizador, desde que a colecção esteja configurada como acessível a nível público.

### Importar Listagens de Ficheiros

A melhor forma de criar um Catálogo de Ficheiros é importar o conteúdo de uma pasta. A mesma pasta poderá ser percorrida de forma recursiva, para adicionar todos os ficheiros 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 CD's ou DVD's. Para além disso, as antevisões das imagens do conteúdo do ficheiro poderão ser geradas, ainda que isso leve algum tempo para ler uma grande quantidade de ficheiros. As antevisões dos ficheiros são as mesmas que aparecem no Gestor de Ficheiros do KDE.

### Importar Dados em XML com XSLT

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

Arrastar e Largar
Arrastar e Largar

## Arrastar e Largar

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

Por isso, por exemplo, se quiser catalogar diversos ficheiros PDF, seleccione-os no gestor de ficheiros e arraste-os para a janela do Tellico. O Tellico irá importar tantos meta-dados dos ficheiros 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 colecção, os valores dos itens poderão ser exportados tal como foram introduzidos, ou então com a formatação automática oferecida pelo Tellico. Adicionalmente, a exportação poderá estar limitada aos itens seleccionados de momento na colecção, onde a barra de estado mostra o número de itens seleccionados.

Os ficheiros 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 operativo.

### Exportar para XML

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

### Exportar para ZIP

O formato de ficheiro padrão para o Tellico é um ficheiro comprimido com o ZIP, contendo o ficheiro de colecção em XML e, opcionalmente, todas as imagens referenciadas na colecção. Se as imagens forem guardadas na pasta da aplicação, a exportação para um ficheiro ZIP irá criar um ficheiro de dados autónomo, que contém todas as imagens na colecçã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 ficheiro HTML exportado, adicionando o texto `_files`.

O formato por omissã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.

Para além disso, poderá criar ficheiros individuais para cada item na colecção, com as referências criadas no ficheiro HTML de topo. Os ficheiros dos itens serão criados na mesma pasta que as imagens. Os ficheiros HTML dos itens irão usar o modelo da folha de estilo actual, 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

O Alexandria é um gestor de colecção de livros alternativo para o ambiente de trabalho GNOME. O Tellico é capaz de exportar um sub-conjunto limitados dos campos das colecções de livros para a localização predefinida do Alexandria.

### Exportar para o ONIX

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

### Exportar para o Bibtex

Ao exportar para o Bibtex, os valores dos campos poderão ser marcados com parêntesis ou marcas de citação. Se forem usadas algumas macros de texto na colecçã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 a gerar automaticamente a chave.

### Exportar para Bibtexml

O Bibtexml é um formato para expressar os dados do 'bibtex' em XML.

### Exportar o GCStar

O GCstar é outro gestor de colecções de filmes. O Tellico é capaz de exportar a maior parte dos tipos de colecções para um ficheiro de dados do GCstar.

### Exportar para XML com o XSLT

Finalmente, o Tellico consegue processar a sua representação interna em XML dos dados da colecçã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 ficheiros.

Lidar com Citações
Lidar com Citações

## Lidar com Citações

Ao trabalhar numa bibliografia, as citações para os itens seleccionados de momento poderão ser geradas e usadas em muitas outras aplicações. Uma citação no formato 'bibtex' poderá ser copiada para a área de transferência e depois colada num ficheiro em LaTeX. As citações do Bibtex poderão também ser enviadas para uma aplicação externa, como o LyX ou o Kile, usando o mecanismo conhecido do lyxpipe.

Capítulo 5. Utilização Avançada
Utilização Avançada

# Capítulo 5. Utilização Avançada

## Opções da Linha de Comandos

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

    Utilização: tellico [opções] [ficheiro]

    Tellico - um gestor de colecções do KDE

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

    Argumentos:
      ficheiro                  O ficheiro a abrir

A Interface de D-Bus
A Interface de D-Bus

## A Interface de 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 comandos. Como acontece com todas as chamadas de D-Bus, terá de 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 de D-Bus

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

#### O Objecto `Tellico`

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

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

Para os quatro comandos de importação, o primeiro argumento é o ficheiro a importar, enquanto o segundo é a acção de importação. Estão disponíveis três acções: replace (substituição), append (adição) e merge (reunião). São suportados quatro formatos de ficheiros na importação: ficheiros XML do Tellico, ficheiros Bibtex, ficheiros MODS e ficheiros RIS.

A colecção aberta de momento no Tellico poderá ser exportada para um ficheiro, sendo no formato XML do Tellico, no formato ZIP do mesmo, em Bibtex, HTML ou em valores separados por vírgulas (CSV).

Uma lista dos ID's dos elemento seleccionados ou filtrados de momento permite facilitar a apresentação ou actualização dos itens na janela.

Poderá abrir um novo ficheiro 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 de escrever o mesmo filtro no campo respectivo da janela principal.

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

#### O Objecto `Collections`

A lista completa de comandos D-Bus do objecto `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)

Poderá criar um novo elemento vazio na colecção actual, usando o comando addEntry(). O valor devolvido é o ID do elemento, que poderá ser usado para definir os valores dos campos do mesmo elemento. Poderá apagar um elemento da colecçã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 seleccionados de momento. Se não forem seleccionados nenhuns elementos, é devolvida uma lista vazia. Se for incluído num ID de elemento no comando, são devolvidos os valores dos campos para esse elemento em particular.

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

Poderá editar os elementos directamente com a interface D-Bus. Dado um ID de elemento, o setEntryValue() irá configurar o valor do campo directamente. Para adicionar um valor, sem afectar 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 do Tellico com a interface de D-Bus.

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

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

    Apresentar a chave de citação da selecção actual
    % 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 $o_meu_id título "O 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 do comportamento predefinido do Tellico.

Se carregar 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 Predefinição reverte as opções na página actual da janela para os seus valores predefinidos, enquanto a Ajuda abre o KHelpCenter com a secção relativa do manual do Tellico.

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

## Opções Gerais

As Opções Gerais controlam o comportamento geral. As imagens poderão ser incluídas nos ficheiros de dados ou gravadas em separado na pasta da aplicação Tellico. Do mesmo modo, quando for iniciado o Tellico, poderá reabrir automaticamente o último ficheiro de dados que foi aberto. A janela da Dica do Dia contém sugestões úteis sobre a utilização do Tellico e aparece no arranque do programa. Poderá querer seguir algumas das sugestões e depois desactivar a janela.

As Opções de Formatação controlam o nível de formatação automática que o Tellico efectua. Por exemplo, veja a secção de Formatação dos Campos. A capitalização e a formatação são opções distintas,s dado 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 a utilização 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 guardados 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 a terminar com um apóstrofo são suportados para fins de ordenação, também.

### Nota

Os valores actuais na colecçã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 colecçã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. Só os campos visíveis na Área de Colunas é que são impressos. Para além disso, se a colecção for filtrada, só são impressos os itens visíveis. Inicialmente, uma mensagem de aviso será apresentada se a filtragem estiver activa.

As Opções de Impressão permitem-lhe alterar alguma da formatação ao imprimir uma colecçã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 introduzidos.

A folha de estilo para impressão por omissão imprime a colecçã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. Para 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, estas 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 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. Poderá indicar um modelo diferente para cada tipo de colecção. Alguns modelos, como os de Álbum ou Vídeo são para um tipo específico de colecção, sendo que aparecerá uma breve mensagem de erro na Área de Itens se forem usados para outros tipos. O botão de Antevisão mostra uma janela que lhe permite antever como irá ficar o modelo. Poderá passar tipos de letra e cores personalizados ao modelo; de facto, todos os modelos predefinidos respeitam essa configuração. Contudo, os modelos personalizados poderão optar por ignorá-los.

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

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

Opções das Fontes de Dados
Opções das Fontes de Dados

## Opções das Fontes 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:

- Serviços Web da Amazon.com,

- a Internet Movie Database,

- servidores z39.50,

- servidores SRU,

- bases de dados Entrez (PubMed),

- AnimeNfo.com,

- Internet Bookshop Italia,

- ISBNdb.com,

- 'Plugins' do GCstar,

- arxiv.org,

- bibsonomy.org,

- crossref.org,

- Discogs.com,

- Wine.com,

- TheMovieDB.org,

- TheGamesDB.net,

- OMDBAPI.com,

- MusicBrainz.org,

- GiantBomb.com,

- OpenLibrary.org,

- Freebase.com,

- outros programas ou aplicações externos,

- combinações de quaisquer umas das fontes acima.

Poderá adicionar fontes novas se carregar 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 actualização dos itens, também poderá ser alterada.

Poderá obter modelos adicionais a partir do repositório 'online' do autor, carregando para tal no botão Transferir. Esses programas são assinados com GPG pelo autor, para evitar programas perigosos de fontes desconhecidas, os quais poderão prejudicar o seu sistema.

### Atenção

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

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

### Fontes de Dados Bibliográficas

#### Servidores z39.50

O protocolo z39.50 é usado para aceder 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, podendo ainda indicar manualmente a informação da ligação.

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

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

O porto por omissão para os servidores z39.50 é o 210, mas alguns servidores poderão usar um 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 então poderá não conseguir obter nenhuns itens.

Alguns servidores fornecem um utilizador e uma senha para o acesso. O Tellico pode usar e gravar essa senha, mas tenha atenção que é gravada no ficheiro de configuração do Tellico como texto simples, não sendo assim segura. Para os servidores mais públicos, o utilizador 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 eles, 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 extracçã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. De momento, 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 aceder ao recurso do CrossRef, tem de pedir uma conta e adicionar a sua informação de conta à configuração da fonte de dados.

#### Internet Bookstore Italia

A IBS, ou Internet Bookstore Italia, é uma loja de livros 'online' na Itália.

#### ISBNdb.com

A ISBNdb.com é uma base de dados 'online' de livros, com bibliotecas de recolha de dados 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 Bandas Desenhadas

#### AnimeNfo.com

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

### Fontes de Dados de Filmes

#### Base de Dados de Filmes Internet

A Internet Movie Database oferece informações acerca de filmes e vídeos. Quando é conduzida uma pesquisa sobre uma Pessoa, se for devolvido mais de um resultado, aparece uma janela que lhe permite seleccionar a pessoa correcta. As opções de configuração incluem a definição do endereço do servidor Web e se as imagens são capturadas ou não. Dado que a IMDb poderá devolver um grande número de membros do elenco, 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 registo de uma conta gratuita.

#### OMDBAPI.com

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

### Fontes de Dados de Músicas

#### Discogs.com

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

#### MusicBrainz.org

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

### Fontes de Dados de Vinhos

#### Wine.com

A Wine.com é uma vendedora de vinhos 'online', a qual oferece o acesso a uma informação em base de dados de diversas variedades de vinhos. É necessário o registo para uma conta gratuita.

### Fontes de Dados de Jogos de Vídeo

#### GiantBomb.com

A GiantBomb.com é uma grande base de dados de jogos de vídeo. É necessário o registo de uma conta gratuita.

#### TheGamesDB.net

A TheGamesDB.net é uma base de dados 'online' livre e aberta para fãs de jogos de vídeo.

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

#### Amazon.com

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

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. Alguma da informação da Amazon.com poderá 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 aceder 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.

#### 'Plugins' do GCstar

Se o GCstar estiver instalado, o Tellico é capaz de tirar partido da grande gama de 'plugins' de pesquisa disponíveis para o GCstar. Dependendo do tipo de colecção, estão disponíveis diversos recursos 'online' para usar como fontes de dados no Tellico

#### Freebase.com

O Freebase.com é uma base de dados 'online' que recolhe informações sobre qualquer tópico. O Tellico é capaz de procurar no Freebase por informações sobre livros, bandas desenhadas, músicas, filmes, jogos de vídeo e de tabuleiro.

#### Programas ou Aplicações Externos

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

Alguns programas vêm com o próprio Tellico. O Allocine.fr é uma loja de livros 'online' Francesa. O Ministério da Cultura Espanhol é uma base de dados de livros espanhóis 'online'. O Dark Horse Comics é uma editor de livros de banda desenhada. Todas estas fontes de dados necessitam do Python. O BoardGameGeek é uma página Web com dados extensivos sobre jogos de tabuleiro; este programa necessita do ruby.

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

A localização completa da aplicação deverá ser introduzida nas opções da fonte. Tenha em atenção que a aplicação é executada no sistema com as mesmas permissões que o utilizador actual, 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, introduzindo as opções da linha de comandos necessárias no campo de texto. O valor a procurar será introduzido onde aparecer o `%1`.

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

### Fontes de Dados Combinadas em Conjunto

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 colecção a ser usado terá de ser definido antes de adicionar as fontes.

Só poderá usar as fontes de dados existentes em conjunto. O pedido de pesquisa é enviado a cada fonte, sendo combinados todos os resultados. Dado 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, é bem-vindo para modificar o Tellico tanto quanto desejar. Poderá criar programas para importar, exportar ou modificar os dados com bastante facilidade. Este capítulo dá-lhe mais informações sobre como fazê-lo.

## Formato do Ficheiro

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

### Dados em XML

#### Colecçã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="Os Meus Livros" type="2">
     </collection>
    </tellico>

O ficheiro 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á gravar os ficheiros na versão actual. A localização da DTD aponta de facto para um ficheiro de DTD actual.

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

O elemento <tellico> contém um elemento <collection>. São ignoradas várias colecções, por agora. O atributo title contém o título da colecção, enquanto o type define os tipos de itens que estão contidos na colecção. Os tipos permitidos são apresentados numa secção posterior. Existe um atributo entryTitle opcional que poderá ser usado para definir o título dos itens numa colecçã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, excepto as propriedades extendidas, são incluídas como atributos do elemento <field>. Os valores permitidos para os atributos flags, format e type são dados na seguinte secção.

As propriedades dos campos são usadas para definir os valores predefinidos para os campos, os intervalos dos valores de classificações, os modelos dos valores derivados, etc. Os exemplos acima incluem um valor predefinido, 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 colecçã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 extra à colecção, o ficheiro de dados já não ficará mais em conformidade com a DTD. Contudo, o Tellico usa um processador de XML sem validação, pelo que 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 ficheiro 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 Colecção
Valores do Tipo de Colecção

## Valores do Tipo de Colecção

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

Tabela 7.1. Valores do Tipo de Colecção

Tipo de Colecção | Valor
--- | ---
Colecção Personalizada | 1
Colecção de Livros | 2
Colecção de Vídeos | 3
Colecção de Música | 4
Bibliografia | 5
Colecção de BD | 6
Colecção de Vinhos | 7
Colecção de Moedas | 8
Colecção de Selos | 9
Colecção de Cartões Comerciais | 10
Colecção de Jogos de Vídeo | 11
Catálogo de Ficheiros | 12
Colecçã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 predefinidos de uma colecçã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 é dado 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 activas, indicado como um valor em OR's do atributo 'flags' do elemento 'field'. A opção para impedir o utilizador 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 a Completação | `0x04`
Proibir a Limpeza | `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 de momento. O agrupamento por Pessoas usada todos os campos que usam a Formatação de Nomes. Se 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 Escondidas de Configuração
Opções Escondidas de Configuração

## Opções Escondidas 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 de encher a janela de configuração, mas representam opções que poderão apelar a vários utilizadores, sendo que a aplicação as lê do ficheiro de configuração.

A configuração do Tellico é gravada num ficheiro da pasta pessoal do utilizador, nomeadamente o `$`KDEHOME`/share/config/tellicorc`. Dentro desse ficheiro, a configuração é distribuída por grupos, os quais aparecem entre parêntesis rectos, como em '[General Options]'. Para adicionar uma opção ao grupo General Options, descubra a linha no ficheiro 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, poderá adicionar a opção por baixo do nome do grupo.

### [Opções Gerais]

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

#### Max Icon Size

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

#### Exemplo

`Max Icon Size=128`

#### Icon Cache Size

Poderá alterar o número máximo de ícones na 'cache' em memória com esta opção. O valor por omissão é 1000.

#### Exemplo

`Icon Cache Size=100`

#### Exemplo

`Max Icon Size=128`

#### Tamanho da 'Cache' de Imagens

Poderá alterar o tamanho máximo da memória em 'bytes' para usar como 'cache' de todas as imagens. O valor por omissão é 67108864.

#### Exemplo

`Image Cache Size=256000000`

### [Opções - 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 ficheiros '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 ficheiro `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 carácter 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 é que introduzido vários autores?
8.2. Posso modificar a aparência da página impressa?
8.3. Como é que agrupo por uma propriedade que não esteja listada na barra de ferramentas?
8.4. Porque é que aparece tanto lixo quando corro o Tellico?
8.5. Como é que altero as colunas que são apresentadas?
8.6. Como é que filtro por algo, como o campo "Lido"?
8.7. Como é que 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 se passou?
8.9. Como é que exporto os campos adicionais do Bibtex?
8.10. O que aconteceu ao Bookcase?
8.11. Com o que é que o Tellico tem a ver?
8.12. Porque é que inclui as referências à Amazon.com nos resultados da pesquisa?
8.13. Porque é que não usou uma base de dados real?

8.1. | Como é que introduzido 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 introduzidas da mesma forma, com um ponto-e-vírgula (;) a separar cada um dos valores.

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

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

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

8.3. | Como é que 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 omissão, assinale a opção "Permitir o Agrupamento", para esse campo em particular, na janela de "Campos da Colecção".
8.4. | Porque é que aparece tanto lixo quando corro 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. Na altura de compilação, isso pode ser interrompido com a opção ``--disable-debug``. 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 que o "0 (generic)" está desligado. Isso desliga todas as mensagens de depuração para todas as aplicações genéricas do KDE, isto é, as que não são distribuídas oficialmente pelo KDE.

8.5. | Como é que altero as colunas que são apresentadas?
| Carregue com o botão direito na barra do cabeçalho. Poderá também arrastar os cabeçalhos para reordenar as colunas, carregando depois nelas para ordenar por esse campo.
8.6. | Como é que 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 terá duas regras. Certifique-se que a opção "Corresponder a todos os seguintes" está activa. 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 carácter 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 é que adiciono novos modelos de itens?

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

Os modelos para a Janela de Relatórios estão gravados 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 se passou?

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 ficheiros que necessita. Isto acontece principalmente no SuSE; nesse caso, deverá compilar com ``--prefix`=`/opt/kde3``. Em alternativa, poderá adicionar uma linha ao seu ficheiro `.profile` que configure a variável $`KDEDIRS`. Veja a documentação sobre a sua linha de comandos.

8.9. | Como é que exporto os campos adicionais do Bibtex?
| O Tellico usa a propriedade bibtex para saber como exportar os campos do Bibtex. Se quiser adicionar campos extra à exportação, como um resumo, abra a Janela de Campos da Colecção e carregue no botão Propriedades Extendidas. 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 registadas, 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, exceptuando a mudança no nome.
8.11. | Com o que é que o Tellico tem a ver?
| O autor pensou em diversos nomes, sendo alguns deles relacionados com colecções de livros. Contudo, o Tellico pode lidar com mais do que apenas livros; para além disso, isto é um passatempo, pelo que o autor escolheu um nome que lhe soasse bem, retirado de uma cidade próxima do local onde cresceu.
8.12. | Porque é que 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 a 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 pagos.
8.13. | Porque é que não usou uma base 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 na altura e, de momento, só possui um conhecimento vago de como o usar. Em resumo, o Tellico não começou como uma base 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 para o efeito.

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 em baixo. Quando existir um atalho de teclado que efectue a função de um dado item do menu, é mostrada a combinação de teclas por omissão em conjunto com o item do menu.

### O Menu Ficheiro

Ficheiro → Novo

  Este comando cria uma colecção nova. O Tellico suporta 12 tipos de colecções predefinidos, em conjunto com uma colecção personalizada vazia para definir pelo utilizador.

Ficheiro → Abrir... (Ctrl+O)

  Este comando abre um ficheiro do Tellico.

Ficheiro → Abrir um Recente

  Este comentário abre um ficheiro a partir de um submenu que contém uma lista com os ficheiros abertos recentemente.

Ficheiro → Gravar... (Ctrl+S)

  Este comando grava a colecção. Se o ficheiro for Sem Título, então o Gravar... será equivalente ao Gravar Como. Só ficará activo quando a colecção tiver sido modificada.

Ficheiro → Gravar Como... (Ctrl+Shift+S)

  Este comando grava a colecção num ficheiro novo.

Ficheiro → Imprimir... (Ctrl+P)

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

Ficheiro → Importar

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

Ficheiro → Exportar

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

Ficheiro → Sair (Ctrl+Q)

  Este comando fecha a janela do Tellico. Se a colecção tiver alterações por gravar, ser-lhe-á questionado se as deseja gravar antes de continuar.

### O Menu Editar

Editar → Desfazer (Ctrl+Z)

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

Editar → Refazer (Ctrl+Shift+Z)

  Este comando repõe uma acção Desfazer anterior.

Editar → Cortar (Ctrl+X)

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

Editar → Copiar (Ctrl+C)

  Este comando copia o texto seleccionado, 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 → Seleccionar Tudo (Ctrl+A)

  Este comando selecciona todos os itens da colecção na Área de Colunas.

Editar → Deseleccionar (Ctrl+Shift+A)

  Este comando desmarca todos os itens na colecçã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.

### O Menu Colecção

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

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

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

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

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

  Este comando copia ou duplica os itens seleccionados como itens novos da colecção.

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

  Este comando apaga os itens seleccionados.

Colecção → Reunir os Itens

  Este comando reúne os itens seleccionados.

Colecção → Actualizar 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 actualizar os itens seleccionados.

Colecção → Dar Saída

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

Colecção → Dar Entrada

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

Colecção → Mudar o Nome da Colecção (Ctrl+R)

  Este comando abre uma janela para mudar o nome da colecção.

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

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

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

  Este comando abre a Janela de Relatórios para gerar relatórios acerca da colecção.

Colecção → Bibliografia → Converter para uma Bibliografia

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

Colecção → Bibliografia → Macros de Texto...

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

Colecção → Bibliografia → Procurar Chaves Duplicadas

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

Colecçã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.

Colecção → Bibliografia → Citar um Item no Lyx

  Este comando envia uma citação dos itens seleccionados para o lyxpipe, para que possa ser usado no LyX, Kile ou noutras aplicações de LaTeX. Só ficará activo ao editar uma bibliografia.

### Os Menus de Configuração e Ajuda

Para além dos menus de Configuração e Ajuda normais do KDE. descritos no capítulo de Menus dos Fundamentos do KDE, o Tellico tem estes itens de menu específicos da aplicação:

Configuração → Mostrar a Área de Grupos

  Este comando activa/desactiva a visibilidade da Área de Grupos.

Configuração → Mostrar o Editor de Itens

  Este comando activa/desactiva a visibilidade do Editor de Itens.

Configuração → Selecção do Grupo

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

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

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

Tellico

Programa com 'copyright' 2001-2011 de Robby Stephenson `(robby AT periapsis.org)`

Documentação com 'copyright' 2001-2011 de Robby Stephenson `(robby AT periapsis.org)`

Tradução de José Nuno Pires `(zepires AT gmail.com)`

Este programa está licenciado ao abrigo da GNU General Public License.

A documentação está licenciada ao abrigo da GNU Free Documentation License.

O autor desta documentação também lhe concedeu permissão de usar o conteúdo segundo os termos da FreeBSD Documentation License, se assim o escolher. Se optar por permitir o uso da sua versão para este conteúdo apenas segundos os termos da Licença de Documentação do FreeBSD, e não permitir que os outros usem a sua versão deste ficheiro 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 ficheiro segundo os termos da GFDL ou da Licença de Documentação do FreeBSD.