"Создание электронных книг в формате FictionBook 2.1: практическое руководство (beta 4)" - читать интересную книгу автора (Кондратович Михаил Иосифович)

§ 2.5 Элементы описания книги (description). Элементы второго уровня

Элемент genre

Жанр произведения.

Содержимое элемента строго фиксировано и определяется файлом FictionBookGenres.xsd, входящим в состав спецификации FictionBook.

Список жанров с переводом приведен в Приложении В.

Cинтаксис: lt;genregt;фиксированное значениеlt;/genregt;.

Используется в элементах: title-info, src-title-info

Вложенные элементы: нет

Количество вхождений: одно или более

Атрибуты: match

Версия формата: 2.0

Пример:

lt;genregt;sf_actionlt;/genregt;

   lt;genre match="30"gt;sf_spacelt;/genregt;

Элемент author

Автор произведения или создатель электронной книги.

Согласно спецификации, существуют два варианта правильного заполнения элемента. В первом случае, обязательно должны быть заполнены поля «Имя» и «Фамилия» (элементы first-name и last-name). Во втором — поле «Ник» (элемент nickname).

Cинтаксис: lt;authorgt;Contentlt;/authorgt;.

Используется в элементах: title-info, src-title-info, document-info

Вложенные элементы: first-name, middle-name, last-name, nickname, home-page, email

Количество вхождений: одно или более

Атрибуты: нет

Версия формата: 2.0

lt;authorgt;

    lt;first-namegt;Кондратович lt;/first-namegt;

    lt;middle-namegt;Михаилlt;/middle-namegt;

    lt;last-namegt;Иосифовичlt;/last-namegt;

    lt;nicknamegt;Юзичlt;/nicknamegt;

    lt;home-pagegt;http://www.yuzich.narod.rult;/home-pagegt;

    lt;emailgt;[email protected];/emailgt;

   lt;/authorgt;

Элемент book-title

Название книги.

Cинтаксис: lt;book-titlegt;текстlt;/book-titlegt;.

Используется в элементах: title-info, src-title-info

Вложенные элементы:

Количество вхождений: одно

Атрибуты: нет

Версия формата: 2.0

Пример:

Элемент annotation

Аннотация. Краткое текстовое описание книги

Cинтаксис: lt;annotationgt;contentlt;/annotationgt;.

Используется в элементах: title-info, src-title-info, section

Вложенные элементы: p, poem, cite, subtitle, table, empty-line

Количество вхождений: одно или отсутствует

Атрибуты: id

Версия формата: 2.0

Пример:

Элемент keywords

Список ключевых слов, с помощью которых библиотечный софт может искать книгу.

Слова должны быть характерными для конкретного произведения.

Cинтаксис: lt;keywordsgt;текстlt;/keywordsgt;.

Используется в элементах: title-info, src-title-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример:

lt;keywordsgt;Лунная радуга, Анарда, экзот, гурм, МУКБОП, Япет, Казарангlt;/keywordsgt;

Элемент date

Дата написания книги или создания файла.

Список ключевых слов, с помощью которых библиотечный софт может искать книгу.

Элемент date предусмотрен также и в стихотворениях, но из-за отсутствия поддержки в редакторах там не используется.

Cинтаксис: lt;dategt;текстlt;/dategt;.

Используется в элементах: title-info, src-title-info, document-info, poem

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: value

Версия формата: 2.0

Пример:

lt;date value="1989-01-01"gt;Красноярск, июнь 1989lt;/dategt;

Элемент coverpage

Картинка обложки. Содержит внутри элемент image, в который непосредственно и находится ссылка на bin-объект. Элементов image может быть несколько.

Cинтаксис: lt;coverpagegt;lt;image/gt;lt;/coverpagegt;

Используется в элементах: title-info, src-title-info

Вложенные элементы: image

Количество вхождений:  одно или отсутствует.

Атрибуты: нет

Версия формата: 2.0

Пример:

   lt;coverpagegt;

    lt;image l:href="#cover.jpg"/gt;lt;/coverpagegt;

Элемент lang

Язык, на котором написана книга.

Список возможных значений приведен в Приложении Г.

Cинтаксис: lt;langgt;по возможности, фиксированное значениеlt;/langgt;

Используется в элементах: title-info, src-title-info

Вложенные элементы: нет

Количество вхождений: одно

Атрибуты: нет

Версия формата: 2.0

Пример:

   lt;langgt;rult;/langgt;

Элемент src-lang

Язык, на котором написан оригинал (для переводных книг).

Список возможных значений приведен в Приложении Г.

Cинтаксис: lt;src-langgt;по возможности, фиксированное значениеlt;/src-langgt;

Используется в элементах: title-info, src-title-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример:

lt;src-langgt;enlt;/src-langgt;

Элемент translator

Информация о переводчике  (для переводных книг).

Cинтаксис: lt;translatorgt;contentlt;/translatorgt;

Используется в элементах: title-info, src-title-info

Вложенные элементы: first-name, middle-name, last-name, nickname, home-page, email

Количество вхождений: произвольное

Атрибуты: нет

Версия формата: 2.0

Пример: см. пример элемент author

Элемент sequence

Серия, в которую входит книга. Допускается неограниченное число вложенных серий.

Cинтаксис: lt;sequence/gt; или lt;sequencegt;lt;sequence/gt;lt;/sequencegt;

Используется в элементах: title-info, src-title-info

Вложенные элементы: sequence

Количество вхождений: произвольное

Атрибуты: name (обязательный), number

Версия формата: 2.0

Пример:

lt;sequence name="Звёздные Войны"gt;

    lt;sequence name="Адмирал Траун" number="2"/gt;

   lt;/sequencegt;

Элемент program-used

Программное обеспечение, использовавшееся при создании книги.

Cинтаксис: lt;program-usedgt;текстlt;/program-usedgt;

Используется в элементах: document-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример:

   lt;program-usedgt;FB Tools, EmEditor, hands.drv amp; brain.syslt;/program-usedgt;

Элемент src-url

Ссылка на сайт, если исходный текст книги был скачан из Интернета.

Cинтаксис: lt;src-urlgt;текстlt;/src-urlgt;

Используется в элементах: document-info

Вложенные элементы: нет

Количество вхождений: произвольное

Атрибуты: нет

Версия формата: 2.0

Пример:

lt;src-urlgt;http://www.natahaus.rult;/src-urlgt;

Элемент src-ocr

Информация о людях, которые сканировали (набирали) и вычитывали книгу.

Cинтаксис: lt;src-ocrgt;текстlt;/src-ocrgt;

Используется в элементах: document-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример:

lt;src-ocrgt;OCR Zmiy; SpellCheck Юзичlt;/src-ocrgt;

Элемент id

Уникальный идентификационный номер книги.

Cинтаксис: lt;idgt;текстlt;/idgt;

Используется в элементах: document-info

Вложенные элементы: нет

Количество вхождений: одно

Атрибуты: нет

Версия формата: 2.0

Пример:

lt;idgt;B3627A48-7F9C-400E-8CD7-0159B75F1A14lt;/idgt;

Элемент version

Номер версии файла.

Cинтаксис: lt;versiongt;числоlt;/versiongt;

Используется в элементах: document-info

Вложенные элементы: нет

Количество вхождений: одно

Атрибуты: нет

Версия формата: 2.0

Пример:

lt;versiongt;1.0lt;/versiongt;

Элемент history

История изменений,  вносившихся в файл.

Cинтаксис: lt;historygt;Contentlt;/historygt;

Используется в элементах: document-info

Вложенные элементы: p, poem, cite, subtitle, table, empty-line

Количество вхождений: одно или отсутствует

Атрибуты: id

Версия формата: 2.0

Пример:

   lt;historygt;

    lt;pgt;v 1.0 — вычитка, конвертация в FB2 (Юзич)lt;/pgt;

    lt;pgt;v 1.1 — дополнительное форматирование (Faiber)lt;/pgt;

    lt;pgt;v 1.2 — дополнительная вычитка (Юзич)lt;/pgt;

    lt;pgt;v 1.3 — дополнительная вычитка  (Юзич)lt;/pgt;

    lt;pgt;v 1.4 — окончательная (надеюсь!) вычитка  (Юзич)lt;/pgt;

   lt;/historygt;

Элемент book-name

Название бумажного оригинала.

Cинтаксис: lt;book-namegt;текстlt;/book-namegt;

Используется в элементах: publish-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример: см. пример элемента publish-info

Элемент publisher

Название издательства, выпустившего бумажный оригинал.

Используется в элементах: publish-info

Cинтаксис: lt;publishergt;текстlt;/publishergt;

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример: см. пример элемента publish-info

Элемент city

Город, в котором был издан бумажный оригинал.

Cинтаксис:lt;citygt;текстlt;/citygt;

Используется в элементах: publish-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример: см. пример элемента publish-info

Элемент year

Год выхода бумажного оригинала

Cинтаксис: lt;yeargt;текстlt;/yeargt;

Используется в элементах: publish-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример: см. пример элемента publish-info

Элемент isbn

ISBN-код бумажного оригинала.

Cинтаксис: lt;isbngt;текстlt;/isbngt;

Используется в элементах: publish-info

Вложенные элементы: нет

Количество вхождений: одно или отсутствует

Атрибуты: нет

Версия формата: 2.0

Пример: см. пример элемента publish-info