Руководство пользователя Tellico

# Руководство пользователя Tellico

Robby Stephenson `<robby@periapsis.org>`

Перевод на русский язык: Олеся Герасименко
Издание Tellico 3.4 (14 марта 2021 г.)

Авторские права © 2001-2022 Robby Stephenson

Сведения о лицензировании этого программного обеспечения и этой документации доступны в последнем разделе.

Этот документ представляет собой руководство по использованию программного приложения Tellico, которое предназначено для управления коллекциями.

Список таблиц

2.1. Допустимые изменения типа поля
2.2. Примеры форматирования
7.1. Значения типов коллекций
7.2. Значения типов полей
7.3. Значения флагов полей
7.4. Значения формата поля

Глава 1. Введение
Введение

# Глава 1. Введение

## Tellico

Tellico — это программа для управления коллекциями. Изначально созданная как простой диспетчер коллекций книг, в настоящее время программа содержит шаблоны по умолчанию для библиографий, коллекций комиксов, видео, музыки, монет, марок, карточек, видеоигр, вин, настольных игр и каталогов файлов. Кроме того, возможно создавать пользовательские коллекции для других предметов коллекционирования.

### Что может Tellico?

Tellico позволяет вести учёт предметов в коллекции и предоставляет удобный способ ввода данных для каждой записи. Приложение поддерживает несколько типов полей, а также позволяет создавать неограниченное количество пользовательских полей. Записи коллекции возможно сгруппировать по любому полю, а настраиваемые представления позволяют управлять количеством отображаемых сведений.

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

### Чего не может Tellico?

Tellico не является средством воспроизведения аудио- или видеозаписей. Приложение не поддерживает чтение или изменение файлов мультимедиа. Редактирование изображений также не поддерживается. Несмотря на то, что Tellico в некоторой мере поддерживает управление библиографическими списками, приложение не является полнофункциональным диспетчером библиографических ссылок. А также Tellico ни в коей мере не претендует на наличие всех возможностей полнофункциональной реляционной базы данных.

В качестве своего рода оговорки об отказе от ответственности: Tellico — это авторский хобби-проект, для которого не предоставляются какие-либо гарантии работоспособности, пригодности и так далее. Дополнительные сведения доступны в заявлении о лицензировании.

Терминология
Терминология

## Терминология

### Коллекции

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

### Поля коллекции

Каждая коллекция может содержать неограниченное количество полей. Tellico поддерживает одиннадцать типов полей, что позволяет вводить различные данные. Поля возможно редактировать с помощью диалога «Поля коллекции». Более подробные сведения о полях доступны в разделе Типы полей.

### Записи коллекции

Запись — это базовая запись в Tellico. Каждая запись содержит одно значение для каждого поля коллекции. Теоретически, количество записей коллекции не ограничено, но так как вся коллекция всегда находится в памяти, слишком большое количество записей может привести к снижению скорости работы приложения.

По результатам тестирования работы Tellico с коллекцией, состоящей из 10 000 записей, скорость была удовлетворительной. Но в том случае, если коллекция содержит много больших изображений, на загрузку и обработку потребуется гораздо больше времени. Для повышения производительности возможно настроить Tellico на хранение изображений отдельно от самого файла данных: либо в папке приложения, либо в папке, связанной с файлом данных. Дополнительные сведения доступны в разделе о настройке.

Глава 2. Использование Tellico
Использование Tellico

# Глава 2. Использование Tellico

## Начало работы

По умолчанию Tellico запускается с пустой коллекцией книг. Для работы с коллекцией другого типа создайте её с помощью пункта меню Файл → Новая или кнопки на панели инструментов. В создаваемые коллекции уже будут включены некоторые наиболее востребованные поля (при необходимости поля возможно добавлять, изменять или удалять).

Редактор записей позволяет добавлять новые записи. Выберите в меню пункт Коллекция → Новая запись...: будет открыт диалог Изменение записи с пустой доступной для редактирования записью. Редактор записей также возможно открыть с помощью пункта меню Настройка → Показать представления → Редактор записей. Чтобы сохранить запись в коллекции после ввода значений, нажмите кнопку Сохранить запись в диалоге Изменение записи (диалог останется открытым, что позволяет добавить другие новые записи). Чтобы изменить сохранённую запись, щёлкните по ней в главном окне. Если редактор записей ещё не открыт, сделайте по записи двойной щелчок, чтобы открыть её в редакторе и начать вносить изменения.

Если в запись требуется включить изображение, это возможно сделать с помощью стандартного средства выбора файлов KDE: нажмите кнопку Выбрать изображение... в диалоге Изменение записи или перетащите в редактор записей изображение из диспетчера файлов или веб-браузера.

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

Записи коллекции группируются по совпадающим значениям определённых полей (например, поле с указанием автора или режиссёра). Поле, которое используется для группировки, возможно изменить с помощью раскрывающегося списка на панели инструментов или пункта меню Настройка → Группировать.

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

Общее использование
Общее использование

## Общее использование

Главное окно подразделяется на три области. Все они по-разному представляют сведения о коллекции. Главное представление — таблица записей в верхней правой части окна, которая позволяет просмотреть значение каждого поля каждой записи. В левой части окна расположены вкладки групп (на этой вкладке возможно упорядочить записи по группам в виде дерева), фильтрованного представления (оно используется для отслеживания записей, соответсвующих определённым критериям) и просмотра долгов (на этой вкладке показан список отданных на время предметов коллекции). В области информации о записях, расположенной в нижней правой части окна, находится форматированное представление данных отдельной записи или отображаются значки записей в составе группы.

### Просмотр таблицы записей

В таблице записей могут быть показаны любые поля, но, вероятно, поля типа Большой текст, Изображение, и Таблица не будут полезны. Щёлкните по заголовку представления правой кнопкой мыши, чтобы выбрать в контекстном меню отображаемые поля. Размер и порядок столбцов возможно изменять, и эти изменения будут сохраняться между сеансами.

### Просмотр групп

В представлении групп записи сгруппированы по любому полю, которое поддерживает группировку, в виде дерева. Количество записей, содержащихся в группе, показано рядом с её названием. Группы возможно разворачивать и сворачивать: щёлкните по значку стрелки или сделайте двойной щелчок по группе. Чтобы развернуть или свернуть все группы, выберите соответствующую опцию в контекстном меню, которое вызывается нажатием правой кнопки мыши. Дерево записей возможно упорядочить либо по названиям групп, либо по количеству записей (щёлкните по заголовку). Чтобы использовать группу в качестве фильтра для таблицы, щёлкните по группе правой кнопкой мыши.

Если параметр Форматировать как название включён для нескольких полей коллекции, будет добавлена дополнительная группа, объединяющая все эти поля, — псевдогруппа Люди.

Если в записи отсутствует значение того поля, которое используется для формирования групп, она будет помещена в группу (пусто) со значком красной папки.

### Фильтрованное представление

Если для коллекции сохранены какие-либо фильтры, фильтрованное представление становится активным. Записи, которые добавляются или изменяются, будет проверены на соответствие фильтрам и, соответственно, добавлены или удалены. Чтобы изменить фильтр, сделайте по нему двойной щелчок: будет открыт диалог «Расширенный фильтр». Чтобы удалить фильтр, выберите соответствующий пункт в контекстном меню, которое вызывается по щелчку правой кнопкой мыши.

### Просмотр долгов

Когда записи получают отметку о выдаче соответствующих предметов на руки, в окно приложения добавляется область просмотра долгов, которая позволяет отслеживать эти записи. Долговые записи отслеживаются по отдельности. Чтобы изменить долговую запись, щёлкните по ней правой кнопкой мыши и выберите в контекстном меню соответствующий пункт для открытия диалога изменения долговой записи.

### Просмотр записей

В области просмотра записей содержится форматированное представление значений записи. Макет и дополнительные графические элементы определяются используемым шаблоном. В диалоге конфигурации возможно указать отдельный шаблон для каждого из типов коллекций, а также настроить цвета и шрифты.

Все шаблоны по умолчанию будут использовать заданные цвета и шрифты, но в пользовательских шаблонах эти параметры могут быть проигнорированы. Шаблоны по умолчанию также делают активными поля с URL-адресами (переход по ссылке выполняется с использованием стандартной привязки файла KDE). Когда выполняется экспорт в HTML, для экспорта отдельных файлов записей используется текущий шаблон.

### Строка состояния

Строка состояния позволяет увидеть, какое действие в настоящее время выполняет приложение Tellico. Кроме того, в ней показано общее количество записей коллекции и (если используется фильтр) количество отображаемых в настоящий момент записей.

Редактирование записей
Редактирование записей

## Редактирование записей

Для добавления и изменений записей коллекции используется редактор записей. При двойном щелчке по записи (либо в представлении групп, либо в таблице записей) появится окно редактора записей, в котором эта запись будет доступна для редактирования. Чтобы создать новую запись, выберите соответствующий пункт меню Коллекция, нажмите значок на панели инструментов или кнопку в самом редакторе записей.

Если на момент закрытия окна редактора записей имеются несохранённые изменения, появится предупреждение. Поля группируются по категории и показываются в том же порядке, что и в диалоге «Поля коллекции». Их порядок возможно изменить.

Если щёлкнуть по названию поля, содержащего URL-адрес, будет выполнен переход по ссылке с использованием стандартной привязки файла KDE. При нажатии кнопки выбора URL, расположенной рядом с текстовой записью, будет открыт стандартный диалог выбора файла KDE, но в поле возможно указывать не только локальные файлы.

Если поле содержит изображение, при нажатии кнопки Выбрать изображение... будет открыт диалог выбора файла изображения KDE. Изображение сохраняется в коллекции в исходном формате, при этом в редакторе записей отображается его уменьшенная версия. Чтобы убрать изображение, нажмите кнопку Очистить. После этого изображение будет удалено из коллекции.

Виджет редактирования также поддерживает перетаскивание. Возможно не выбирать изображение с помощью диалога выбора файла, а просто перетащить его из окна диспетчера файлов или браузера. Если перетащить изображение из окна виджета редактирования в окно диспетчера файлов Konqueror, оно будет сохранено в указанной папке.

### Предупреждение

По умолчанию изображения хранятся в файле данных коллекции. Но в том случае, если изображений слишком много, работа Tellico замедлится, а файл данных станет очень большим. В Tellico предусмотрен альтернативный способ хранения изображений. Их возможно хранить отдельно: либо в папке `$`KDEHOME`/share/apps/tellico/data/`, либо в папке, расположенной там же, где и файл данных. Если изображения хранятся отдельно, загрузка и сохранение файлов данных выполняются гораздо быстрее, но эти файлы данных будет нельзя перенести или сжать. Чтобы создать автономные файлы данных, выберите в меню пункт Файл+Экспорт → Экспорт в Zip....

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

### Редактирование нескольких записей

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

Изменены будут только те поля, для которых установлен флажок доступности. Это упрощает масштабное редактирование. Например, чтобы указать носитель для всех видеозаписей коллекции, сделайте поле «Носитель» доступным для редактирования. Измените его значение на DVD и сохраните записи. Будет изменено только поле «Носитель», а значения всех остальных полей записей останутся прежними.

### Обновление данных записей

Записи возможно обновлять автоматически посредством запроса к источникам данных, доступным для текущего типа коллекции, при этом возможно совмещать данные из нескольких источников. Например, в коллекцию возможно добавить фильм с помощью веб-служб Amazon.com, а затем обновить запись дополнительными сведениями из интернет-каталога фильмов IMDb.

Если перезапись существующей информации полученными результатами запрещена (это определяется значением параметра для соответствующего источника), будут обновлены только пустые поля. Для использования внешних сценариев необходимо указать обновляемое поле в параметрах источника.

Чтобы начать обновление записи, выберите соответствующий пункт в контекстном меню записи (оно открывается по щелчку правой кнопкой мыши) или воспользуйтесь пунктом меню Коллекция → Обновить запись.

Редактирование полей
Редактирование полей

## Редактирование полей

Диалог «Поля коллекции» позволяет добавлять новые поля коллекции, а также изменять или полностью удалять существующие.

### Список полей

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

### Свойства поля

Свойства поля определяются его названием, типом, категорией, описанием и, возможно, значением по умолчанию или какими-либо допустимыми значениями. Название поля используется для обозначения этого поля в интерфейсе пользователя. Редактор записей использует название для получения значений. В таблице записей название становится заголовком столбца. Описание различных типов полей приводится в разделе «Типы полей». В редакторе записей описание используется в качестве всплывающей подсказки, поясняющей содержимое поля. Кроме того, для полей с зависимыми значениями используется шаблон, который позволяет отформатировать значение поля. При создании новой записи автоматически добавляется значение по умолчанию. Значения, которые содержатся в списке допустимых для полей типа Выбор, необходимо разделять точкой с запятой.

Тип создаваемого поля может быть любым, но для уже существующих полей возможно выбрать только какой-либо из допустимых типов. В приведённой далее таблице показаны возможные варианты:

Таблица 2.1. Допустимые изменения типа поля

Текущий тип | Допустимый новый тип
--- | ---
Простой текст | Простой текст, Большой текст, Номер, URL-адрес, Таблица
Большой текст | Простой текст, Большой текст
Выбор | Простой текст, Большой текст, Выбор, Номер, URL-адрес, Таблица
Выбор да/нет | Простой текст, Большой текст, Выбор да/нет, Номер, URL-адрес, Таблица
Номер | Простой текст, Большой текст, Номер, URL-адрес, Таблица
URL-адрес | Простой текст, Большой текст, Номер, URL-адрес, Таблица
Дата | Простой текст, Дата
Таблица | Простой текст, Большой текст, Таблица
Изображение | Изображение
Рейтинг | Выбор, Рейтинг

### Форматирование полей

Tellico предоставляет возможности автоматического форматирования значений полей. Простейшая из них — автоматическое изменение регистра на верхний (изменяется регистр всех слов, за исключением артиклей). При форматировании названий определённые артикли перемещаются из начала поля в его конец. Например, название «The Return of the King» будет преобразовано в «Return of the King, The». Артикли в названиях возможно настроить. Наконец, при форматировании имён выполняется попытка разбить строку, чтобы фамилия человека была показана в начале. Префиксы и суффиксы имён возможно настроить. Кроме того, все поля, содержащие форматирование имён, включаются в специальную группу Люди, даже если глобальный параметр отключён.

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

Таблица 2.2. Примеры форматирования

Тип формата | Значение поля | С автоматическим повышением регистра | С автоматическим форматированием | С автоматическим повышением регистра и автоматическим форматированием
--- | --- | --- | --- | ---
Название | the return of the king | The Return of the King | return of the king, the | Return of the King, The
Имя | tom swift, jr. | Tom Swift, Jr. | swift, jr., tom | Swift, Jr., Tom

### Параметры поля

Поля также имеют три общих параметра. Если автодополнение включено, Tellico будет кэшировать значения для каждого поля и в редакторе записей будут предлагаться варианты автодополнения (с использованием стандартных параметров KDE). Автодополнение поддерживается не для всех типов полей. Для работы Tellico также требуется информация о том, может ли поле содержать несколько значений или использоваться для группировки записей. При редактировании записи с несколькими значениями следует отделять одно от другого с помощью точки с запятой.

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

Фильтрация записей
Фильтрация записей

## Фильтрация записей

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

Каждая строка содержит одно правило фильтра. Выберите поле, которое будет проверяться на соответствие, в начале строки, затем выберите правило соответствия в центре строки. Правила позволяют искать записи, значения которых содержат заданное слово или же в точности соответствуют ему. Для поиска соответствий также возможно использовать регулярное выражение (при выборе этого варианта станет активной кнопка Изменить..., которая предназначена для редактирования выражения, если на компьютере установлена программа KRegExpEditor). После этого следует указать в поле ввода слово или строку для поиска. При работе с полями изображений для фильтрации возможно использовать размер изображения: значение фильтра сравнивается с наибольшим измерением изображения (шириной или высотой).

В фильтре возможно использовать не более восьми (8) правил. Кнопки Больше и Меньше позволяют добавлять и удалять правила.

Фильтры возможно сохранять: в этом случае все записи, которые соответствуют условиям поиска, будут сгруппированы в области фильтрованного представления. Представление является динамическим, поэтому при добавлении или изменении записей группа будет автоматически обновляться. Чтобы сохранить фильтр, введите его название в текстовом поле и нажмите кнопку Сохранить фильтр.

Сохранённые ранее фильтры возможно изменить. Для этого щёлкните правой кнопкой мыши по фильтру в фильтрованном представлении и выберите в контекстном меню пункт Изменить фильтр: будет открыт диалог «Расширенный фильтр», который позволяет изменить название или правила фильтра.

Если требуется посмотреть, какие научно-фантастические книги ещё не были прочитаны, выберите параметр Соответствует всем условиям, добавьте первое правило «Жанр» «содержит» «Научная фантастика» и второе правило «Прочитано» «не содержит» «true» (без кавычек). (Для полей типа Выбор да/нет внутренним значением является true).

Чтобы посмотреть только книги, которые написали Пушкин и Гоголь, выберите параметр Соответствует любому из условий, добавьте первое правило «Автор» «содержит» «Пушкин» и второе правило «Автор» «содержит» «Гоголь» (без кавычек).

Построение отчётов
Построение отчётов

## Построение отчётов

Tellico поддерживает построение различных отчётов о текущей коллекции. При открытии диалога «Отчёт по коллекции» выполняется поиск XSLT-шаблонов по пути установки и в каталоге `$`KDEHOME`/share/apps/tellico/report-templates/`. Соответственно, возможно создать новые шаблоны, которые будут автоматически найдены и добавлены как возможные варианты в диалоге «Отчёт по коллекции». На построение сложных отчётов по большим коллекциям может потребоваться некоторое время.

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

В отчёт будет включены только те записи, которые показаны в таблице записей (то есть диалог «Отчёт по коллекции» использует активный фильтр, если таковой имеется).

Отслеживание долгов
Отслеживание долгов

## Отслеживание долгов

Tellico поддерживает отслеживание записей коллекции, содержащих отметку о выдаче соответствующего предмета на руки. Чтобы открыть диалог «Долговая запись», выберите в главном меню или в контекстном меню записи пункт Отдать в долг.... Эту операцию возможно выполнить сразу для нескольких записей.

Возможно указать получателя предмета напрямую или же получить сведения о нём из стандартной адресной книги KDE, нажав кнопку рядом с записью имени. В качестве даты выдачи устанавливается текущая дата, но это возможно изменить. Дату возврата указывать необязательно. Также возможно добавить другие примечания.

Если дата возврата указана и приложение Tellico скомпилировано с поддержкой libkcal, будет возможно добавить напоминание о долге в стандартный календарь KDE как задачу. Для просмотра таких задач возможно использовать KOrganizer.

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

Общие советы
Общие советы

## Общие советы

Далее приводятся советы, которые содержатся в списке «Совет дня» Tellico.

### Подсказка

Если у книги несколько авторов, для обеспечения правильной работы приложения их имена необходимо разделять точкой с запятой. Точку с запятой (;) также следует использовать в качестве разделителя значений и во всех других полях, которые содержат несколько значений.

### Подсказка

Чтобы выбрать поля для отображения в списке, щёлкните по заголовку столбца правой кнопкой мыши.

### Подсказка

Поля коллекции возможно добавлять и редактировать с помощью диалога «Поля коллекции». Чтобы изменить порядок поля в списке, воспользуйтесь кнопками со стрелками, расположенными под списком полей (при этом порядок поля будет соответствующим образом изменён и в редакторе записей).

### Подсказка

Если следует отфильтровать записи по полю с логическим значением (Выбор да/нет), необходимо использовать значение «true». Например, если требуется посмотреть, какие научно-фантастические книги ещё не были прочитаны, выберите параметр Соответствует всем условиям», добавьте первое правило «Жанр» «содержит» «Научная фантастика» (без кавычек) и второе правило «Прочитано» «не содержит» «true» (без кавычек).

### Подсказка

Если в быстром фильтре используется символ, который не является обычной буквой, текст будет обрабатываться как регулярное выражение. Например, чтобы посмотреть только книги, которые написали Пушкин и Гоголь, следует ввести в поле быстрого фильтра «Пушкин|Гоголь» (без кавычек).

### Подсказка

Чтобы отредактировать сразу несколько записей, следует выделить нужные записи, удерживая клавишу Shift или Ctrl, и открыть их для редактирования.

### Подсказка

Текущую коллекцию книг возможно преобразовать в библиографию, а затем экспортировать в формат BibTeX или Bibtexml.

### Подсказка

Когда имена вводятся в несколько полей, в коллекцию добавляется дополнительная группа «Люди», с помощью которой возможно сортировать и печатать вместе, например, авторов и редакторов.

### Подсказка

Возможно изменять внешний вид выводимых на печать отчётов, редактируя файл `tellico-printing.xsl`. Этот файл создаёт HTML, а CSS в таблице стилей определяет шрифт, поля и так далее.

### Подсказка

Двойной щелчок по записи позволяет открыть редактор записей для изменения её содержимого.

### Подсказка

В любое поле типа Большой текст возможно добавлять теги HTML, например для выделения <b>полужирным</b> или <i>курсивом</i>.

### Подсказка

Если в таблице записей нажать на клавиатуре клавишу с какой-либо буквой, будет выполнен переход к следующей записи, которая начинается с этой буквы.

### Подсказка

Зависимые значения позволяют объединять значения из нескольких полей в одно значение. Установите в определении поля соответствующий флажок и воспользуйтесь шаблоном значений наподобие «`%{поле_А}%{поле_Б}`» (в результате %{...} будет заменено значением соответствующего поля). Это полезно для комбинирования различных значений в одном поле, то есть для улучшения группировки, и для объединения значений полей разных типов с сохранением правильной сортировки. Пример — числовое поле, после которого идёт текст наподобие 3b, 14a.

Глава 3. Описание Tellico
Описание Tellico

# Глава 3. Описание Tellico

## Типы полей

Каждая коллекция может включать неограниченное количество полей. Tellico поддерживает одиннадцать типов полей, что позволяет вводить в них самые разные данные.

### Простой текст

Базовый тип поля называется Простой текст. Значения полей этого типа могут быть любыми, а средство ввода данных — это обычная строка ввода. Этот тип подходит для полей, в которых не планируются длинные значения (например, для полей с автором или жанром).

### Номер

Тип Номер идентичен типу Простой текст, но вводимые данные могут быть только числовыми. Если в табличном представлении щёлкнуть по столбцу поля Номер, записи будут упорядочены по номерам. Для ввода данных используется обычная строка ввода, с маленькими кнопками стрелок для увеличения или уменьшения значения. Какое-либо форматирование не применяется.

### URL-адрес

Тип URL-адрес позволяет создавать ссылки на другие документы: для открытия этих документов используются стандартные сопоставления типов файлов KDE. Проверка фактического значения поля URL-адрес не выполняется, но при этом недействительные ссылки не будут открыты. Ввод данных выполняется с помощью строки ввода с кнопкой вызова стандартного диалога открытия файла, но возможно использовать любой URL-адрес. Относительные URL-адреса интерпретируются относительно расположения сохранённого файла данных.

В редакторе записей, подпись становится ссылкой, в то время как в области информации о записи используется настоящая гиперссылка. Этот тип поля подходит, например, для ссылок на PDF-файлы библиографических записей или на обзоры фильмов. Какое-либо форматирование не применяется.

Также возможно использовать относительные URL-адреса. Они интерпретируются относительно расположения файла данных Tellico. В редакторе записей строка ввода поддерживает автодополнение расположений локальных файлов. Если URL-адрес, указанный в диалоговом окне выбора файла KDE, необходимо интерпретировать относительно расположения документа, следует установить свойство поля URL-адреса relative в значение true.

### Большой текст

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

### Выбор

Тип Выбор позволяет ограничить поле несколькими предварительно заданными значениями. Допустимые значения представлены в раскрывающемся списке. Выбрать возможно только одно из них. Тип Выбор используется, например, для полей библиографии и личного рейтинга.

Допустимые значения необходимо разделять точкой с запятой.

### Выбор да/нет

Для полей, которые принимают значение «да» или «нет», следует использовать тип Выбор да/нет. По умолчанию будет выбрано значение «нет». Поля типа Выбор да/нет не поддерживают форматирование и могут иметь только одно значение. Внутри программы значения таких полей передаются как `true` или `false`. Примеры полей этого типа: «Подарок» и «Одолжено».

### Дата

Поле типа Дата может содержать день, месяц и год. Дата показана в стандартном формате ГГГГ-ММ-ДД, что позволяет упростить упорядочение записей. Дату возможно как ввести напрямую, так и выбрать с помощью мыши в окне стандартного средства выбора дат KDE. Значения года, месяца или дня могут быть пустыми: например, возможно ввести только год. Использование нескольких значений не поддерживается.

### Таблица

Поля типа Таблица содержат один или несколько столбцов со значениями. В редакторе записей поле такого типа представлено как электронная таблица с пронумерованными строками. При выборе последней строки будет добавлена дополнительная строка. Автодополнение не поддерживается. Поле такого типа подходит для перечня глав в книге, сцен в фильме или песен в альбоме. Поля типа Таблица всегда являются самостоятельными категориями.

Чтобы указать количество столбцов (максимальное количество — не более десяти), в определение поля следует добавить свойство columns. Для добавления подписей столбцов необходимо щёлкнуть по заголовку правой кнопкой мыши или указать свойство поля column1 и так далее.

Когда редактор записей используется для полей типа Таблица, возможно изменять порядок строк, перетаскивая их с помощью мыши с зажатой клавишей Ctrl. Чтобы вставить или удалить строки, щёлкните по таблице правой кнопкой мыши для вызова соответствующего контекстного меню.

### Изображение

Поля типа Изображение содержат изображения любого формата, который поддерживается KDE. Например, PNG или JPEG. Изображение возможно сохранить как внутри самого файла данных Tellico, так и в каталоге данных приложения. Для сохранения используется стандартное диалоговое окно выбора файла KDE, поэтому возможно указать URL-адрес или просто выбрать локальный файл. Также возможно перетащить изображения из диспетчера файлов или браузера.

### Рейтинг

Поля типа Рейтинг содержат определённое количество звёзд, представляющих числовой рейтинг записи. По умолчанию максимальное значение рейтинга равняется пяти. Минимальное и максимальное значения возможно изменить с помощью параметров определения поля в диалоге «Поля коллекции» (параметры minimum и maximum).

### Зависимые значения полей

Поля с зависимыми значениями — это особый случай. Тип поля соответствует обычному типу значения, которое содержится в поле, но это значение формируется путём получения из других полей с помощью строки форматирования в описании поля. Например, если поле имеет шаблон значения `%{title} %{year}`, то значением этого поля будет заголовок, за которым следует год. Этот тип поля используется в основном для полей заголовков в коллекциях монет, марок, коллекционных карточек и вин. В описании для форматирования возможно использовать либо внутреннее название поля, либо заголовок поля.

Чтобы выбрать для поле с несколькими значениями только одно, добавьте в шаблон индекс положения (например, `%{author:1}` для выбора первого автора). Положение может иметь отрицательное значение при счёте с конца, поэтому `%{author:-1}` будет означать последнего автора. С помощью флагов шаблона возможно использовать значения в верхнем и нижнем регистре (например, `%{author:1/l}` будет означать первого автора в нижнем регистре, а `%{author:1/u}` — в верхнем регистре).

Типы коллекций
Типы коллекций

## Типы коллекций

По умолчанию Tellico поддерживает двенадцать типов коллекций: книги, библиографические записи, комиксы, видео, музыка, видеоигры, коллекционные карточки, монеты, марки, вина, настольные игры и каталоги файлов. Кроме того, в программе доступен пустой базовый шаблон коллекции для других предметов коллекционирования. В коллекциях по умолчанию предусмотрен только основной набор полей. Поля возможно добавлять, изменять или удалять для обеспечения лучшего соответствия коллекции потребностям пользователя. Обязательное условие только одно: в коллекции должно иметься поле Название, это необходимо для корректной работы области Группы. В коллекциях некоторых типов это поле просто содержит зависимое значение, сочетая два или больше других значений.

В целом, все типы коллекций работают одинаково. Для книг возможно использовать соответствующую коллекцию по умолчанию или же легко создать пользовательскую. Но выбор значков, которые будут использоваться в Tellico, выполняется на основе типа коллекции. Некоторые из них могут иметь специализированный функционал, доступный только для определённых коллекций, поэтому рекомендуется по возможности выбирать коллекции по умолчанию. Например, если требуется создать коллекцию вин, но поля по умолчанию не подходят, следует создать коллекцию вин по умолчанию, а затем удалить все поля по умолчанию. Тогда Tellico всё равно будет работать с этой коллекцией как с коллекцией вин.

По умолчанию все типы коллекций включают поле Номер, которое содержит идентификационный номер записи. Кроме того, каждая коллекция (за исключением каталога файлов) включает поля с датой создания записи в коллекции и временем её последнего изменения.

### Коллекции книг

Коллекции книг содержат 27 полей по умолчанию: Название, Подзаголовок, Автор, Переплёт, Дата приобретения, Цена покупки, Издательство, Редакция, Год сдачи в печать, Год издания, ISBN#, LCCN#, Количество страниц, Язык, Жанр, Ключевые слова, Серия, Номер серии, Состояние, Подписано, Прочитано, Подарок, Одолжено, Рейтинг, Лицевая сторона обложки, Сюжет и Комментарии.

Поле ISBN# является особым, так как цифры номера ISBN форматируются автоматически и вычисляется контрольный разряд. Поле ISBN будет распознано Tellico, если его внутренним названием является isbn. Если это поле было удалено или его требуется добавить в коллекцию другого типа, следует создать поле с названием ISBN и применить изменение (затем к полю будет можно вернуться и изменить название необходимым образом). В Tellico создание внутреннего названия выполняется на основе исходного названия, но в случае его последующего обновления созданное внутреннее название не будет изменено.

### Библиографии

Библиографии содержат 25 полей по умолчанию: Название, Тип записи, Автор, Ключ BibTeX, Название книги, Редактор, Организация, Издательство, ISBN#, Адрес, Редакция, Количество страниц, Год, Научный журнал, Месяц, Номер, Как издавалась, Глава, Серия, Номер серии, Том, Перекрёстная ссылка, Ключевые слова, Аннотация и Заметки.

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

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

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

### Коллекции комиксов

Коллекции комиксов содержат 23 поля по умолчанию: Название, Подзаголовок, Писатель, Художник, Серия, Издание, Издательство, Редация, Год издания, Количество страниц, Страна, Язык, Жанр, Ключевые слова, Состояние, Дата приобретения, Цена покупки, Подписано, Подарок, Одолжено, Лицевая сторона обложки, Сюжет и Комментарии.

### Коллекции видео

Коллекции видео содержат 30 полей по умолчанию: Название, Носитель, Год записи, Сертификация, Жанр, Регион, Страна, Формат, В ролях, Режиссёр, Продюсер, Писатель, Композитор, Студия, Языки звукового сопровождения, Языки субтитров, Аудиодорожки, Продолжительность, Соотношение сторон, Широкоэкранное, Цветность, Режиссёрская версия, Сюжет, Личный рейтинг, Дата приобретения, Цена покупки, Подарок, Одолжено, Обложка и Комментарии.

Поле В ролях представляет собой таблицу с двумя столбцами: первый предназначается для имён актёров, второй — для их ролей. Поле Продолжительность изначально предусматривает указание продолжительности в минутах, но при необходимости это возможно изменить.

### Коллекции музыки

Коллекции музыки содержат 15 полей по умолчанию: Название, Носитель, Исполнитель, Лейбл, Год, Жанр, Дорожки, Рейтинг, Дата приобретения, Цена покупки, Подарок, Одолжено, Ключевые слова, Обложка и Комментарии.

### Коллекции видеоигр

Коллекции видеоигр содержат 16 полей по умолчанию: Название, Платформа, Жанр, Год выпуска, Издатель, Разработчик, Возрастной рейтинг, Описание, Личный рейтинг, Пройдено, Дата приобретения, Цена покупки, Подарок, Одолжено, Обложка и Комментарии.

### Коллекции карточек

Коллекции карточек содержат 17 полей по умолчанию: Название, Игрок, Команда, Бренд, Номер карточки, Год, Серия, Тип карточки, Дата приобретения, Цена покупки, Место, Подарок, Ключевые слова, Количество, Лицевая сторона, Обратная сторона и Комментарии.

### Коллекции монет

Коллекции монет содержат 16 полей по умолчанию: Название, Тип, Номинал, Год, Монетный двор, Страна, Набор монет, Оценка, Служба оценки, Дата приобретения, Цена покупки, Место, Подарок, Аверс, Реверс и Комментарии.

### Коллекции марок

Коллекции марок содержат 16 полей по умолчанию: Название, Описание, Наименование, Страна, Год выпуска, Цвет, Номер по каталогу Scott, Оценка, Погашена, Со следами наклейки, Центровка, С клеевой основой, Дата приобретения, Цена покупки, Место, Подарок, Изображение и Комментарии.

### Коллекции вин

Коллекции вин содержат 15 полей по умолчанию: Название, Производитель, Аппелласьон, Сорт, Тип, Страна, Дата приобретения, Цена покупки, Место, Количество, Срок годности, Рейтинг, Подарок, Изображение этикетки и Комментарии.

### Коллекции настольных игр

Коллекции настольных игр содержат 17 полей по умолчанию. Название, Жанр, Механизм, Год выпуска, Издательство, Дизайнер, Число игроков, Продолжительность игры, Минимальный возраст, Описание, Рейтинг, Дата приобретения, Цена покупки, Подарок, Одолжено, Обложка и Комментарии.

### Каталоги файлов

Каталоги файлов содержат 14 полей по умолчанию: Имя, URL-адрес, Описание, Том, Папка, Тип MIME, Размер, Права, Владелец, Группа, Создано, Изменено, Метаданные и Значок.

### Коллекции прочего

Пользовательские коллекции содержат одно поле по умолчанию — поле Название. Такие коллекции следует создавать в том случае, если предметы коллекционирования не подходят ни под один из типов коллекций по умолчанию.

Глава 4. Импорт и экспорт данных
Импорт и экспорт данных

# Глава 4. Импорт и экспорт данных

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Кроме того, если диск содержит CD-Text (текстовую информацию о компакт-диске), она будет прочитана и добавлена в импортируемую запись.

#### Импорт метаданных аудиофайлов

Tellico поддерживает сканирование папки и чтение тегов для распространённых форматов аудиофайлов, например, для `mp3` и `ogg`. Песни включаются в коллекцию музыки, в которой каждая запись является альбомом. Если файл песни содержит номер дорожки, название песни будет помещено в соответствующую позицию списка дорожек. К записи также добавляется информация об исполнителе и жанре. Если теги песни содержат комментарии, они будут добавлены в поле комментариев записи после имени файла.

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

Средство импорта метаданных аудиофайлов поддерживает рекурсивное сканирование папок. Это позволяет найти все аудиофайлы во вложенных папках, несмотря на то, что переходы по символическим ссылкам не выполняются. В Tellico для чтения метаданных аудиофайлов используется библиотека TagLib — это позволяет импортировать данные из файлов, типы которых поддерживаются TagLib.

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

BibTeX — это формат библиографий, который используется совместно с системой подготовки документов LaTeX. В файл возможно включить библиографические ссылки различного типа. Tellico выполняет импорт файлов BibTeX как Библиографической коллекции.

Если средством импорта BibTeX в файле обнаружены поля, которые не присутствуют в библиографической коллекции по умолчанию, они будут добавлены как поля типа Простой текст, за исключением двух случаев. Первый: если значение поля содержит более 100 символов, будет создано поле типа Большой текст. Второй: если значение поля содержит URL-адрес или ссылку на файл, будет создано поле типа URL-адрес. Для обработки файлов BibTeX в Tellico используется внутренняя копия библиотеки btparse.

Bibtexml — это XML-представление данных BibTeX. Данные из импортированного файла Bibtexml обрабатываются точно так же, как и данные BibTeX.

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

MODS — это формат, предназначенный для представления коллекций носителей различных типов. В настоящее время Tellico поддерживает только импорт книг (как Библиографической коллекции).

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

Если программа Tellico была скомпилирована с поддержкой exempi или poppler, импорт метаданных из файлов PDF возможен. Метаданные могут включать сведения о названии, авторе и дате, а также библиографические идентификаторы, которые в дальнейшем используются для обновления другой информации.

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

Формат RIS — формат библиографических файлов, который используется приложениями, среди которых EndNote, Reference Manager и другие. Tellico выполняет импорт файлов RIS как Библиографической коллекции.

### Импорт сетевых коллекций

Tellico позволяет подключаться к веб-сайтам, которые обеспечивают управление личными коллекциями, и выполнять импорт таких коллекций.

#### Импорт коллекции BoardGameGeek

BoardGameGeek — это сетевой игровой ресурс и сообщество. Tellico позволяет импортировать настольные игры из коллекций пользователей, если соответствующие коллекции находятся в открытом доступе. Импортируемую коллекцию возможно ограничить теми элементами, которыми владеет пользователь.

#### Импорт коллекции Goodreads

Goodreads — сетевая социальная сеть, которая позволяет читателям отслеживать коллекции книг. Tellico поддерживает импорт списка книг из коллекции пользователя, указанного по имени или идентификатору, если эта коллекция находится в открытом доступе.

#### Импорт коллекции LibraryThing

LibraryThing — это сетевой сервис, который предназначен для упрощения каталогизации книг. Tellico позволяет импортировать списки книг из коллекций пользователей, которые были экспортированы в формате JSON.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Экспорт в XML с помощью XSLT

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

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

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

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

Глава 5. Дополнительные возможности
Дополнительные возможности

# Глава 5. Дополнительные возможности

## Параметры командной строки

При запуске Tellico из командной строки доступно несколько вариантов открытия файлов данных. Чтобы просмотреть их, воспользуйтесь командой `tellico --help`.

    Формат: tellico [параметры] [filename]

    Tellico — свободный простой диспетчер коллекций

    Параметры:
      --nofile                  Не открывать автоматически последний файл
      --bibtex                  Импортировать <filename> как файл BibTeX
      --mods                    Импортировать <filename> как файл MODS
      --ris                     Импортировать <filename> как файл RIS
      --pdf                     Импортировать <filename> как файл PDF

    Аргументы:
      [filename]                  Открыть заданный файл

Интерфейс D-Bus
Интерфейс D-Bus

## Интерфейс D-Bus

Tellico имеет минимальный интерфейс D-Bus, который возможно использовать для создания сценариев или взаимодействия с работающим приложением с помощью командной строки. Как и для всех остальных вызовов D-Bus, потребуется указать службу, с которой следует выполнить взаимодействие, и конкретный интерфейс. Имя службы D-Bus: `org.kde.tellico`.

### Команды D-Bus

В интерфейсе Tellico доступны два первичных объекта D-Bus: `Tellico` и `Collections`.

#### Объект `Tellico`

Полный перечень команд D-Bus в объекте `Tellico` приведён далее:

    bool importTellico(QString file, QString action)
    bool importBibtex(QString file, QString action)
    bool importMODS(QString file, QString action)
    bool importPDF(QString file, QString action)
    bool importRIS(QString file, QString action)
    bool exportXML(QString file, bool filtered)
    bool exportZip(QString file, bool filtered)
    bool exportBibtex(QString file, bool filtered)
    bool exportHTML(QString file, bool filtered)
    bool exportCSV(QString file, bool filtered)
    QList<int> selectedEntries()
    QList<int> filteredEntries()
    void openFile(QString file)
    void setFilter(QString text)
    bool showEntry(int id)

В четырёх командах импорта первый аргумент — это файл, который следует импортировать, а второй — действие импорта. Доступны три действия: replace (заменить), append (добавить) и merge (объединить). Поддерживается импорт четырёх форматов файлов: файлы XML Tellico, файлы BibTeX, файлы MODS и файлы RIS.

Текущую открытую в Tellico коллекцию возможно экспортировать в файл в одном из следующих форматов: XML Tellico, ZIP Tellico, BibTeX, HTML или CSV (список значений через запятую). Команды экспорта принимают дополнительный аргумент, который позволяет указать, следует ли ограничить экспорт коллекции только соответствующими текущему фильтру элементами.

Перечень идентификаторов записей, которые выбраны или отфильтрованы, позволяет облегчить отображение или обновление записей в области просмотра.

Для открытия нового файла данных возможно использовать команду openFile(). Необходимо указать полный путь.

Чтобы задать новый фильтр, воспользуйтесь командой setFilter() (это эквивалентно набору текста в области фильтра в главном окне).

Если указать идентификатор записи, при выполнении команды showEntry() эта запись будет выбрана, а информация о ней — показана в главном окне.

#### Объект `Collections`

Полный перечень команд D-Bus в объекте `Collections` приведён далее:

    int addEntry()
    bool removeEntry(int entryID)
    QStringList allValues(QString fieldName)
    QStringList entryValues(int entryID, QString fieldName)
    QStringList selectedBibtexKeys()
    QString entryBibtexKey(int entryID)
    bool setEntryValue(int entryID, QString fieldName, QString value)
    bool addEntryValue(int entryID, QString fieldName, QString value)

Команда addEntry() позволяет создать в текущей коллекции новую пустую запись. Возвращаемым значением является идентификатор записи, с помощью которого затем возможно указать значения полей записи. Чтобы удалить запись из коллекции, воспользуйтесь командой removeEntry().

Если при вызове команды allValues() указано только название поля, будут возвращены все значения этого поля для текущих выбранных записей. Если выбранные записи отсутствуют, список возвращаемых значений будет пустым. Если в качестве аргумента команды указан идентификатор записи, будут возвращены значения полей указанной записи.

Если текущая коллекция является библиографией, при вызове команды selectedBibtexKeys() будут возвращены ключи цитирования BibTeX для всех выбранных записей. Чтобы получить ключ цитирования BibTeX для определённой записи, воспользуйтесь командой entryBibtexKey().

Интерфейс D-Bus позволяет выполнять непосредственное редактирование записей. Если указать идентификатор записи, при выполнении команды setEntryValue() значение поля будет указано напрямую. Чтобы добавить значение, не изменяя уже существующие, воспользуйтесь командой addEntryValue(). Новое значение будет добавлено в конец списка существующих.

### Примеры D-Bus

Далее приводится несколько примеров создания сценариев Tellico с помощью интерфейса D-Bus.

    Открытие файла BibTeX
    % qdbus org.kde.tellico /Tellico org.kde.tellico.importBibtex "/home/robby/reference.bib" "replace"
    true

    Экспорт файла BibTeX
    % qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documents/reference.bib
    true

    Экспорт файла BibTeX с использованием текущего фильтра
    % qdbus org.kde.tellico /Tellico org.kde.tellico.exportBibtex ~/documents/reference.bib true
    true

    Эхо-вывод ключа цитирования текущего выделения
    % qdbus org.kde.tellico /Collections org.kde.tellico.selectedBibtexKeys
    stephenson2004

    Добавление новой записи и указание названия
    % myid=`qdbus org.kde.tellico /Collections org.kde.tellico.addEntry`
    % qdbus org.kde.tellico /Collections org.kde.tellico.setEntryValue $myid title "Моя новая книга"
    true

Глава 6. Конфигурация
Конфигурация

# Глава 6. Конфигурация

Диалог конфигурации содержит все параметры, которые позволяют изменить используемое по умолчанию поведение Tellico.

Чтобы применить изменения сразу же, не закрывая диалоговое окно, нажмите кнопку Применить. При нажатии кнопки OK изменения будут применены, а диалоговое окно — закрыто. При нажатии кнопки Отмена диалоговое окно будет закрыто, но уже внесённые и применённые изменения будут сохранены. Кнопка По умолчанию возвращает параметры на текущей странице диалогового окна в значения по умолчанию. Кнопка Справка позволяет открыть в «Центре справки KDE» соответствующий раздел руководства пользователя Tellico.

Некоторые дополнительные параметры возможно изменить только с помощью редактирования самого файла конфигурации. Дополнительные сведения доступны в разделе Скрытые параметры.

## Общие параметры

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

Группа параметров Форматирование позволяет управлять автоматическим форматированием, которое выполняется Tellico. Примеры доступны в разделе «Форматирование полей». Изменение регистра и форматирование — это отдельные параметры, так как регистр текста в поле возможно сменить без изменения порядка слов, и наоборот. Параметр автоматического использования заглавных букв возможно на игнорирование определённых слов. Автоматическое форматирование включает грамматические артикли в названиях, а также префиксы и суффиксы личных имён. Значения нечувствительны к регистру и должны разделяться точкой с запятой.

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

Личное имя John Q. von Public, III будет преобразовано в von Public, III, John Q., при этом Public будет использоваться в качестве ключа сортировки.

Поддерживаются только те префиксы, которые состоят из одного слова. Например, если имя включает van der, то в список префиксов фамилии необходимо включить как van, так и der. Артикли, которые заканчиваются апострофом, также поддерживаются при сортировке.

### Примечание

Фактические значения, которые содержатся в коллекции, не изменяются, меняется только видимый в интерфейсе текст. Изменение параметров форматирования не влияет на данные коллекции.

Параметры печати
Параметры печати

## Параметры печати

Программа Tellico использует шаблон XSLT для создания HTML-кода, который затем передаётся службе печати KDE. Выполняется печать только тех полей, которые видны в Таблице записей. Более того, если к коллекции применён фильтр, будут напечатаны только видимые записи. В этом случае будет показано соответствующее предупреждение (если показ таких предупреждений не был ранее отменён пользователем).

На странице Параметры печати возможно изменять некоторые параметры форматирования при печати коллекции. Если выбран параметр Форматировать имена и названия, при печати поля будут форматироваться автоматически. Если этот параметр не выбран, печать полей будет выполняться в точном соответствии с введённым в них текстом.

При использовании таблицы стилей по умолчанию значения полей коллекции будут напечатаны в столбцах. Параметр Включить заголовки полей позволяет выбрать, следует ли печатать заголовки в верхней части столбцов.

Порядок записей в распечатке будет тем же, что и в Таблице записей. Кроме того, записи могут быть сгруппированы таким же образом, как и в области Группы.

Последняя группа параметров управляет размером изображений, которые включаются в распечатку. Возможно изменить размер изображений, сохраняя соотношение сторон. Максимальная ширина и высота изображения определяют наибольший возможный размер изображения (но оно не будет увеличено).

Параметры шаблонов
Параметры шаблонов

## Параметры шаблонов

В области Информация о записях для показа значений полей используются шаблоны. Для каждого типа коллекции возможно указать свой шаблон. Некоторые шаблоны, например Альбом или Видео, предназначены для определённых типов коллекций, и при попытке использовать их для других типов коллекций в Таблице записей будет показано краткое сообщение об ошибке. При нажатии кнопки Предпросмотр появится всплывающее окно, которое позволяет оценить внешний вид шаблона. Для шаблона возможно использовать пользовательские шрифты и цвета (выбранные параметры будет применены ко всем шаблонам по умолчанию, но, возможно, не будут использоваться в пользовательском шаблоне).

Дополнительные шаблоны возможно установить как напрямую, так и загрузить с сайта store.kde.org, нажав кнопку Загрузить. Также возможно удалить любые шаблоны, которые установлены пользователем. Шаблоны записей хранятся в папке `$`KDEHOME`/share/apps/tellico/entry-templates/`.

Пожалуйста, поделитесь новым созданным шаблоном с сообществом, отправив его на сайт store.kde.org!

Параметры источников данных
Параметры источников данных

## Параметры источников данных

Tellico поддерживает различные источники импорта данных. На странице «Источники данных» возможно выполнить настройку этих источников. Доступно множество типов источников и самих источников. Некоторые из них приводятся далее, а полный перечень доступен на веб-сайте Tellico.

- Веб-службы Amazon.com,
- ISBNdb.com,
- OpenLibrary.org,
- Интернет-каталог фильмов IMDb,
- AlloCiné,
- TheMovieDB.org,
- Открытый каталог фильмов OMDb,
- BDGest,
- Comic Vine,
- Discogs.com,
- MusicBrainz.org,
- TheGamesDB.net,
- GiantBomb.com,
- MobyGames.com,
- IGDB.com,
- VideoGameGeek,
- BoardGameGeek,
- arxiv.org,
- Базы данных Entrez (PubMed),
- Серверы z39.50,
- серверы SRU,
- Colnect,
- Numista,
- прочие внешние сценарии или приложения, а также
- комбинации приведённых выше источников.

Кнопка Создать... позволяет добавлять новые источники. Существующие источники возможно изменять или удалять с помощью кнопок Изменить... или Удалить. Порядок, в котором источники показаны в меню обновления записей, также возможно изменить.

### Предупреждение

Устанавливайте и запускайте сценарии только из надёжных источников. Разрешения, с которыми выполняются сценарии, совпадают с разрешениями пользователя, поэтому запуск сценариев может привести к изменению или удалению файлов или вызвать сбои в работе системы.

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

### Источники данных о книгах и библиографиях

#### Серверы z39.50

Протокол z39.50 используется для доступа к библиотекам и источникам библиографической информации по всему миру. Перечни общедоступных серверов z39.50 доступны, в частности, на сайте indexdata.dk. Tellico уже содержит несколько готовых конфигураций для работы с крупными библиотеками. Также возможно указать параметры подключения вручную.

Tellico поддерживает чтение данных в форматах MODS, USMARC/MARC21 и UNIMARC. Для этого используется библиотека «yaz». Кроме того, в программе имеется ограниченная поддержка формата GRS-1.

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

По умолчанию для доступа к z39.50 используется порт 210, но для некоторых серверов может потребоваться другой порт. В программе Tellico предполагается, что сервер используется кодировку MARC-8, если не указано иное. В случае использования некорректной кодировки может быть показано сообщение об ошибке в выводе программы или могут быть не получены записи.

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

#### Серверы SRU

Аббревиатура «SRU» означает Search/Retrieve via URL (поиск и получение с помощью URL-адреса) — это стандартный протокол интернет-поиска. Некоторые библиотеки используют его для предоставления доступа к своим каталогам данных. Наиболее известная такая библиотека — Библиотека Конгресса (США).

#### Базы данных Entrez

Entrez — это интегрированная система текстового поиска и получения информации, которая используется в Национальном центре биотехнологической информации (NCBI). Самой известной базой данных Entrez является PubMed, база данных статей медико-биологической тематики из различных журналов по биологии. В настоящее время Tellico поддерживает только одну базу данных Entrez — PubMed.

#### Библиографические базы данных

arXiv.org, Bibsonomy и CrossRef — это сетевые базы данных для научных статей и библиографической информации. Чтобы получить доступ к источнику CrossRef, необходимо запросить учётную запись и добавить данные своей учётной записи в конфигурацию этого источника данных.

#### ISBNdb.com

ISBNdb.com — это сетевая база данных о книгах из библиотек по всему миру.

#### OpenLibrary.org

OpenLibrary.org — это сетевая база данных о книгах, в которой каждой книге посвящена одна веб-страница.

### Источники данных о комиксах

#### Bedetheque

Bedetheque — это французская база данных о комиксах, которая находится под управлением BDGest.

#### Comic Vine

Comic Vine — самый крупный посвящённый комиксам вики-сайт.

### Источники данных о фильмах

#### Интернет-каталог фильмов IMDb

Интернет-каталог фильмов IMDb предоставляет сведения о фильмах и видео. Если при проведении поиска по полю Человек будет получено несколько результатов, появится диалоговое окно для выбора нужного человека. Параметры конфигурации позволяют выбрать страну на IMDb и то, следует ли загружать изображения. Так как при запросе к IMDb может быть получено большое количество актёров, их число возможно ограничить заданным значением.

#### TheMovieDB.org

TheMovieDB.org — бесплатная и открытая сетевая база данных о фильмах. Для получения бесплатной учётной записи необходимо зарегистрироваться.

#### Открытый каталог фильмов OMDb

Открытая база данных о фильмах (OMDBAPI.com) — бесплатная веб-служба для получения сведений о фильмах.

#### AlloCiné

AlloCiné — французский сетевой сервис, который позволяет получать информацию о фильмах. В разделе параметров системы KDE необходимо включить идентификацию браузера.

### Источники данных о музыке

#### Discogs.com

Discogs.com — созданная пользователями база данных о музыке, в которой содержатся сведения об исполнителях, компаниях звукозаписи и записях. Для получения бесплатной учётной записи необходимо зарегистрироваться. В разделе параметров системы KDE необходимо включить идентификацию браузера.

#### MusicBrainz.org

MusicBrainz.org — открытая база метаданных музыки. Цель этого ресурса — предоставить сайт с максимально полной информацией о музыке. В разделе параметров системы KDE необходимо включить идентификацию браузера.

### Источники данных о видеоиграх

#### GiantBomb.com

GiantBomb.com — крупная открытая база данных с информацией о видеоиграх. Для получения бесплатной учётной записи необходимо зарегистрироваться.

#### TheGamesDB.net

TheGamesDB.net — открытая сетевая база данных для поклонников видеоигр.

#### MobyGames

MobyGames.com — в описании на самом сайте говорится, что он является самой старой, крупной и точной базой данной о видеоиграх.

#### IGDB.com

IGDB.com — ресурс позиционируется как игровой веб-сайт для всех, кто любит игры.

#### VideoGameGeek

VideoGameGeek — сетевой ресурс и сообщество, посвящённые видеоиграм.

### Источники данных о настольных играх

#### BoardGameGeek

BoardGameGeek — сетевой ресурс и сообщество, посвящённые настольным играм.

### Источники данных о монетах и марках

#### Colnect

Colnect — сетевое сообщество для коллекционеров, которое позволяет управлять личной коллекцией. Tellico поддерживает поиск информации о монетах и марках на этом сайте.

#### Numista

Numista — мировой каталог монет, пополняемый участниками сообщества. Он позволяет управлять коллекцией по сети, выполнять обмен с другими коллекционерами, а также общаться на форуме.

### Источники данных для коллекций различных типов

#### Amazon.com

Веб-службы Amazon позволяют Tellico выполнять поиск информации на любом из 14 международных сайтов, которыми управляет Amazon.com: США, Соединённое Королевство, Германия, Япония, Франция, Канада, Китай, Испания, Италия, Бразилия, Австралия, Индия, Мексика и Турция.

При настройке каждого источника Amazon.com необходимо указать три параметра: расположение сервера, размер изображения и идентификатор партнёра. Некоторые данные с Amazon.com могут включать изображения, например обложки книг или фильмов. Такие изображения возможно загрузить в одном из трёх размеров (в зависимости от конкретного элемента). Для доступа к веб-службам Amazon.com необходимо использовать идентификатор партнёра. Он включается в обратные ссылки на элемент, как этого требует лицензионное соглашение по использованию веб-служб Amazon.com.

При доступе к API рекламы продуктов Amazon могут иметься ограничения, связанные с реферальными ссылками или рекламой. Для получения более подробных сведений ознакомьтесь с документацией Amazon при регистрации для получения доступа к API.

#### Внешние сценарии или приложения

В качестве интерфейса для поиска в других источниках информации возможно использовать внешние сценарии или приложения (это более простой способ интеграции Tellico со сторонними подключаемыми модулями). Tellico выполнит команду и передаст поисковый запрос как параметры командной строки.

Программа Tellico поставляется с несколькими сценариями. Например, для поиска на ресурсе издателя комиксов Dark Horse Comics следует использовать сценарий Python.

Также необходимо указать тип коллекции, возвращаемый сценарием, а также формат данных. Tellico поддерживает не только импорт данных из сценариев, в которых используется формат XML Tellico по умолчанию, но и импорт данных в других форматах (например, в BibTeХ).

В параметрах источника следует указать полный путь к приложению. Обратите внимание, что приложение выполняется в системе с разрешениями, которые совпадают с разрешениями текущего пользователя, поэтому следует использовать только сценарии из доверенных источников. Установите флажки, которые находятся рядом с поддерживаемыми приложением ключами поиска, и введите необходимые параметры командной строки в поле ввода. `%1` будет заменено поисковым запросом.

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

### Сочетание нескольких источников данных

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

Сочетать возможно только существующие источники данных. В этом источнике можно использовать только тип поиска для первого источника, так как результаты поступают из первого источника данных. Например, сначала выполняется поиск в UPCitemDb, и каждый результат затем обновляется из TheMovieDB.

Глава 7. Улучшение Tellico
Улучшение Tellico

# Глава 7. Улучшение Tellico

Как и в случае других свободных программ, Tellico полностью открыта для улучшения. Написание сценариев для импорта, экспорта или изменения данных не представляет особой сложности. В этой главе рассказывается о том, как это сделать.

## Формат файла

По умолчанию файл данных Tellico представляет собой zip-архив, обычно с расширением `.tc`. Внутри архива находится файл верхнего уровня `tellico.xml`. Изображения могут либо содержаться в папке `images/` архива, либо включаться в данные XML напрямую в кодировке Base64. Изображения также могут храниться внутри папки данных приложения: в этом случае они отсутствуют в файле данных. Tellico также позволяет загрузить отдельно сам файл XML в несжатом виде.

### Данные XML

#### Коллекция

    <?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="My Books" type="2">
     </collection>
    </tellico>

Файл начинается с обязательного объявления XML и кодировки, за которыми следует описание типа документа (doctype). DТD-версия типа документа увеличивается при добавлении нового типа поля или указании дополнительных свойств для полей по умолчанию. Tellico позволяет открыть и прочитать любые предыдущие DTD-версии, но сохранение файлов выполняется в текущей версии. Расположение DTD указывает на сам файл DTD.

Элемент верхнего уровня — <tellico>. Он содержит объявление пространства имён и версию синтаксиса файла по умолчанию (они всегда должны соответствовать DTD).

Элемент <tellico> содержит один элемент <collection>. Указание нескольких коллекций будет проигнорировано. Атрибут title содержит название коллекции, а type определяет содержащиеся в коллекции типы записей. Допустимые типы перечислены в следующем разделе. Необязательный атрибут entryTitle позволяет указать название записей для пользовательской коллекции и является множественным.

#### Поля

      <fields>
       <field flags="8" title="Title" category="General" format="1" type="1" name="title" />
       <field flags="7" title="Author" category="General" format="2" type="1" name="author" />
       <field flags="2" title="Binding" category="General" allowed="Hardback;Paperback;Trade Paperback;E-Book;Magazine;Journal" format="4" type="3" name="binding" >
        <prop name="default"
    >Мягкий переплёт</prop>
       </field>
       <field flags="6" title="Publisher" category="Publishing" format="0" type="1" name="publisher" />
       <field flags="4" title="Edition" category="Publishing" format="0" type="1" name="edition" />
       <field flags="3" title="Copyright Year" category="Publishing" format="4" type="6" name="cr_year" />
       <field flags="2" title="Publication Year" category="Publishing" format="4" type="6" name="pub_year" />
       <field flags="0" title="ISBN#" category="Publishing" format="4" type="1" name="isbn" description="International Standard Book Number" />
       <field flags="7" title="Genre" category="Classification" format="0" type="1" name="genre" />
       <field flags="7" title="Keywords" category="Classification" format="0" type="1" name="keyword" />
       <field flags="0" title="Front Cover" category="Front Cover" format="4" type="10" name="cover" />
       <field flags="0" title="Comments" category="Personal" format="4" type="1" name="comments" />
       <field title="Rating" flags="2" category="Personal" format="4" type="14" name="rating">
        <prop name="maximum"
    >5</prop>
        <prop name="minimum"
    >1</prop>
       </field>
       <field title="ID" flags="32" category="Personal" format="4" type="6" name="id">
        <prop name="template"
    >%{@id}</prop>
       </field>

      </fields>

Все поля определяются внутри элемента <fields> (допустимо указывать только один такой элемент). Все сведения о поле, за исключением свойств, указываются в виде атрибутов элемента <field>. Допустимые значения атрибутов flags, format и type указаны в следующем разделе.

Свойства поля позволяют указать значения поля по умолчанию, диапазоны значений рейтингов, шаблоны зависимых значений и так далее. Выше приведены примеры указания значения по умолчанию, максимального значения рейтинга и шаблона для поля с зависимым идентификатором.

#### Записи

      <entry>
       <title
    >C++ Programming Language, The</title>
       <authors>
        <author
    >Stroustrup, Bjarne</author>
       </authors>
       <publisher
    >Addison-Wesley Pub Co</publisher>
       <edition
    >3rd</edition>
       <pub_year
    >1997</pub_year>
       <isbn
    >0-201-88954-4</isbn>
       <genres>
        <genre
    >Non-Fiction</genre>
       </genres>
       <keywords>
        <keyword
    >Programming</keyword>
        <keyword
    >Computers</keyword>
       </keywords>
       <cover
    >cf65a2f023b6cb9e9233323dca10ac7c.jpeg</cover>
      </entry>

Элемент, название которого совпадает с названием поля, возможно указать в <entry>. Если поле позволяет указывать несколько значений, для создания элемента к названию поля добавляется буква s, и каждое значение добавляется как потомок этого элемента (как в приведённом выше примере с полями автора, жанра и ключевого слова).

Когда в коллекцию будут добавлены дополнительные поля, файл данных перестанет соответствовать DTD. Но в Tellico используется обработчик XML, который не выполняет проверку, поэтому проблем в работе приложения не возникнет.

#### Изображения

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

Внутри элемента <images> перечислены все изображения, на которые ссылается запись, а также указаны атрибуты, которые описывают размер, формат и идентификатор изображения. Если изображение содержится в файле ZIP, элемент будет пустым. Если элемент не пуст, данные изображения могут содержаться в XML-потоке в виде текста в кодировке Base64.

Значения типов коллекций
Значения типов коллекций

## Значения типов коллекций

Тип коллекции указывается в атрибуте типа элемента коллекции. Значение совпадает со значением перечисления Type в файле `src/collection.h`.

Таблица 7.1. Значения типов коллекций

Тип коллекции | Значение
--- | ---
Пользовательская коллекция | 1
Коллекция книг | 2
Коллекция фильмов | 3
Коллекция музыки | 4
Библиография | 5
Коллекция комиксов | 6
Коллекция вин | 7
Коллекция монет | 8
Коллекция марок | 9
Коллекция карточек | 10
Коллекция видеоигр | 11
Каталог файлов | 12
Коллекция настольных игр | 13

Значения типов полей
Значения типов полей

## Значения типов полей

Tellico включит в коллекцию все поля по умолчанию, если первый элемент поля называется _default. Для полей типа Большой текст, Таблица и Изображение категория поля должна совпадать с названием поля.

Тип поля указывается в атрибуте типа элемента поля. Значение совпадает со значением перечисления FieldType в файле `src/field.h`.

Таблица 7.2. Значения типов полей

Тип поля | Значение
--- | ---
Простой текст | 1
Большой текст | 2
Выбор | 3
Выбор да/нет | 4
Номер | 6
URL-адрес | 7
Таблица | 8
Изображение | 10
Дата | 12
Рейтинг | 14

Для поля возможно установить различные флаги, указав их как побитовое ИЛИ в атрибуте флага элемента поля. Флаг, запрещающий пользователю удалять поле, следует использовать, например, для ключей цитирования библиографических записей.

Таблица 7.3. Значения флагов полей

Флаги полей | Значение
--- | ---
Разрешить несколько значений | `0x01`
Разрешить группировку | `0x02`
Разрешить дополнение | `0x04`
Запретить удаление | `0x08`
Запретить редактирование | `0x10`
Зависимое значение | `0x20`

Формат поля указывается в атрибуте формата элемента поля. Форматирование дат в настоящее время не используется. При группировке по Людям используются все поля с Форматированием имён. Установка флага Зависимое значение означает, что значение этого поля создаётся из значений других полей с помощью шаблона.

Таблица 7.4. Значения формата поля

Формат поля | Значение
--- | ---
Только повышение регистра | 0
Форматирование названия | 1
Форматирование имени | 2
Форматирование даты | 3
Без форматирования | 4

Скрытые параметры настройки
Скрытые параметры настройки

## Скрытые параметры настройки

В Tellico имеется несколько дополнительных параметров настройки, которые не отображаются в диалоге конфигурации. Они не настолько важны, чтобы их стоило включать в этот диалог, но, тем не менее, могут быть прочитаны приложением из файла конфигурации (так как эти параметры могут быть полезны некоторым пользователям).

Параметры Tellico сохраняются в файле, который находится в домашней папке пользователя, а именно: `$`KDEHOME`/share/config/tellicorc`. В этом файле параметры распределены по группам. Названия групп заключены в квадратные скобки, например: [General Options]. Чтобы добавить параметр в группу General Options, найдите в файле параметров строку с названием этой группы. Если такой строки нет, создайте её, добавив строку с текстом [General Options]. После этого под названием группы будет возможно добавить параметр.

### [General Options]

Эти параметры следует поместить в группу General Options.

#### Максимальный размер значка

Этот параметр позволяет изменить максимальный размер значков, которые отображаются в режиме представления значков. Значение по умолчанию: 96. Размер должен находиться в диапазоне от 32 до 512.

#### Пример

`Max Icon Size=128`

#### Размер кэша значков

Этот параметр позволяет изменить максимальное количество значков для кэширования в памяти. Значение по умолчанию: 1000.

#### Пример

`Icon Cache Size=100`

#### Пример

`Max Icon Size=128`

#### Размер кэша изображений

Этот параметр позволяет изменить максимальное количество памяти (в байтах), которое используется для кэширования всех изображений. Значение по умолчанию: 67108864.

#### Пример

`Image Cache Size=256000000`

### [Options - bibtex]

Эти параметры следует поместить в группу Options - bibtex.

#### lyxpipe

Этот параметр позволяет указать расположение lyxpipe для отправки библиографических цитат. Оно не должно содержать суффикс `.in`.

#### Пример

`lyxpipe=$HOME/.lyx/lyxpipe`

Преобразование символов BibTeX
Преобразование символов BibTeX

## Преобразование символов BibTeX

При импорте или экспорте файлов BibTeX выполняется преобразование определённых символов из формата TeX в Юникод и обратно. Эти соответствия символов содержатся в файле `bibtex-translation.xml`, который расположен в каталоге установочных данных. Соответствия возможно изменить любым необходимым образом. Элемент ключа содержит символ Юникода, а находящиеся внутри элементы строк содержат эквиваленты TeX (соответствие может быть типа «один-ко-многим»). Первый из них используется при экспорте в BibTeX.

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

Советы по работе с XSLT
Советы по работе с XSLT

## Советы по работе с XSLT

Далее приводятся советы по написанию XSLT для обработки данных XML Tellico: (появятся позднее).

Глава 8. Вопросы и ответы
Вопросы и ответы

# Глава 8. Вопросы и ответы

8.1. Как ввести несколько авторов?
8.2. Возможно ли изменить вид распечатанной страницы?
8.3. Как сгруппировать записи по свойству, которого нет в списке на панели инструментов?
8.4. Почему при запуске Tellico появляется непонятный текст?
8.5. Как изменить то, какие столбцы отображаются в программе?
8.6. Как выполнить фильтрацию по чему-либо вроде поля «Прочитано»?
8.7. Как добавлять новые шаблоны записей?
8.8. Компиляция и установка выполнены без ошибок, но при запуске Tellico в окне программы ничего нет. В чём причина?
8.9. Как выполнить экспорт дополнительных полей BibTex?
8.10. Что случилось с программой Bookcase?
8.11. Что означает название Tellico?
8.12. Зачем в результатах поиска ссылки на Amazon.com?
8.13. Почему не используется настоящая база данных?

8.1. | Как ввести несколько авторов?

Имена авторов необходимо разделить с помощью точки с запятой, вот так: `А. С. Пушкин; Н. В. Гоголь`. Не включайте слово «и», даже если авторов двадцать. Если параметр автоматического форматирования включён, фамилия каждого автора автоматически будет показана первой.

Для других свойств записи, которые позволяют использовать несколько значений (например, «genre» (жанр) и «keywords» (ключевые слова)), ввод выполняется таким же образом, с разделением значений точкой с запятой (;).

8.2. | Возможно ли изменить вид распечатанной страницы?

Да, это возможно. Найдите файл `tellico-printing.xsl` в каталоге $`KDEDIR`/share/apps/tellico/. Для внесения своих изменений этот файл следует скопировать в каталог $`KDEHOME`/share/apps/tellico/. Необходимо знание языка XSLT, но другого способа изменить шаблон печати нет — потребуется отредактировать этот файл. Из него генерируется HTML-код, а самый простой способ изменить вид распечатки — изменить расположенный в начале этого кода CSS-код.

Обратите внимание, что файл `tellico-printing.xsl` ссылается на другой файл, `tellico-common.xsl`, который содержит несколько распространённых шаблонов XSLT. При копировании `tellico-printing.xsl` в $`KDEHOME` необходимо либо изменить элемент <xsl:import> таким образом, чтобы он указывал на фактическое расположение файла `tellico-common.xsl`, либо также скопировать и файл с шаблонами.

8.3. | Как сгруппировать записи по свойству, которого нет в списке на панели инструментов?
| Чтобы включить группировку по полю, для которого она не разрешена по умолчанию, откройте диалоговое окно «Поля коллекции» и установите для этого поля флажок «Разрешить группировку».
8.4. | Почему при запуске Tellico появляется непонятный текст?

Такой текст, как

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

, является отладочной информацией. Чтобы он не появлялся на экране, при компиляции программы необходимо указать флаг ``--disable-debug``. Также возможно использовать ещё один флаг, ``--enable-final``, — в этом случае при компиляции потребуется немного больше памяти, но работа приложения будет оптимизирована.

Последнее сообщение немного отличается, оно означает, что версия Qt™ была скомпилирована с некоторой отладочной информацией.

Или, если программа Tellico уже установлена, выполните команду `kdebugdialog` и убедитесь, что параметр «0 (generic)» не включён. Это позволяет отключить отладочные сообщения во всех универсальных приложениях KDE, то есть тех, которые не распространяются KDE официально.

8.5. | Как изменить то, какие столбцы отображаются в программе?
| Щёлкните по строке заголовка правой кнопкой мыши. Заголовки также возможно перетаскивать, чтобы менять столбцы местами. При щелчке по заголовку левой кнопкой мыши будет выполнена сортировка по соответствующему полю.
8.6. | Как выполнить фильтрацию по чему-либо вроде поля «Прочитано»?

Поля логического выбора Tellico сохраняются внутри программы как «true». Если требуется посмотреть, какие научно-фантастические книги ещё не были прочитаны, выберите параметр «Соответствует всем условиям», добавьте первое правило «Жанр» «содержит» «Научная фантастика» (без кавычек) и второе правило «Прочитано» «не содержит» «true» (без кавычек).

Кроме того, если в быстром фильтре один из символов — не обычная буква, текст будет обрабатываться как регулярное выражение. Например, чтобы посмотреть только книги, которые написали Пушкин и Гоголь, следует ввести в поле быстрого фильтра «Пушкин|Гоголь» (без кавычек).

8.7. | Как добавлять новые шаблоны записей?

Шаблоны записей следует сохранять в каталоге `$`KDEHOME`/share/apps/tellico/entry-templates/` (для обеспечения доступа одного пользователя) или `$`KDEDIR`/share/apps/tellico/entry-templates/` (для обеспечения доступа всех пользователей). Шаблоны, сохранённые в $`KDEHOME`, переопределят все файлы с такими же именами, расположенные в $`KDEDIRS`. Шаблоны записей возможно указать для каждой отдельной коллекции в диалоге настройки параметров.

Шаблоны для диалогов отчётов хранятся в каталоге `$`KDEHOME`/share/apps/tellico/report-templates/`.

8.8. | Компиляция и установка выполнены без ошибок, но при запуске Tellico в окне программы ничего нет. В чём причина?

Программы KDE выполняют поиск данных в тех расположениях, которые заданы переменной среды $`KDEDIRS`. Если установка выполнена, например, в каталоге `/usr/local`, но переменная среды $`KDEDIRS` является пустой или содержит только `/usr`, то в этом случае Tellico не удастся найти необходимые файлы. Если используется дистрибутив SuSE®, сборку необходимо выполнять с параметром ``--prefix`=`/opt/kde3``. Другой вариант: добавить строку в файл `.profile` для установки переменной среды $`KDEDIRS`. Обратитесь к документации используемой оболочки.

8.9. | Как выполнить экспорт дополнительных полей BibTex?

В Tellico для экспорта полей BibTeX используется свойство bibtex (оно позволяет указать такие поля). Если требуется добавить дополнительные поля, которые следует экспортировать, например, поле аннотации, откройте диалог «Поля коллекции» и нажмите кнопку Свойства.... Добавьте свойство bibtex со значением abstract. При последующем экспорте в формат BibTeX or Bibtexml это свойство будет использоваться для поля названия BibTeX.

8.10. | Что случилось с программой Bookcase?
| Из-за конфликта товарных знаков программа Bookcase была переименована в Tellico в сентябре 2004 года. Затем была выпущена программа Tellico 0.12, полный аналог Bookcase 0.11 (изменилось только название).
8.11. | Что означает название Tellico?
| Существовало несколько других вариантов названия программы, некоторые из них были связаны с коллекциями книг. Но Tellico поддерживает работу не только с книгами, кроме того, программа создавалась как хобби-проект, поэтому было выбрано красивое (на взгляд разработчика) слово — название небольшого города, рядом с которым он вырос.
8.12. | Зачем в результатах поиска ссылки на Amazon.com?
| Согласно условиям соглашения о предоставлении доступа к веб-службам Amazon.com, для всех полученных с помощью службы изображений необходимо создавать обратные ссылки на Amazon.com, а также дополнительную ссылку. Необходимо включать идентификатор партнёра Amazon.com для надлежащего получения реферальных платежей.
8.13. | Почему не используется настоящая база данных?

Одной из задач, стоящих перед разработчиком Tellico, было изучение языка программирования C++. На тот момент он не владел языком SQL и имел только приблизительное представление о его использовании. Проще говоря, программа Tellico изначально не разрабатывалась как реляционная база данных и не станет ей, пока у разработчика не появится время и желание изменить модель данных после изучения SQL.

Конечно же, в программу возможно внести любые необходимые изменения, изменив её исходный код.

Глава 9. Список команд
Список команд

# Глава 9. Список команд

## Главное окно Tellico

Далее приводится описание каждого элемента меню. Рядом с элементом указана комбинация клавиш по умолчанию, которая выполняет ту же функцию, что и этот элемент (при наличии).

### Меню «Файл»

Файл → Новая

  Эта команда позволяет создать новую коллекцию. Tellico поддерживает 12 типов коллекций по умолчанию, а также пустой шаблон пользовательской коллекции.

Файл → Открыть... (Ctrl+O)

  Эта команда позволяет открыть файл Tellico.

Файл → Последние файлы

  Эта команда позволяет открыть файл из подменю, которое содержит перечень последних открытых файлов.

Файл → Сохранить (Ctrl+S)

  Эта команда позволяет сохранить коллекцию. Если сохраняется Безымянный файл, то команда Сохранить эквивалентна команде Сохранить как.... Она доступна только в том случае, если коллекция была изменена.

Файл → Сохранить как... (Ctrl+Shift+S)

  Эта команда позволяет сохранить коллекцию в новый файл.

Файл → Печать... (Ctrl+P)

  Эта команда позволяет распечатать коллекцию. Параметры печати возможно указать в диалоге конфигурации.

Файл → Импорт

  Эта команда позволяет импортировать данные из другого файла. Tellico поддерживает импорт данных из файлов нескольких других форматов.

Файл → Экспорт

  Эта команда позволяет экспортировать коллекцию в другой формат. Tellico поддерживает экспорт данных в файлы нескольких других форматов.

Файл → Выход (Ctrl+Q)

  Эта команда позволяет закрыть окно Tellico. Если имеются несохранённые изменения коллекции, перед продолжением их будет предложено сохранить.

### Меню «Правка»

Правка → Отменить действие (Ctrl+Z)

  Эта команда позволяет отменить предыдущее действие. Применение этой команды поддерживается не для всех действий.

Правка → Повторить (Ctrl+Shift+Z)

  Эта команда позволяет повторно выполнить отменённое ранее действие.

Правка → Вырезать (Ctrl+X)

  Эта команда позволяет удалить выбранный текст и поместить его копию в буфер обмена.

Правка → Копировать (Ctrl+C)

  Эта команда позволяет скопировать выбранный текст в буфер обмена.

Правка → Вставить (Ctrl+V)

  Эта команда позволяет вставить текст из буфера обмена (если он там имеется) в позиции курсора в редакторе.

Правка → Выделить все (Ctrl+A)

  Эта команда позволяет выделить все записи коллекции в области таблицы записей.

Правка → Снять выделение (Ctrl+Shift+A)

  Эта команда позволяет отменить выделение всех записей коллекции.

Правка → Поиск в Интернете... (Ctrl+I)

  Эта команда позволяет открыть диалог «Поиск в Интернете» для поиска и импорта записей с различных интернет-сайтов, в том числе Amazon.com.

Правка → Расширенный фильтр... (Ctrl+J)

  Эта команда позволяет открыть диалог «Расширенный фильтр».

### Меню «Коллекция»

Коллекция → Новая запись... (Ctrl+N)

  Эта команда позволяет открыть редактор записей для изменения новой записи.

Коллекция → Изменить запись... (Ctrl+E)

  Эта команда позволяет открыть редактор записей для изменения выбранных записей.

Коллекция → Дублировать запись (Ctrl+Y)

  Эта команда позволяет создавать новые записи коллекции с помощью копирования (дублирования) выбранных записей.

Коллекция → Удалить запись (Ctrl+D)

  Эта команда позволяет удалить выбранные записи.

Коллекция → Объединить записи

  Эта команда позволяет объединить выбранные записи.

Коллекция → Обновить запись

  Это меню содержит перечень всех доступных источников данных. Его возможно использовать для автоматического запроса к источнику и обновления выбранных записей.

Коллекция → Отдать в долг...

  Эта команда позволяет открыть диалог выдачи на руки предметов из выбранных записей.

Коллекция → Отметить возврат

  Эта команда позволяет отметить возврат для выбранных записей с теми предметами коллекционирования, которые в настоящее время выданы на руки.

Коллекция → Переименовать коллекцию (Ctrl+R)

  Эта команда позволяет открыть диалог переименования коллекции.

Коллекция → Поля коллекции... (Ctrl+U)

  Эта команда позволяет открыть диалог «Поля коллекции».

Коллекция → Построение отчётов...

  Эта команда позволяет открыть диалог построения отчётов, с помощью которого возможно создавать отчёты о коллекции.

Коллекция → Библиография → Преобразовать в библиографию

  Эта команда позволяет преобразовать коллекцию книг в библиографию. Она добавляет определённые поля, которые необходимы для экспорта в BibTeX. Эта команда доступна только тогда, когда открыта коллекция книг.

Коллекция → Библиография → Строковые макросы...

  Эта команда позволяет открыть диалог редактирования строковых макросов BibTeX коллекции. Она доступна только при редактировании библиографии.

Коллекция → Библиография → Найти повторяющиеся ключи

  Эта команда позволяет проверить наличие повторяющихся ключей BibTeX и применить к коллекции фильтр для отображения записей с повторяющимися ключами.

Коллекция → Библиография → Копировать данные BibTeX

  Эта команда позволяет скопировать цитату BibTeX в буфер обмена для последующей вставки в документ LaTeX.

Коллекция → Библиография → Упомянуть запись в LyX

  Эта команда позволяет отправить цитату для выбранных записей в lyxpipe для использования в LyX, Kile или других приложениях LaTeX. Она доступна только при редактировании библиографии.

### Меню «Настройка» и «Справка»

Стандартные меню программ KDE Настройка и Справка (их описание содержится доступно в разделе Меню «Основ KDE») содержат следующие специфичные для Tellico пункты:

Настройка → Показать представления → Группы

  Эта команда позволяет включать и отключать отображение групп.

Настройка → Показать представления → Редактор записей

  Эта команда позволяет включать и отключать отображение редактора записей.

Настройка → Группировать

  Эта команда позволяет изменить поле, которое используется для группировки записей коллекции.

Глава 10. Авторские права и лицензия
Авторские права и лицензия

# Глава 10. Авторские права и лицензия

Tellico

Авторские права на программу: Robby Stephenson `(robby AT periapsis.org)`, 2001—2019

Авторские права на документацию: Robby Stephenson `(robby AT periapsis.org)`, 2001—2019

Олеся Герасименко`(translation-team AT basealt.ru)`

Программа распространяется на условиях лицензии GNU General Public License.

Этот документ распространяется на условиях GNU Free Documentation License.

Автор этой документации также предоставляет разрешение на её использование согласно условиям лицензии FreeBSD Documentation License (лицензия на документацию FreeBSD). Если требуется разрешить использование вашей версии этой документации только согласно условиям лицензии FreeBSD Documentation License и запретить другим пользователям использовать вашу версию этого файла согласно условиям лицензии GFDL, обозначьте это решение: удалите сведения о лицензии GFDL, заменив их на сведения о лицензии FreeBSD Documentation License и другие необходимые согласно этой лицензии сведения. Если приведённые выше сведения о лицензии GFDL не будут удалены, получатель сможет использовать вашу версию этого файла согласно условиям либо лицензии GFDL, либо лицензии FreeBSD Documentation License.