# Описание &appname;

## Типы полей

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

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

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

### Номер

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

### &URL;-адрес

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

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

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

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

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

### Выбор

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

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

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

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

### Дата

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

### Таблица

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

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

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

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

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

### Рейтинг

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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