Элемент fb3d:fb3-description

Материал из FictionBook
Перейти к: навигация, поиск

Элемент <fb3-description>

Описание

Корневой элемент для мета-данных в fb3.

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

Атрибуты

  • id - 1 (один, обязателен) - UUID - ID, позволяющий глобально различать разные книги, даже одноименные и имеющие одинаковых авторов (дополненные издания, к примеру). Если ID и версия у двух файлов одинаковые, ожидается, что документы эквивалентны.
  • version - 1 (один, обязателен) - Номер версии, позволяющий определить более новый файл при встрече с несколькими книгами с одинаковыми ID

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

Подчиненные элементы

Должен содержать в перечисленном порядке:

  1. <periodical> - 0..1 (опционально)
  2. <title> - 1 (один, обязателен) - Название произведения. Как обычно - из трех этажей
  3. <sequence> - 0..n (любое число, опционально)
  4. <fb3-relations> - 1 (один, обязателен) - Связанные с данным произведением субьекты и объекты
  5. <fb3-classification> - 1 (один, обязателен) - Как каталогизировать данное произведение - на какие полки ставить и рядом с чем
  6. <lang> - 1 (один, обязателен)
  7. <written> - 0..1 (опционально) - Информация о том, где и когда было написано произведение
  8. <document-info> - 1 (один, обязателен)
  9. <history> - 0..1 (опционально)
  10. <keywords> - 0..1 (опционально)
  11. <publish-info> - 0..n (любое число, опционально)
  12. <custom-info> - 0..n (любое число, опционально)
  13. <anotation> - 0..1 (опционально)

Подчинен

Поскольку является корневым элементом, то никому не подчинен.

Пример использования

{{{example}}}

Смотри также

{{{see}}}

Комментарии

{{{comments}}}