Изменить стиль страницы

Часть II

Подробное описание формата FictionBook

§ 2.1 Структура файла FictionBook.

Базовые понятия

Книга FictionBook представляет собой XML-файл.

Структурно этот файл можно разделить на три части.

1) Desсription — заголовок (описание) книги;

2) Body — непосредственно текст книги. В книге может быть несколько body.

3) Binary — необязательная часть. Содержит бинарные файлы, в кодировке BASE64. [2.1]  Как правило, это картинки.

§ 2.2 Пример книги в формате FictionBook

Cпецификация (schema) FictionBook находится на сайте Дмитрия Грибова, а также входит в комплект FB Tools. Поэтому размещать ее в электронной версии книги смысла нет.

Но пример книги в формате FictionBook привести необходимо:

 

 

   reference

  

    Имя автора

    Фамилия автора

    Юзич

  

   Пример книги в формате FictionBook 2.1

  

   

Это пример книги в формате FictiionBook

  

   14 апреля 2006 г.

   ru

 

 

  

    Юзич

  

   FB Tools

   2006-04-14

   1E693E16-8A80-4391-9800-C1A91A5E29A7

   1.0

  

   

v 1.0 — создание книги (Юзич)

  

 

 

 

  </p><p>   <p>Юзич</p></p><p>   <p>ПРИМЕР КНИГИ В ФОРМАТЕ FictionBook 2.1</p></p><p> 

 

  

Это эпиграф

   Автор эпиграфа

 

 

   </p><p>    <p>Первая секция</p></p><p>  

  

Секции обычно содержат текст.

  

  

Текст может разделяться пустыми строками.

   Подзаголовок

  

Или подзаголовками.

 

 

   </p><p>    <p>Вторая секция</p></p><p>  

  

    </p><p>     <p>Первая вложенная секция</p></p><p>   

   

Текст может быть полужирным или курсивным.

   

Содержать линки и [сноски].

   

В тексте могут быть картинки.

   

   

  

  

    </p><p>     <p>Вторая вложенная секция</p></p><p>   

   

    

Это цитата.

     Автор цитаты.

   

   

Снова текст.

  

 

 

   </p><p>    <p>Третья секция</p></p><p>  

  

Стихи:

  

    </p><p>     <p>Парус</p></p><p>   

   

     А у дельфина взрезано брюхо винтом.

     Выстрела в спину не ожидает никто.

     На батарее нету снарядов уже.

     Надо быстрее на вираже.

   

   

     Но парус! Порвали парус!

     Каюсь! Каюсь! Каюсь!

   

    Владимир Высоцкий

  

  

Снова обычный текст.

 

 

 

  </p><p>   <p>Примечания</p></p><p> 

 

   </p><p>    <p>1</p></p><p>  

  

Текст сноски.

 

 

 iVBORw0KGgoAAAANSUhEUgAAAAkAAAAICAMAAAAcEyWHAAAABGdBTUEAAK/INwWK6QAAABl0

RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAAAGUExURQEBAf///+tZAq0AAAAY

SURBVHjaYmBAAEZGRjDGzsKvDgYAAgwABR4AH2mwMFgAAAAASUVORK5CYII=

§ 2.3 Элементы описания книги.

Базовые структурные элементы

В самом начале любого файла книги идет признак формата XML

<?xml version="1.0" encoding="windows-1251"? >

Здесь указана сигнатура принадлежности к формату XML, его версия и кодировка файла. Для русскоязычных FictionBook это обычно windows-1251 или utf-8. [2.2]

За ним в обязательном порядке следует:

Элемент FictionBook

Корневой элемент.

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

Фактически, всегда используется в виде:

<FictionBook xmlns=" http://www.gribuser.ru/xml/fictionbook/2.0 " xmlns:l=" http://www.w3.org/1999/xlink " >

content

</FictionBook >.

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

Вложенные элементы : stylesheet , description , body , binary

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

Атрибуты : xmlns

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

Пример : см. пример книги FictionBook, § 2.2

Элемент stylesheet

Список стилей, позволяющих конкретно определить, как будет выглядеть книга на экране устройства для чтения. До последнего времени читалками не поддерживался и практически не использовался. Лишь в конце 2007 года появился CoolReader 3.09 с экспериментальной поддержкой stylesheet.

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

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

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

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

Атрибуты : type

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

Пример :

 

 .body{font-family : Verdana, Geneva, Arial, Helvetica, sans-serif;}

 .p{margin:0.5em 0 0 0.3em; padding:0.2em; text-align:justify;}

 

Элемент description

Заголовок (описание) книги.

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

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

Вложенные элементы : title-info , src-title-info , document-info , publish-info , custom-info , output

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

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

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

Пример :

 

   nonfiction

  

    Имя автора

    Фамилия автора

  

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

   2007 г.

   ru

 

 

  

    Юзич

  

   FB Tools

   2006-07-10

   46C35002-014D-4AE4-8FE4-5E7881D72B0D

   1.0

 

 

Элемент body

Тело книги. Допускаются дополнительные body для примечаний и дополнительных материалов.

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

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

Вложенные элементы : image , title , epigraph , section

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

Атрибуты : name

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

Пример :

  </p><p>   <p>Заголовок</p></p><p> 

 

  

Текст.