§ 2.5 Элементы описания книги (description). Элементы второго уровня. Часть II. Подробное описание формата FictionBook. Создание электронных книг в формате FictionBook.

Создание электронных книг в формате FictionBook.

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

Элемент genre.

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

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

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

Синтаксис: <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).

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

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

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

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

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

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

<author> <first-nаmе>Михаил</first-name> <middle-nаmе>Иосифович</middlе-name> <last-nаmе>Кондратович</lаst-name> <niскnаmе>Юзич</niскnаmе> <home-page>http://www.yuzzich.narod.ru</home-page> <email>yuzzich@yandex.ru</email> </author>

Элемент book-title.

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

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

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

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

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

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

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

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

Элемент annotation.

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

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

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

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

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

Атрибуты: id.

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

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

Элемент keywords.

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

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

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

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

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

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

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

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

Пример:

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

Элемент date.

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

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

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

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

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

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

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

Атрибуты: value.

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

Пример:

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

Элемент coverpage.

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

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

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

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

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

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

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

Пример:

Элемент lang.

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

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

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

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

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

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

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

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

Пример:

Элемент src-lang.

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

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

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

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

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

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

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

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

Пример:

<src-lang>en</src-lang>

Элемент translator.

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

Синтаксис: <translator>content</translator>

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

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

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

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

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

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

Элемент sequence.

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

Синтаксис: <sequence/> или <sequence><sequence/></sequence>

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

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

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

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

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

Пример:

Элемент program-used.

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

Синтаксис: <program-used>текст</program-used>

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

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

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

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

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

Пример:

<program-used>FB Tools, EmEditor, hands.drv & brain.sys</program-used>

Элемент src-url.

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

Синтаксис: <src-url>текст</src-url>

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

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

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

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

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

Пример:

<src-url>http://www.natahaus.ru</src-url>

Элемент src-ocr.

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

Синтаксис: <src-ocr>текст</src-ocr>

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

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

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

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

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

Пример:

<src-ocr>OCR Zmiy; SpellCheck Юзич</srс-ocr>

Элемент id.

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

Синтаксис: <id>текст</id>

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

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

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

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

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

Пример:

Элемент version.

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

Синтаксис: <version>число</version>

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

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

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

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

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

Пример:

Элемент history.

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

Синтаксис: <history>Content</history>

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

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

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

Атрибуты: id.

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

Пример:

<history> v 1.0 — вычитка, конвертация в FB2 (Юзич) v 1.1 — дополнительное форматирование (Faiber) v 1.2 — дополнительная вычитка (Юзич) v 1.3 — дополнительная вычитка (Юзич) v 1.4 — окончательная (надеюсь!) вычитка (Юзич) </history>

Элемент book-name.

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

Синтаксис: <book-name>текст</book-name>

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

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

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

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

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

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

Элемент publisher.

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

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

Синтаксис: <publisher>текст</publisher>

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

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

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

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

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

Элемент city.

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

Синтаксис:<city>текст</city>

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

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

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

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

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

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

Элемент year.

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

Синтаксис: <year>текст</year>

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

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

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

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

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

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

Элемент isbn.

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

Синтаксис: <isbn>текст</isbn>

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

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

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

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

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

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

Оглавление.