# Importar e Exportar Dados

O &appname; é 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 &appname; é 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.

A Janela de Pesquisa na Internet do &appname;
A Janela de Pesquisa na Internet do &appname;

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

O &appname; 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 &appname; 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 &appname;

Poderão ser importados outros ficheiros de dados do &appname;. A substituição da colecção actual, através da importação de um ficheiro de dados do &appname;, é a mesma coisa que abrir o próprio ficheiro. O valor da importação dos dados do &appname; é 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.

A Janela de Importação de CSV
A Janela de Importação de CSV

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 &appname; 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 &appname; é 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 &systemsettings; 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 &appname; é 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 &appname; 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 &appname; 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 &appname; 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 &appname; 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 &appname; 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 &appname; é 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 &appname;, como uma colecção bibliográfica.

### Importar Dados em PDF

Se o &appname; 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 &appname; 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 &appname; 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 &appname; 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 &appname;, desde que exista uma folha de estilo &XSL; disponível para converter o ficheiro para o formato do &appname;. O &appname; carrega automaticamente essa folha de estilo e aplica o processamento de &xslt; necessário para carregar o ficheiro.

## Arrastar e Largar

O arrastamento de ficheiros de dados para a janela principal do &appname; 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 &appname;. O &appname; 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

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 &appname;. 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.

Opções Gerais de Exportação
Opções Gerais de Exportação

### Exportar para &XML;

O formato do ficheiro de dados do &appname; é 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 &appname; é 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.

Opções de Exportação para &HTML;
Opções de Exportação para &HTML;

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

Opções de Exportação para CSV
Opções de Exportação para CSV

### Exportar para o Alexandria

O Alexandria é um gestor de colecção de livros alternativo para o ambiente de trabalho GNOME. O &appname; é 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 &appname; 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 &appname; 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 &appname; a gerar automaticamente a chave.

Opções de Exportação para Bibtex
Opções de Exportação para Bibtex

### 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 &appname; é 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 &appname; 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

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.