# Импорт и экспорт данных

&appname; поддерживает импорт и экспорт различных файлов данных, а также поиск информации на интернет-сайтах.

## Импорт данных из Интернета

Чтобы выполнить поиск информации на интернет-сайтах с помощью &appname;, следует открыть диалог «Поиск в Интернете». Записи возможно напрямую импортировать и добавить в текущую коллекцию. Источники данных настраиваются в разделе меню Параметры источников данных.

При поиске возможно использовать различные критерии: Название, Человек, ISBN, UPC/EAN, LCCN или Ключевое слово. Для некоторых источников данных поддерживаются не все критерии. Значения ISBN и LCCN возможно искать только для книг, в то время как поиск значений UPC или EAN поддерживается для элементов любого типа.

Когда поиск начинается, кнопка Поиск превращается в кнопку Стоп, с помощью которой возможно завершить поиск. Результаты по мере получения добавляются в список, расположенный под полем поиска. При выборе одного из элементов в списке соответствующий результат будет показан, но не добавлен в коллекцию. Для добавления всех выбранных элементов в коллекцию следует нажать кнопку Добавить запись. Если количество результатов, которое предоставил источник данных, превышает изначально запрашиваемое, станет доступна кнопка Больше результатов. Кнопка Очистить позволяет удалить все текущие результаты и сбросить параметры поиска.

Диалог «Поиск в Интернете» &appname;
Диалог «Поиск в Интернете» &appname;

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

Возможно добавить сразу несколько записей, выделив их с помощью стандартного метода множественного выбора &kde;: обычно для этого требуется удерживать клавишу &Shift; или &Ctrl; при щелчке по элементу.

Для удобства работы со сканерами штрихкодов при поиске возможно включить несколько значений ISBN/UPC. При выборе параметра Множественный поиск по ISBN/UPC поле поиска станет недоступным, а кнопка Изменить коды ISBN/UPC... — доступной. Если нажать эту кнопку, появится окно для ввода нескольких строк текста. Каждый номер ISBN необходимо вводить на отдельной строке. После закрытия этого окна будет проверена корректность форматирования каждого введённого номера ISBN. При этой проверке 13-значные значения EAN, а также полные коды UPC могут быть преобразованы в надлежащий формат. Кроме того, возможно выполнить чтение списка номеров ISBN из текстового файла.

## Импорт данных

&appname; позволяет выбрать один из трёх варинтов действий при импорте данных. Заменить текущую коллекцию — будет выполнено закрытие текущей коллекции и создание новой коллекции, содержащей данные из импортируемого файла. Добавить к текущей коллекции — если выбран этот вариант, программа &appname; добавит все записи из импортируемой коллекции к текущей коллекции, а также добавит те поля, которых не было в текущей коллекции (при наличии). Действие Объединить коллекцию аналогично добавлению, но все импортируемые запись будут сравниваться с текущими записями и не будут добавлены в случае обнаружения полного совпадения. При обнаружении частично совпадающих записей &appname; выполняет сравнение основных полей и затем объединяет записи. Например, в коллекциях музыки сравниваются исполнитель и альбом. Если они совпадают, то перечень дорожек будет объединён. Средство импорта аудиофайлов поддерживает создание корректных списков дорожек на основе объединённых записей.

### Импорт данных из других программ

&appname; позволяет напрямую импортировать данные из других программ для управления коллекциями, в том числе GCstar, Alexandria, Delicious Library, Collectorz, Ant Movie Catalog, Referencer и Griffith.

### Импорт из файлов других форматов

&appname; поддерживает импорт данных из многих других форматов, включая CSV, BibTeX, аудиодиски и аудиофайлы, MODS, &PDF; и RIS.

#### Импорт данных &appname;

Другие файлы данных &appname; возможно импортировать напрямую. Нет особого смысла выполнять импорт файла &appname; для замены текущей коллекции — возможно просто открыть сам этот файл. Импорт данных &appname; следует выполнять для добавления или объединения коллекций.

#### Импорт из файла CSV

Импорт и экспорт табличных данных обычно выполняется с помощью разделённых запятой значений (CSV). Каждое значение поля отделяется запятой, на одной строке должна быть только одна запись. Заголовки полей возможно включить в первую строку. Средство импорта из файла CSV принимает в качестве разделителя не только запятую. Возможно использовать любой символ или строку.

Диалог импорта из файла CSV
Диалог импорта из файла CSV

Сначала следует выбрать тип импортируемой коллекции. Если эта коллекция будет добавлена к открытой коллекции или объединена с ней, для выбора будет доступен только тип текущей коллекции. Если первая строка файла CSV содержит заголовки полей, установите соответствующий флажок, чтобы средство импорта выполнило автоматическое сравнение заголовков с полями текущей коллекции. Если названия полей совпадают, заголовок столбца изменится, показывая, что столбец назначен данному полю. Если в файле используется разделитель, отличный от запятой, измените соответствующий параметр надлежащим образом.

Для корректного импорта файла &appname; необходимо установить соответствие между полями и столбцами. Если заголовок столбца содержит только цифру, содержащиеся в этом столбце данные не будут импортированы. Необходимо назначить поле каждому из столбцов: выберите столбец (щёлкните внутри него мышью или измените сам номер столбца), затем выберите в раскрывающемся списке поле, которое следует назначить, и нажмите кнопку Назначить поле. Чтобы добавить к коллекции новое поле, выберите в раскрывающемся списке последний элемент: будет открыт диалог «Поля коллекции».

Для экономии пространства на экране в диалоге отображаются только первые пять строк импортируемого файла CSV. Но импортированы будут все строки, которые содержатся в файле.

#### Импорт данных Audio &CD;

&appname; позволяет использовать сервис freedb.org для поиска информации о &CD;, включая список дорожек. Параметры доступа к сервису возможно указать в разделе параметров системы &kde; (в зависимости от дистрибутива). Будут добавлены данные об исполнителе, названии, жанре, годе выпуска и списке дорожек &CD;.

Кроме того, если диск содержит &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.

### Импорт списков файлов

Лучший способ создать Каталог файлов — импортировать содержимое папки. В папке возможно выполнить рекурсивный поиск, чтобы добавить все обнаруженные в ней файлы. Это средство импорта наиболее полезно для создания резервных копий списков и каталогизации носителей (например, списков &CD; или DVD). Также возможно создать миниатюры содержимого файлов (следует учитывать, что на чтение большого количества файлов может потребоваться некоторое время). Миниатюры файлов аналогичны тем, которые отображаются в диспетчере файлов &kde;.

### Импорт данных &XML; с помощью XSLT

В &appname; возможно импортировать любой файл &XML;, если доступна таблица стилей &XSL; для преобразования этого файла в формат &appname;. &appname; автоматически загружает таблицу стилей и выполняет обработку &xslt;, необходимую для загрузки файла.

## Перетаскивание

Для импорта файлов данных возможно не только воспользоваться командой импорта в меню, но и просто перетащить эти файлы в главное окно &appname;. Перетаскивание поддерживается для файлов следующих форматов: Tellico, BibTeX, RIS и &PDF;. Также возможно импортировать сразу несколько файлов.

Например, если требуется добавить несколько файлов &PDF;, выберите их в диспетчере файлов и перетащите в окно &appname;. После этого &appname; импортирует из файлов максимально возможное для программы количество метаданных и затем получит дополнительные сведения из различных настроенных интернет-источников.

## Экспорт данных

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

Для экспортируемых текстовых файлов, таких как BibTeX или CSV, возможно использовать кодировку Юникода (UTF-8) или текущую локаль операционной системы.

Общие параметры экспорта
Общие параметры экспорта

### Экспорт в &XML;

Формат файла данных &appname; — это сжатый файл &XML;. При экспорте в &XML; просто создаётся файл &XML; без сжатия. В файл &XML; возможно включить изображения как элемент с данными в кодировке Base64, но размер создаваемых при этом текстовых файлов может быть очень большим.

### Экспорт в ZIP

Стандартный формат файла &appname; — это сжатый файл, содержащий файл &XML; коллекции и (необязательно) все изображения, на которые имеются ссылки в коллекции. Если же изображения хранятся в папке приложения, при экспорте в файл ZIP будет создан отдельный файл данных, содержащий все изображения в коллекции.

### Экспорт в &HTML;

При экспорте в &HTML; используется таблица стилей `tellico2html.xsl`. Изображения экспортируются в папку с таким же именем, что и у экспортируемого файла &HTML;, с добавлением `_files`.

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

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

Параметры экспорта в &HTML;
Параметры экспорта в &HTML;

### Экспорт в CSV

Импорт и экспорт табличных данных обычно выполняется с помощью разделённых запятой значений (CSV). Каждое значение поля отделяется запятой, на одной строке должна быть только одна запись. Заголовки полей возможно включить в первую строку. В качестве разделителя значений возможно использовать не только запятую, но и любой другой символ или строку.

Параметры экспорта в CSV
Параметры экспорта в CSV

### Экспорт в Alexandria

Alexandria — это диспетчер коллекций книг для окружения рабочего стола GNOME. &appname; позволяет экспортировать ограниченный набор полей коллекции книг в расположение данных Alexandria по умолчанию.

### Экспорт в ONIX

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

### Экспорт в BibTeX

При экспорте в файл BibTeX значения полей могут быть заключены в скобки или кавычки. Если в коллекции используются строковые макросы, их возможно экспортировать как макросы или в развёрнутом виде. &appname; поддерживает использование тега `\url{...}` для значений тех полей, которые содержат &URL;. Записи без ключа цитирования возможно пропускать, а не создавать ключ автоматически с помощью &appname;.

Параметры экспорта в BibTeX
Параметры экспорта в BibTeX

### Экспорт в GCstar

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

### Экспорт в &XML; с помощью &xslt;

Наконец, &appname; поддерживает предэкспортную обработку своего внутреннего &XML;-представления данных коллекции с помощью внешней таблицы стилей &XSL;. Этот тип экспорта может быть полезен, когда требуется создать текстовые отчёты или файлы других типов.

## Работа с цитатами

При работе с библиографией возможно создавать цитаты для текущих выбранных записей, чтобы затем использовать их в других приложениях. Цитату в формате BibTeX возможно скопировать в буфер обмена и затем вставить в файл LaTeX. Цитаты BibTeX также возможно отправить во внешнее приложение (например, LyX или Kile), с помощью lyxpipe.