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

Заранее определенный стиль для отображения книги.

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

Используется в элементах:  code, emphasis, p, strikethrough, strong, style, subtitle, sub, sup, th, td, v

Вложенные элементы:     code, emphasis, strikethrough, strong, style, sub, sup, image

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

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

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

Пример:

Этот текст будет <style name="italic">курсивным </style>

— <style name="foreign lang" xml:lang="fr">Dieu, quelle virulente sortie</style>

Нижний индекс (subscript).

На момент написания книги читалками не поддерживается.

Cинтаксис: _content

Используется в элементах:  code, emphasis, p, strikethrough, strong, style, subtitle, sub, sup, th, td, v

Вложенные элементы:     a, code, emphasis, strikethrough, strong, style, sub, sup, image

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

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

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

Пример:

x₁+x₂=y

Верхний индекс (superscript).

На момент написания книги читалками не поддерживается.

Cинтаксис: ^content

Используется в элементах:  code, emphasis, p, strikethrough, strong, style, subtitle, sub, sup, th, td, v

Вложенные элементы:     a, code, emphasis, strikethrough, strong, style, sub, sup, image

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

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

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

Пример:

E=mC²

§ 2.12 Элементы для платных книг

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

К сожалению, или, вернее, к счастью, эти элементы до сих пор не нашли применения.

Определяет способ вывода контента книги.

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

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

Вложенные элементы: part, output-document-class

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

Атрибуты: mode (обязательный), currency, incude-all (обязательный)

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

Пример:

<output mode="free" include-all="deny">

<part include="require" l:href="#half0_1"/>

<part include="allow" l:href="#half0_2"/>

<part include="allow" l:href="#half0_4_2"/>

<part include="require" l:href="#half0_4_3"/>

</output>

<output mode="paid" price="3.14" currency="WMZ" include-all="require">

<part include="deny" l:href="#half0_4_3"/>

</output>

Назначение неясно.

Cинтаксис:<output-document-class>parts</output-document-class>

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

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

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

Атрибуты: name, create, price

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

Пример:

Делит книгу на платные и бесплатные части.

Cинтаксис:<part/>

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

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

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

Атрибуты: mode, include

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

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

§ 2.13 Спецсимволы

Некоторые символы в теле книги отображаются особым образом. Это нужно для предотвращения ошибок. Например, «<» и «>» зарезервированы для обозначения границ тэгов. Если их использовать в прямом виде как-то еще, то программа будет считать это ошибкой.

Такие последовательности называются предопределенными сущностями.

Список таких символов в FictionBook крайне мал. Их, собственно, всего три.

&amp; — &;

&lt; — <;

&gt ; — >;

Cтандартные сущности XML &apos; и &quot; в FiсtionBook не используются и конвертируются в символы «'» и «"» соответственно.

§ 2.14 Список атрибутов элементов

Многие элементы в FictionBook имеют дополнительные параметры — атрибуты.

Выравнивание текста в ячейке таблицы.

Используется в элементах: td, th, tr

Значение: фиксированное; left, right, center, justify

Значение по умолчанию: left

Назначение аналогично HTML — текст, отображающийся вместо картинки.

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

Значение: произвольная текстовая строка

Позволяет объединять столбцы таблиц.

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

Значение: произвольное целое число

Определяет тип содержимого элемента-контейнера binary

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

Значение: фиксированное; image/png, image/jpeg, image/tiff, image/bmp, octet-stream

Назначение неясно.

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

Значение:

Валюта, в которой определена цена платной книги.

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

Значение: ограниченно-произвольное

Ссылка. Как правило, внутри документа.

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

Значение: ссылка.

Метка, позволяющая ссылаться на элемент.

Используется в элементах: annotation, binary, cite, epigraph, image, p, poem, section, subtitle, table, td, text-author, th

Значение:  текстовая строка.

Характеризует произвольную информацию.

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

Значение: произвольная текстовая строка.

Назначение неясно.

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

Значение:

Назначение неясно.

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

Значение: фиксированное

Определяет степень соответствия произведения выбранному жанру.

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

Значение: целое число в диапазоне от 1 до 100

Способ вывода платного документа

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

Значение:

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

Используется в элементах: body, sequence, output-document-class

Значение: произвольное

Порядковый номер книги в серии.

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

Значение: произвольное целое число

Цена платного документа

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

Значение: произвольное число c плавающей запятой

Позволяет объединять строки таблицы.

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

Значение: произвольное целое число

Позволяет выбрать для элемента предопределенный стиль.

Используется в элементах: p, subtitle, table, td, text-author, th

Значение: произвольное; строка состоящая из латинских букв и цифр.