Элемент fb3d:fb3-description
Материал из FictionBook
Версия от 08:40, 26 февраля 2010; Mike Sinkovsky (обсуждение | вклад)
Содержание
Элемент <fb3-description>
Описание
Корневой элемент для мета-данных в fb3.
id и version несут однозначно идентифицируют данный файл в ряду других (потенциально одноименнызх и даже эквивалентных)
Атрибуты
- id - 1 (один, обязателен) - UUID - ID, позволяющий глобально различать разные книги, даже одноименные и имеющие одинаковых авторов (дополненные издания, к примеру). Если ID и версия у двух файлов одинаковые, ожидается, что документы эквивалентны.
- version - 1 (один, обязателен) - Номер версии, позволяющий определить более новый файл при встрече с несколькими книгами с одинаковыми ID
Поскольку является корневым элементом, то здесь также задаются пространства имен (что выглядит похоже на аттрибуты).
Подчиненные элементы
Должен содержать в перечисленном порядке:
- <periodical> - 0..1 (опционально)
- <title> - 1 (один, обязателен) - Название произведения. Как обычно - из трех этажей
- <sequence> - 0..n (любое число, опционально)
- <fb3-relations> - 1 (один, обязателен) - Связанные с данным произведением субьекты и объекты
- <fb3-classification> - 1 (один, обязателен) - Как каталогизировать данное произведение - на какие полки ставить и рядом с чем
- <lang> - 1 (один, обязателен)
- <written> - 0..1 (опционально) - Информация о том, где и когда было написано произведение
- <document-info> - 1 (один, обязателен)
- <history> - 0..1 (опционально)
- <keywords> - 0..1 (опционально)
- <publish-info> - 0..n (любое число, опционально)
- <custom-info> - 0..n (любое число, опционально)
- <anotation> - 0..1 (опционально)
Подчинен
Поскольку является корневым элементом, то никому не подчинен.
Пример использования
{{{example}}}
Смотри также
{{{see}}}
Комментарии
{{{comments}}}