# Імпортування та експортування даних

&appname; може імпортувати та експортувати дані до файлів у найрізноманітніших форматах, а також шукати потрібні дані на сайтах у мережі Інтернет.

## Імпортування з мережі Інтернет

&appname; може виконувати пошук даних на різноманітних сайтах мережі Інтернет за допомогою діалогового вікна отримання даних. Записи може бути безпосередньо імпортовано і додано до вашої поточної збірки. Джерела даних можна налаштувати за допомогою параметрів джерел даних.

Пошук можна виконувати за різними критеріями: Назва, Особа, ISBN, UPC/EAN, LCCN або Ключове слово. Деякі з джерел даних підтримують не всі з перелічених критеріїв. ISBN і LCCN призначено лише для книжок, а UPC або EAN можна застосовувати до будь-яких записів.

Після запуску процедури пошуку напис Пошук на кнопці буде змінено на Зупинити, за допомогою натискання якої можна припинити пошук. Знайдені результати буде додано до списку, розташованого безпосередньо під полем пошуку, вибір елемента покаже результат без додавання його до збірки. Натискання кнопки Додати запис додасть всі вибрані елементи до вашої збірки. Якщо у джерелі даних буде знайдено більше результатів, ніж ви бажали, активною стане кнопка Отримати більше результатів. Натискання кнопки Очистити призведе до вилучення всіх результатів і відновлення початкових значень у полі пошуку.

Діалогове вікно отримання даних &appname;
Діалогове вікно отримання даних &appname;

Буде знайдено лише записи, які відповідають поточному типу збірки. У стовпчику Опис буде показано додаткові відомості щодо запису, наприклад, для того, щоб ви могли відрізнити відео у різних форматах або книги у різних палітурках. Після успішного додавання запису у перший стовпчик списку буде додано позначку.

Додати одразу декілька записів можна за допомогою стандартного способу вибору декількох елементів у &kde;: вам слід утримувати натиснутими клавіші &Shift; або &Ctrl; під час наведення вказівника миші на записи і клацання лівою кнопкою миші.

Для полегшення користування сканерами штрихкодів, до ключів пошуку можна включати декілька значень ISBN. Позначення пункту Кратний пошук за ISBN/UPC вимкне поле пошуку і увімкне кнопку Редагувати значення ISBN/UPC..., за допомогою натискання якої ви можете відкрити багаторядкове поле для введення тексту. Кожне зі значень ISBN слід вводити у окремий рядок. Після того, як ви натиснете кнопку закриття вікна кожне значення ISBN буде перевірено на коректне форматування. Інструмент перевірки ISBN здатен належно відформатувати перетворювати 13-цифрові значення EAN, а також повноцінні коди UPC. Список ISBN можна також прочитати з текстового файла.

## Імпортування даних

У &appname; передбачено три різних дії під час імпортування даних. Вибір пункту Замірити поточну збірку закриє поточну збірку і створить нову з даними з імпортованого файла. Вибір варіантаДодати все до поточної збірки повідомляє &appname;, що слід додати всі записи у імпортованій збірці до поточної збірки, а також додати всі поля, яких у цій збірці не існує. Вибір пункту Об’єднати збірки призведе до результатів, схожих на додавання, але всі імпортовані записи буде порівняно з поточними, всі ідентичні записи буде пропущено. &appname; намагається визначити відповідні запис, які не є повністю ідентичними, порівнюючи значимі поля і об'єднуючи схожі записи. Наприклад, у музичній збірці програма виконує порівняння записів виконавця та альбому, — для відповідних записів метадані композицій буде об’єднано. Інструмент імпорту звукових файлів здатен коректно створювати списки композицій об’єднанням записів.

### Імпортування даних з іншого програмного забезпечення

&appname; може безпосередньо імпортувати дані з багатьох інших програм для керування збірками, зокрема GCstar, OnMyShelf, Data Crow, Alexandria, Delicious Library, Collectorz, Ant Movie Catalog, Referencer та Griffith.

### Імпортування даних у інших форматах

&appname; може імпортувати дані у багатьох форматах, зокрема CSV, bibtex, форматі записів звукових дисків та файлів, MODS, &PDF; та RIS.

#### Імпортування даних &appname;

Ви можете безпосередньо імпортувати файли даних &appname;. Заміна поточної збірки імпортуванням файла &appname; ідентична простому відкриттю самого файла. Імпортування даних &appname; призначено в основному для додавання або об’єднання двох збірок.

#### Імпортування даних CSV

Значення, відокремлені комами (Comma-separated values або CSV) є типовим форматом імпортування та експортування табличних даних. Значення кожного з полів буде відокремлено комами, кожен з записів слід вказувати у окремому рядку. Назви полів може бути включено у перший рядок. Інструмент імпорту CSV може використовувати і відмінні від коми роздільники. Ви можете вказати будь-який інший символ або рядок.

Діалогове вікно імпортування CSV
Діалогове вікно імпортування CSV

Перш за все, оберіть тип збірки, яку ви бажаєте імпортувати. Якщо ви додаєте або об’єднуєте збірку з іншою збіркою, тип буде обмежено типом вашої поточної збірки. Якщо перший рядок файла CSV містить назви полів, позначте відповідний пункт і інструмент імпорту автоматично порівняє ці назви з назвами полів поточної збірки. Якщо назви полів збірки збігатимуться, заголовок відповідного стовпчика буде змінено так, щоб стовпчик було призначено відповідному полю. Якщо у файлі використовується роздільних, відмінний від коми, не забудьте змінити відповідний параметр імпортування збірки.

Щоб програма &appname; належним чином імпортувала файл, ви маєте надати програми відомості щодо того, яке з полів відповідає кожному зі стовпчиків. Якщо у заголовку стовпчика міститься лише число, дані у цьому стовпчику не буде імпортовано. Вам слід призначити поля до кожного зі стовпчиків або натисканням цього заголовка стовпчика, або зміною самого номера стовпчика з наступним вибором поля для призначення зі спадного списку і натисканням кнопки Призначити поле. Якщо ви бажаєте додати нове поле до збірки, останній пункт у спадному списку відкриває діалогове вікно полів.

Задля компактності, у цьому діалоговому вікні буде показано лише перші п’ять рядків з імпортованого файла CSV. Втім, імпортовано буде усі дані.

#### Імпортування даних з звукового компакт-диска

Програма &appname; здатна використовувати службу freedb.org для пошуку відомостей щодо компакт-дисків, зокрема списку композицій. Залежно від дистрибутива, який ви використовуєте, параметри доступу до служби можна визначити у Системних параметрах &kde;. Буде додано виконавець компакт-диска, назву, жанр, рік і список композицій.

Крім того, якщо на диску міститься CD-Text, програма прочитає і додасть прочитані відомості до імпортованого запису.

#### Імпортування метаданих зі звукового файла

Програма &appname; здатна просканувати теку і прочитати мітки у звукових файлах типових форматів, зокрема `mp3` і `ogg`. Композиції буде додано до музичної збірки, кожним з записів якої буде альбом. Якщо у файлах композицій міститимуться номери композицій, назву композиції буде вставлено на правильне місце у списку композицій. Крім того, до запису буде додано відомості щодо виконавця і жанр. Якщо у мітках композиції містяться коментарі, їх буде додано до поля коментарів у записі, якій передуватиме назва файла.

Крім того, якщо у теці міститься файл `.directory`, а назва теки збігається з назвою альбому, як зображення обкладинки альбому буде використано значення `Icon` у цьому файлі.

Інструмент імпорту метаданих з звукових файлів здатний виконати рекурсивний пошук у теці з метою виявлення всіх звукових файлів у підтеках, хоча перехід за символічними посиланнями і не здійснюватиметься. Для читання метаданих зі звукових файлів &appname; використовує бібліотеку TagLib, отже програма здатна здійснювати імпорт даних з файлів будь-якого типу, який підтримується TagLib.

#### Імпортування даних Bibtex

Bibtex — це формат зберігання бібліографій, який використовується у системі підготовки документів LaTeX. До відповідного файла може бути включено найрізноманітніші типи бібліографічних посилань. &appname; імпортує файли bibtex як бібліографічні збірки.

Якщо інструментом імпорту bibtex буде виявлено у файлі поля, яких не було у типовій бібліографічній збірці, ці поля буде додано як поля типу Простий текст за двома винятками. Якщо значення поля містить більше, ніж 100 символів, його буде перетворено на поле типу Стаття. Якщо у значенні поля міститиметься адреса &URL; або посилання на файл, буде створено поле URL. Для обробки файлів bibtex &appname; використовує внутрішню копію бібліотеки btparse.

Bibtexml — це &XML;-представлення даних bibtex, дані з імпортованого файла bibtexml імпортуватимуться так само, як дані з файлів bibtex.

#### Імпортування даних з MODS

MODS — це формат представлення різноманітних типів збірок аудіо, відео та друкованих даних. У поточній версії &appname; імпортуються лише збірки книг як бібліографічні збірки.

#### Імпортування даних з &PDF;

Якщо &appname; було зібрано з підтримкою exempi або poppler, програма зможе імпортувати метадані з файлів &PDF;. Серед імпортованих метаданих заголовок, автор і дата створення, а також бібліографічні ідентифікатори, які буде використано для встановлення інших даних.

#### Імпортування даних з RIS

Формат RIS — це формат бібліографічних файлів, який використовується програмою EndNote, Reference Manager та іншими програмами. &appname; імпортує файли RIS як бібліографічні збірки.

### Імпортування інтернет-збірок

&appname; може встановлювати з'єднання із сайтами, які зберігають дані особистих збірок, і імпортувати з них дані.

#### Імпортування збірки BoardGameGeek

BoardGameGeek — ресурс, який присвячено іграм на дошці та спілкуванню щодо них. &appname; може імпортувати ігри на дошці до збірки користувача, якщо ця збірка є загальнодоступною. Імпортовані дані обмежуватимуться лише тими записами, для яких ви є власником.

#### Імпортування збірки Goodreads

Goodreads — соціальна мережа читачів у інтернеті, призначена для обміну даними щодо книжкових збірок. &appname; може імпортувати список книжок зі збірки користувача, якщо програмі надано ім’я користувача або його ідентифікатор, а доступ до збірки відкрито.

#### Імпортування збірки LibraryThing

LibraryThing — інтернет-служба, яка спрощує створення каталогів книг. &appname; може імпортувати список книг у збірці користувача, яку експортовано у форматі JSON.

#### Імпортування збірки Discogs

Discogs — база даних в інтернеті та торговельний майданчик для музики. &appname; може імпортувати список музичний творів зі збірки користувача, якщо програмі надано ім’я користувача, а доступ до збірки відкрито.

### Імпортування списків файлів

&tellico; здатна виконувати сканування тек для імпортування даних файлів, в основному, щоб для створення каталогів файлів. Пошук у теці може бути виконано рекурсивно для додавання всіх файлів, які буде знайдено у підтеках. Цей інструмент імпорту найкорисніший для створення списків резервного копіювання і мультимедійних каталогів, зокрема переліків файлів на компакт-дисках і DVD. Крім того, може бути створено мініатюри зображень вмісту файлів. Мініатюри вмісту файлів будуть тими самими, які ви бачите у інструменті керування файлами &kde;.

Теки з електронними книгами та файлами відео можна також імпортувати яка збірки книг або відео. Програма здатна читати метадані файлів, а для файлів відео для доповнення записів відео може бути використано будь-які наявні файли `nfo`.

### Імпортування даних &XML; через XSLT

До &appname; може бути імпортовано будь-який файл &XML;, якщо буде вказано таблицю стилів XSL, призначену для перетворення вмісту файла у формат &appname;. &appname; автоматично завантажує таблицю стилів і виконує XSLT-обробку, потрібну для завантаження цього файла.

## Перетягування і скидання

Перетягування зі скиданням файлів даних у головне вікно &appname; призведе до імпортування цих файлів у той самий спосіб, у який відбувається це відбувається після вибору пункту імпортування з меню програми. Перетягування зі скиданням працює для файлів у таких форматах: Tellico, Bibtex, RIS, &PDF; та EPub. Крім того, підтримується одночасне імпортування декількох файлів.

Отже, якщо ви, наприклад, бажаєте каталогізувати декілька файлів &PDF;, виберіть їх у програмі для керування файлами і перетягніть вибірку до вікна &appname;. &appname; імпортує якомога більше метаданих з цих файлів, а потім спробує отримати додаткові відомості з різноманітних налаштованих джерел у Інтернеті.

## Експортування даних

Під час експортування даних до збірки програма може експортувати дані без обробки або виконати автоматичне форматування, вбудоване у &appname;. Крім того, експорт може бути обмежено поточними вибраними записами у збірці, кількість вибраних записів можна побачити у смужці стану.

Експортовані текстові файли, зокрема Bibtex або CSV, можуть використовувати кодування символів Unicode (UTF-8) або поточне локальне кодування операційної системи.

Загальні параметри експорту
Загальні параметри експорту

### Експортування до &XML;

&appname; зберігає дані у форматі файла &XML; стиснутого zip. Експортування у формат &XML; призведе до простого створення файла &XML; без додаткового стискання zip. Зображення може бути включено до файла &XML; як закодовані у base64 дані у елементі «image», але за такого експорту ви отримаєте дуже великі текстові файли.

### Експортування до Zip

Стандартним форматом файлів для &appname; є форма стиснутий zip. У отриманому архіві міститиметься файл збірки &XML; і, якщо це було вказано, всі зображення, на які у збірці є посилання. Якщо ви оберете зберігання зображень у теці програми, дія з експорту до файла Zip призведе до створення самодостатнього файла даних, у якому міститимуться всі зображення у збірці.

### Експортування до &HTML;

Для виконання дії з експортування до HTML буде використано таблицю стилів `tellico2html.xsl`. Зображення буде експортовано до теки з назвою, яка збігається з назвою експортованого файла HTML з додаванням суфікса `_files`.

Типовий формат подібний до друкованого виводу, отже ви можете скористатися різноманітними параметрами для зміни &HTML;. Заголовки полів може бути надруковано у верхній частині кожного зі стовпчиків, але на жаль, у &kde; ще немає підтримки заголовків таблиць з повторенням на кожній зі сторінок. Записи може також бути згруповано за параметрами перегляду груп.

Крім того, програма може створити окремі файли для кожного з записів збірки, у файлі &HTML; найвищого рівня буде створено посилання на ці файли. Файли записів буде створено у тій самій теці, де зберігаються файли зображень. Для створення файлів &HTML; записів буде використано поточний шаблон таблиці стилів, який було використано для показу перегляду записів.

Параметри експорту до HTML
Параметри експорту до HTML

### Експортування до CSV

Значення, відокремлені комами (Comma-separated values або CSV) є типовим форматом імпортування та експортування табличних даних. Значення кожного з полів буде відокремлено комами, кожен з записів буде вказано у окремому рядку. Назви полів може бути включено у перший рядок. Інструмент імпорту CSV може використовувати і відмінні від коми роздільники.

Параметри експорту до CSV
Параметри експорту до CSV

### Експортування до Alexandria

Alexandria — це інструмент керування збірками для стільничного середовища GNOME. У &appname; передбачено можливість експорту обмеженої підмножини полів збірок книжок до типового місця зберігання даних програми Alexandria.

### Експортування до ONIX

ONIX — це формат XML, призначений для представлення даних і обміну даними щодо продуктів книжкової індустрії, його призначено в основному для розповсюджувачів книжок. У &appname; передбачено можливість експорту збірок з використанням незначної підмножини даних ONIX.

### Експортування до Bibtex

Під час експорту до Bibtex значення полів може бути екрановано фігурними дужками або лапками. Якщо у збірці було використано рядкові макроси, програма, за вашого бажання, може експортувати ці макроси або розгорнути їх. Для полів &URL; &appname; може включити значення у теґ `\url{...}`. Нарешті, записи без ключа цитування може бути пропущено, якщо ви не наказали &appname; автоматично створювати ключі.

Параметри експорту до Bibtex
Параметри експорту до Bibtex

### Експортування GCstar

GCstar — це ще один інструмент керування збірками фільмів. &appname; може експортувати більшість типів збірок до файла даних GCstar.

### Експортування &XML; через &xslt;

Нарешті, &appname; може обробляти внутрішнє представлення &XML; даних збірки за допомогою зовнішньої таблиці стилів XSL перед експортуванням. Цей тип експортування може бути корисним для створення текстових звітів або файлів інших типів.

## Робота з посиланнями

Якщо ви працюєте з бібліографією, програма може створити посилання для поточних вибраних записів, ви зможете скористатися цими посиланнями у інших програмах. Посилання у форматі bibtex можна скопіювати до системного буфера обміну даними, а потім вставити до файла latex. Посилання Bibtex також може бути напряму передано зовнішній програмі, зокрема LyX або Kile за допомогою так званого lyxpipe.