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

Аналогично src-title-info содержит базовую информацию о книге-оригинале (для переводных книг).

Здесь наблюдается интересный момент: как title-info, так и src-title-info содержат элемент src-lang. Хотя, по логике, его следовало бы упразднить.

Cинтаксис: <src-title-info>content</src-title-info>.

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

Вложенные элементы: genre, author, book-title, annotation, keywords, date, coverpage, lang, src-lang, translator, sequence

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

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

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

Пример:

<src-title-info>

   <genre>adv_maritime</genre>

   <author>

    <first-name>Robert</first-name>

    <middle-name>Loevis</middle-name>

    <last-name>Stivenson</last-name>

   </author>

   <book-title>Treasure Island</book-title>

   <date>1896</date>

   <lang>en</lang>

  </src-title-info>

Элемент document-info

Информация о самом файле FictionBook — кем, когда  и с помощью каких программных средств создана данная электронная книга.

Cинтаксис: <document-info>content</document-info>.

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

Вложенные элементы: author, program-used, date, src-url, src-ocr, id, version, history

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

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

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

Пример:

<document-info>

   <author>

    <nickname>Юзич</nickname>

    <email>[email protected]</email>

   </author>

   <program-used>FB Tools</program-used>

   <date value="2006-06-29">2006-05-22</date>

   <src-url>http://hungryewok.narod.ru/</src-url>

   <src-ocr>OCR: Голодный Эвок Грызли; SpellCheck: Юзич</src-ocr>

   <id>86F8C27D-9F15-4DE7-8751-12AE057CA4DC</id>

   <version>1.0</version>

   <history>

    <p>v 1.0 — вычитка, конвертация в FB2 (Юзич)</p>

   </history>

Элемент publish-info

Информация о бумажном оригинале книги, если таковой существовал в природе.

Cинтаксис: <publish-info>content</publish-info>.

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

Вложенные элементы: book-name, publisher, city, year, isbn, sequence

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

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

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

Пример:

<publish-info>

   <book-name>С. Павлов «Лунная радуга»</book-name>

   <publisher>Детская литература</publisher>

   <city>Москва</city>

   <year>1989</year>

   <isbn>5-08-000842-3</isbn>

   <sequence name="Библиотека приключений и научной фантастики"/>

  </publish-info>

Элемент custom-info

Произвольная дополнительная информация.

Cинтаксис: <custom-info>текст</custom-info>.

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

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

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

Атрибуты: info-type (обязательный) 

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

Пример:

  <custom-info info-type="На правах рекламы:">Сайт Голодного Эвока Грызли — лучшее в Рунете собрание книг по «Звёздным Войнам»!</custom-info>

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

Элемент genre

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

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

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

Cинтаксис: <genre>фиксированное значение</genre>.

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

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

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

Атрибуты: match

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

Пример:

<genre>sf_action</genre>

   <genre match="30">sf_space</genre>

Элемент author

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

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

Cинтаксис: <author>Content</author>.

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

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

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

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

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

<author>

    <first-name>Кондратович </first-name>

    <middle-name>Михаил</middle-name>

    <last-name>Иосифович</last-name>

    <nickname>Юзич</nickname>

    <home-page>http://www.yuzich.narod.ru</home-page>

    <email>[email protected]</email>

   </author>

Элемент book-title

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

Cинтаксис: <book-title>текст</book-title>.

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

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

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

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

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

Пример:

Элемент annotation

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

Cинтаксис: <annotation>content</annotation>.

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

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

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

Атрибуты: id

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

Пример:

Элемент keywords

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

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

Cинтаксис: <keywords>текст</keywords>.

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

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

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

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

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

Пример:

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

Элемент date

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

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

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

Cинтаксис: <date>текст</date>.

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

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

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

Атрибуты: value

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

Пример:

<date value="1989-01-01">Красноярск, июнь 1989</date>

Элемент coverpage

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

Cинтаксис: <coverpage><image/></coverpage>

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

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

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

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

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

Пример:

   <coverpage>

    <image l:href="#cover.jpg"/></coverpage>

Элемент lang

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

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

Cинтаксис: <lang>по возможности, фиксированное значение</lang>

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

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

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

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