FictionBook - Вклад участника [ru]

FictionBook 3.0 beta - краткое описание

2008-10-01T20:09:43Z

Sclex: /* Файл мета-информации */ описыватьболее -> описывать более

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Первая версия предложена 3 июля 2008 г.''<br>
''Версия 0.1 от 1 октября 2008 г.''

== Цель создания формата ==
Формат fb3 разрабатывается для удовлетворения возросших требований к форматированию текста книг и возможностям их каталогизации. Современное состояние стандартов и технологий позволяет, помимо простого расширения набора тегов, привести формат к совместимости с наиболее удачными и перспективными наработками. В частности, в основу fb3 положен стандарт Open Packaging Convention ([http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2]). Помимо этого в качестве картинок можно использовать SVG-файлы (и GIF-файлы, патент на которые закончился).

== Преемственность с форматом fb2 ==
'''Приоритеты''', на которых основан формат fb2, остаются, но частично расширяются:
* Принцип одна книга - один файл сохраняется. Более того, fb3 полноценно поддерживает "подшивки" - несколько книг в одном fb3-файле.
* Минимализм форматирования сохраняется, но для работы со сложными документами (например, с учебниками) в fb3 вводится минимально-необходимый набор тегов, обеспечивающий максимальное качество верстки при максимально возможной простоте.
* Вся мета-информация является неотъемлемой частью файла. В соответствии с возросшими требованиями к полноте и точности мета-информации была разработана новая, прямо не совместимая с дескрипшном fb2, структура.
* Формат, как и прежде, максимально ориентирован на полноценную и эффективную переносимость текста на любое устройство, с ограниченными ресурсами, черно-белым или небольшим дисплеем и т.п. Единожды сверстанная книга должна быть максимально удобной в любой среде.

'''Основные отличия''' от fb2 находятся не в области идеологии, а в области технологических решений. Коротко о наиболее важных отличиях отметим:
* fb3-файл теперь является по сути zip-архивом, в котором упакованы отдельными файлами мета-информация, картинки и текст. Требования к формату zip-файла и соглашения об именах файлов, их размещении и организации описаны в стандарте [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2]
* Мета-информация выносится в отдельный файл, тело книги и сноски - в другой файл
* Все картинки выносятся из XML и являются, в конечном счете, файлами в архиве
* Связи документа с файлами осуществляются не через xlink, а в соответствии с описанным в OPF механизмом ''отношений'' (Relationships)
* Помимо ряда мелких нововведений в форматирование (разрядка, подчеркивание) добавляется принципиально новый объект "блок", выпадающий из общего течения документа и оформляющий произвольный фрагмент книги в виде четырехугольника, который может иметь границу, внедряться в текст с обтеканием и иметь некоторые другие особенности размещения.
* Часть тегов, имеющих смысловые аналоги в HTML, будет переименована, к примеру emphasis превратится в em.

== Общая информация о структуре fb3-файла ==
В соответствии со спецификацией [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2] файл fb3 будет представлять собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib). Имена файлов в архиве сравниваются без учета регистра, изначально зарезервированы имена файлов:
* /[Content_Types].xml
* /_rels/.rels
Файл /_rels/.rels адресует файл-обложку (thumbnail) для всего fb3-пакета и как минимум один файл дескрипшна книги. Дескрипшн книги, в свою очередь, связан с телом книги и своей собственной обложкой, а тело книги связано со всеми включенными в него объектами. Все связи описываются стандартными средствами OPC (ECMA-376 Part 2, раздел 8.3 Relationships).

В качестве графических форматов будет поддерживаться gif/png/jpg/svg (SVG 1.1 Basic)

Более детальное описание требований к zip-архиву, механизмов связывания, кодировок и ограничений на именование файлов в архиве можно найти в стандарте [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2].

== Файл мета-информации ==
Подробно изучить структуру и возможности fb3 в описании книги можно на примере файла /fb3/description.xml из [http://www.gribuser.ru/xml/fictionbook/3.00/example.fb3.zip архива с примером fb3-книги]. Большинство полей там снабжены русскоязычными комментариями. Из существенных нововведений по отношению к fb2 отметим:
* Блок описания периодических изданий (журнал такой-то, номер такой-то)
* sub-title - подзаголовок, позволяет описывать более сложноорганизованные названия
* Унифицированный механизм описания авторов, переводчиков, иллюстраторов и прочих, имеющих отношение к книге, субъектов.
* Возможность описывать связанные объекты: книги, с которых сделан перевод, приложения, продолжения, та же книга на другом носителе (аудиокнига) и т.п.
* Добавлена информация о целевой аудитории и об описываемом периоде
Большая часть новых полей логически совместима со стандартами RUSMARC и USMARC

== Файл с текстом книги ==
Пример можно найти в примере fb3-документа, в файле /fb3/body.xml, где большинство новинок проиллюстрированы примерами применения и комментариями. Основные нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width, border. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, родительский по отношению к p.
* Сноски более гибко типизируемые. Допускается "подсказывать" читалке, как следует отображать сноски, следует ли переоформлять номера сносок средствами читалки и какие сноски концевые и подстраничные.
* Сноски выделяются в отдельный узел notes, и оформляются не как секции, а новым тегом <note>

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''[Content_Types].xml'''
| -> Обязательный файл в архиве, содержит описание MIME-типов для всех размещенных в архиве файлов
|-
|    '''cover.jpg'''
| -> Обложка всей книги, для быстрого доступа программ-читалок
|-
|    '''_rels/.rels'''
| -> Обязательный xml-файл в архиве. В нем ссылки на обложку, файл(ы) мета-информации и прочее.
|-
|    '''fb3/description.xml'''
| -> Файл с мета-информацией
|-
|    '''fb3/_rels/description.xml.rels'''
| -> Файл со связями данной карточки книги - указывается обложка и файл с текстом книги
|-
|    '''fb3/body.xml'''
| -> Файл с текстом книги, сносками
|-
|    '''fb3/_rels/body.xml.rels'''
| -> Файл со связями текста книги - описываются все использованные картинки
|-
|    '''fb3/marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

FictionBook 3.0 beta - краткое описание

2008-10-01T20:08:00Z

Sclex: /* Преемственность с форматом fb2 */ пара пропущенных запятых

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Первая версия предложена 3 июля 2008 г.''<br>
''Версия 0.1 от 1 октября 2008 г.''

== Цель создания формата ==
Формат fb3 разрабатывается для удовлетворения возросших требований к форматированию текста книг и возможностям их каталогизации. Современное состояние стандартов и технологий позволяет, помимо простого расширения набора тегов, привести формат к совместимости с наиболее удачными и перспективными наработками. В частности, в основу fb3 положен стандарт Open Packaging Convention ([http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2]). Помимо этого в качестве картинок можно использовать SVG-файлы (и GIF-файлы, патент на которые закончился).

== Преемственность с форматом fb2 ==
'''Приоритеты''', на которых основан формат fb2, остаются, но частично расширяются:
* Принцип одна книга - один файл сохраняется. Более того, fb3 полноценно поддерживает "подшивки" - несколько книг в одном fb3-файле.
* Минимализм форматирования сохраняется, но для работы со сложными документами (например, с учебниками) в fb3 вводится минимально-необходимый набор тегов, обеспечивающий максимальное качество верстки при максимально возможной простоте.
* Вся мета-информация является неотъемлемой частью файла. В соответствии с возросшими требованиями к полноте и точности мета-информации была разработана новая, прямо не совместимая с дескрипшном fb2, структура.
* Формат, как и прежде, максимально ориентирован на полноценную и эффективную переносимость текста на любое устройство, с ограниченными ресурсами, черно-белым или небольшим дисплеем и т.п. Единожды сверстанная книга должна быть максимально удобной в любой среде.

'''Основные отличия''' от fb2 находятся не в области идеологии, а в области технологических решений. Коротко о наиболее важных отличиях отметим:
* fb3-файл теперь является по сути zip-архивом, в котором упакованы отдельными файлами мета-информация, картинки и текст. Требования к формату zip-файла и соглашения об именах файлов, их размещении и организации описаны в стандарте [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2]
* Мета-информация выносится в отдельный файл, тело книги и сноски - в другой файл
* Все картинки выносятся из XML и являются, в конечном счете, файлами в архиве
* Связи документа с файлами осуществляются не через xlink, а в соответствии с описанным в OPF механизмом ''отношений'' (Relationships)
* Помимо ряда мелких нововведений в форматирование (разрядка, подчеркивание) добавляется принципиально новый объект "блок", выпадающий из общего течения документа и оформляющий произвольный фрагмент книги в виде четырехугольника, который может иметь границу, внедряться в текст с обтеканием и иметь некоторые другие особенности размещения.
* Часть тегов, имеющих смысловые аналоги в HTML, будет переименована, к примеру emphasis превратится в em.

== Общая информация о структуре fb3-файла ==
В соответствии со спецификацией [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2] файл fb3 будет представлять собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib). Имена файлов в архиве сравниваются без учета регистра, изначально зарезервированы имена файлов:
* /[Content_Types].xml
* /_rels/.rels
Файл /_rels/.rels адресует файл-обложку (thumbnail) для всего fb3-пакета и как минимум один файл дескрипшна книги. Дескрипшн книги, в свою очередь, связан с телом книги и своей собственной обложкой, а тело книги связано со всеми включенными в него объектами. Все связи описываются стандартными средствами OPC (ECMA-376 Part 2, раздел 8.3 Relationships).

В качестве графических форматов будет поддерживаться gif/png/jpg/svg (SVG 1.1 Basic)

Более детальное описание требований к zip-архиву, механизмов связывания, кодировок и ограничений на именование файлов в архиве можно найти в стандарте [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2].

== Файл мета-информации ==
Подробно изучить структуру и возможности fb3 в описании книги можно на примере файла /fb3/description.xml из [http://www.gribuser.ru/xml/fictionbook/3.00/example.fb3.zip архива с примером fb3-книги]. Большинство полей там снабжены русскоязычными комментариями. Из существенных нововведений по отношению к fb2 отметим:
* Блок описания периодических изданий (журнал такой-то, номер такой-то)
* sub-title - подзаголовок, позволяет описыватьболее сложноорганизованные названия
* Унифицированный механизм описания авторов, переводчиков, иллюстраторов и прочих, имеющих отношение к книге, субъектов.
* Возможность описывать связанные объекты: книги, с которых сделан перевод, приложения, продолжения, та же книга на другом носителе (аудиокнига) и т.п.
* Добавлена информация о целевой аудитории и об описываемом периоде
Большая часть новых полей логически совместима со стандартами RUSMARC и USMARC

== Файл с текстом книги ==
Пример можно найти в примере fb3-документа, в файле /fb3/body.xml, где большинство новинок проиллюстрированы примерами применения и комментариями. Основные нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width, border. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, родительский по отношению к p.
* Сноски более гибко типизируемые. Допускается "подсказывать" читалке, как следует отображать сноски, следует ли переоформлять номера сносок средствами читалки и какие сноски концевые и подстраничные.
* Сноски выделяются в отдельный узел notes, и оформляются не как секции, а новым тегом <note>

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''[Content_Types].xml'''
| -> Обязательный файл в архиве, содержит описание MIME-типов для всех размещенных в архиве файлов
|-
|    '''cover.jpg'''
| -> Обложка всей книги, для быстрого доступа программ-читалок
|-
|    '''_rels/.rels'''
| -> Обязательный xml-файл в архиве. В нем ссылки на обложку, файл(ы) мета-информации и прочее.
|-
|    '''fb3/description.xml'''
| -> Файл с мета-информацией
|-
|    '''fb3/_rels/description.xml.rels'''
| -> Файл со связями данной карточки книги - указывается обложка и файл с текстом книги
|-
|    '''fb3/body.xml'''
| -> Файл с текстом книги, сносками
|-
|    '''fb3/_rels/body.xml.rels'''
| -> Файл со связями текста книги - описываются все использованные картинки
|-
|    '''fb3/marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

FictionBook 3.0 beta - краткое описание

2008-10-01T20:05:02Z

Sclex: /* Пример содержимого fb3-архива: */ бысрого -> быстрого

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Первая версия предложена 3 июля 2008 г.''<br>
''Версия 0.1 от 1 октября 2008 г.''

== Цель создания формата ==
Формат fb3 разрабатывается для удовлетворения возросших требований к форматированию текста книг и возможностям их каталогизации. Современное состояние стандартов и технологий позволяет, помимо простого расширения набора тегов, привести формат к совместимости с наиболее удачными и перспективными наработками. В частности, в основу fb3 положен стандарт Open Packaging Convention ([http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2]). Помимо этого в качестве картинок можно использовать SVG-файлы (и GIF-файлы, патент на которые закончился).

== Преемственность с форматом fb2 ==
'''Приоритеты''', на которых основан формат fb2, остаются, но частично расширяются:
* Принцип одна книга - один файл сохраняется. Более того, fb3 полноценно поддерживает "подшивки" - несколько книг в одном fb3-файле.
* Минимализм форматирования сохраняется, но для работы со сложными документами (например, с учебниками) в fb3 вводится минимально-необходимый набор тегов, обеспечивающий максимальное качество верстки при максимально возможной простоте.
* Вся мета-информация является неотъемлемой частью файла. В соответствии с возросшими требованиями к полноте и точности мета-информации была разработана новая, прямо не совместимая с дескрипшном fb2, структура.
* Формат, как и прежде, максимально ориентирован на полноценную и эффективную переносимость текста на любое устройство, с ограниченными ресурсами, черно-белым или небольшим дисплеем и т.п. Единожды сверстанная книга должна быть максимально удобной в любой среде.

'''Основные отличия''' от fb2 находятся не в области идеологии, а в области технологических решений. Коротко о наиболее важных отличиях отметим:
* fb3-файл теперь является по сути zip-архивом, в котором упакованы отдельными файлами мета-информация, картинки и текст. Требования к формату zip-файла и соглашения об именах файлов, их размещении и организации описаны в стандарте [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2]
* Мета-информация выносится в отдельный файл, тело книги и сноски - в другой файл
* Все картинки выносятся из XML и являются, в конечном счете файлами в архиве
* Связи документа с файлами осуществляются не через xlink, а в соответствии с описанным в OPF механизмом ''отношений'' (Relationships)
* Помимо ряда мелких нововведений в форматирование (разрядка, подчеркивание) добавляется принципиально новый объект "блок", выпадающий из общего течения документа и оформляющий произвольный фрагмент книги в виде четырехугольника, который может иметь границу, внедряться в текст с обтеканием и иметь некоторые другие особенности размещения.
* Часть тегов, имеющих смысловые аналоги в HTML будет переименована, к примеру emphasis превратится в em.

== Общая информация о структуре fb3-файла ==
В соответствии со спецификацией [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2] файл fb3 будет представлять собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib). Имена файлов в архиве сравниваются без учета регистра, изначально зарезервированы имена файлов:
* /[Content_Types].xml
* /_rels/.rels
Файл /_rels/.rels адресует файл-обложку (thumbnail) для всего fb3-пакета и как минимум один файл дескрипшна книги. Дескрипшн книги, в свою очередь, связан с телом книги и своей собственной обложкой, а тело книги связано со всеми включенными в него объектами. Все связи описываются стандартными средствами OPC (ECMA-376 Part 2, раздел 8.3 Relationships).

В качестве графических форматов будет поддерживаться gif/png/jpg/svg (SVG 1.1 Basic)

Более детальное описание требований к zip-архиву, механизмов связывания, кодировок и ограничений на именование файлов в архиве можно найти в стандарте [http://www.ecma-international.org/publications/standards/Ecma-376.htm ECMA-376 Part 2].

== Файл мета-информации ==
Подробно изучить структуру и возможности fb3 в описании книги можно на примере файла /fb3/description.xml из [http://www.gribuser.ru/xml/fictionbook/3.00/example.fb3.zip архива с примером fb3-книги]. Большинство полей там снабжены русскоязычными комментариями. Из существенных нововведений по отношению к fb2 отметим:
* Блок описания периодических изданий (журнал такой-то, номер такой-то)
* sub-title - подзаголовок, позволяет описыватьболее сложноорганизованные названия
* Унифицированный механизм описания авторов, переводчиков, иллюстраторов и прочих, имеющих отношение к книге, субъектов.
* Возможность описывать связанные объекты: книги, с которых сделан перевод, приложения, продолжения, та же книга на другом носителе (аудиокнига) и т.п.
* Добавлена информация о целевой аудитории и об описываемом периоде
Большая часть новых полей логически совместима со стандартами RUSMARC и USMARC

== Файл с текстом книги ==
Пример можно найти в примере fb3-документа, в файле /fb3/body.xml, где большинство новинок проиллюстрированы примерами применения и комментариями. Основные нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width, border. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, родительский по отношению к p.
* Сноски более гибко типизируемые. Допускается "подсказывать" читалке, как следует отображать сноски, следует ли переоформлять номера сносок средствами читалки и какие сноски концевые и подстраничные.
* Сноски выделяются в отдельный узел notes, и оформляются не как секции, а новым тегом <note>

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''[Content_Types].xml'''
| -> Обязательный файл в архиве, содержит описание MIME-типов для всех размещенных в архиве файлов
|-
|    '''cover.jpg'''
| -> Обложка всей книги, для быстрого доступа программ-читалок
|-
|    '''_rels/.rels'''
| -> Обязательный xml-файл в архиве. В нем ссылки на обложку, файл(ы) мета-информации и прочее.
|-
|    '''fb3/description.xml'''
| -> Файл с мета-информацией
|-
|    '''fb3/_rels/description.xml.rels'''
| -> Файл со связями данной карточки книги - указывается обложка и файл с текстом книги
|-
|    '''fb3/body.xml'''
| -> Файл с текстом книги, сносками
|-
|    '''fb3/_rels/body.xml.rels'''
| -> Файл со связями текста книги - описываются все использованные картинки
|-
|    '''fb3/marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

FictionBook 3.0 beta - краткое описание

2008-07-05T14:15:07Z

Sclex: /* Пример содержимого fb3-архива: */ наглАднее -> наглЯднее

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Дата создания: 3 июля 2008 г.''

== Общая информация о структуре fb3-файла ==
# Файл fb3 представляет собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib).
# Все файлы внутри архива имеют латинские имена в нижнем регистре.
# В корне архива ''может'' присутствовать ''один'' из файлов cover.png/cover.jpg, содержащий обложку документа для быстрого отображения. Размер этой картинки не больше, чем 240*240. Полноразмерная обложка может размещаться в другом файле (описывается в fb3_meta.xml, см. ниже).
# В корне архива ''обязательно присутствует'' файл fb3_book.xml, содержащий описание и структуру документа.
# В корне архива ''может присутствовать'' файл fb3_marks.xml, содержащий заметки/закладки.
# Все прочие файлы в архиве должны быть прямо или косвенно указаны в одном из перечисленных выше *.xml-файлов (например, каждая картинка должна быть использована в документе, если она попала в архив).
# Наличие в zip-архиве файлов (помимо указанных выше), не описанных в документе, является некритической ошибкой. При обработке файла о данной ошибке редактор должен обязательно выдавать предупреждение. Читалка должна игнорировать лишние файлы.
# Ссылки на отсутствующие файлы, используемые в документах, являются некритической ошибкой. И читалки, и редакторы должны выдавать сообщение об ошибке или иным образом ясно информировать пользователя о недостающих файлах.
# В качестве графических форматов будет поддерживаться gif/png/jpg

== .xml-файлы в архиве ==
'''fb3_meta.xml''' содержит:
* Метаинформация: название документа (пустое название недопустимо, редактор не должен позволять сохранять такой документ), авторы, жанр, etc. В основном повторяет дескрипшн fb2, со следующими отличиями:
** Упразднен src-title-info (информация библиографического характера будет отдельно обрабатываться, в книге ей делать нечего)
** Тег translator упраздняется
** Тег author в title-info получит новый атрибут role, который будет принимать значения author|translator|compiler|illustrator|editor. Тег translator упраздняется, соответственно.
** Добавлен необязательный book-sub-title для сложных заголовков.
** Новый тег quick-annotation для короткого (120 символов, к примеру) анонса
** Новый порядок тегов title-info:
**# coverpage
**# book-title
**# book-sub-title
**# sequence
**# author
**# genre
* Структура документа: дерево секций, объединенных.
** Оконечные (содержащие текст) секции будут храниться в отдельных файлах, которые описываются в виде атрибута xlink:href.
** Для всех секций возможно указание обложки, картинки, title, subtitle, id.

'''text#.xml''' ? множественные файлы с текстом секций. Аналогичны содержимому оконечных секций в fb2 с небольшими расширениями. Имена и размещение файлов в архиве не оговаривается, но все они должны быть корректно адресованы через атрибут xlink:href секций в файле fb3_meta.xml. Нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width. Возможно, с разрешенной вложенностью. Возможно, с бордерами. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, аналог p.
* Картинки больше не хранятся в XML, лежат в архиве, отдельно.
* Сноски будут типизированные. Выделяются концевые и подстраничные. Читалке желательно отображать сноски соответственно.
* Сноски выделяются в отдельный section (или в несколько), и отделяются друг от друга не секциями, а новым тегом <note>

'''fb3_marks.xml''' содержит закладки ? указывается адрес закладки (с точностью до символа, отмечается начало выделения и конец), тип закладки (закладка, заметка, правка). Адресация с использованием xpointer, в закладке может содержаться текст, аналогичный содержимому секций.

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''fb3_meta.xml'''
| -> Обязательный файл в архиве, содержит метаинформацию и структуру
|-
|    '''cover.png'''
| -> Необязательный файл в архиве, содержит малоразмерную версию обложки
|-
|    '''text.dir'''
| -> Папка, в которой лежат тексты (могли лежать и в корне, но так нагляднее)
|-
|       '''part1.xml'''
| -> Первая секция (у нас всего две текстовых секции в тексте)
|-
|       '''part2.xml'''
| -> Вторая секция
|-
|    '''fb3_marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

FictionBook 3.0 beta - краткое описание

2008-07-05T14:00:19Z

Sclex: /* Пример содержимого fb3-архива: */ "Втораая" -Ю

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Дата создания: 3 июля 2008 г.''

== Общая информация о структуре fb3-файла ==
# Файл fb3 представляет собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib).
# Все файлы внутри архива имеют латинские имена в нижнем регистре.
# В корне архива ''может'' присутствовать ''один'' из файлов cover.png/cover.jpg, содержащий обложку документа для быстрого отображения. Размер этой картинки не больше, чем 240*240. Полноразмерная обложка может размещаться в другом файле (описывается в fb3_meta.xml, см. ниже).
# В корне архива ''обязательно присутствует'' файл fb3_book.xml, содержащий описание и структуру документа.
# В корне архива ''может присутствовать'' файл fb3_marks.xml, содержащий заметки/закладки.
# Все прочие файлы в архиве должны быть прямо или косвенно указаны в одном из перечисленных выше *.xml-файлов (например, каждая картинка должна быть использована в документе, если она попала в архив).
# Наличие в zip-архиве файлов (помимо указанных выше), не описанных в документе, является некритической ошибкой. При обработке файла о данной ошибке редактор должен обязательно выдавать предупреждение. Читалка должна игнорировать лишние файлы.
# Ссылки на отсутствующие файлы, используемые в документах, являются некритической ошибкой. И читалки, и редакторы должны выдавать сообщение об ошибке или иным образом ясно информировать пользователя о недостающих файлах.
# В качестве графических форматов будет поддерживаться gif/png/jpg

== .xml-файлы в архиве ==
'''fb3_meta.xml''' содержит:
* Метаинформация: название документа (пустое название недопустимо, редактор не должен позволять сохранять такой документ), авторы, жанр, etc. В основном повторяет дескрипшн fb2, со следующими отличиями:
** Упразднен src-title-info (информация библиографического характера будет отдельно обрабатываться, в книге ей делать нечего)
** Тег translator упраздняется
** Тег author в title-info получит новый атрибут role, который будет принимать значения author|translator|compiler|illustrator|editor. Тег translator упраздняется, соответственно.
** Добавлен необязательный book-sub-title для сложных заголовков.
** Новый тег quick-annotation для короткого (120 символов, к примеру) анонса
** Новый порядок тегов title-info:
**# coverpage
**# book-title
**# book-sub-title
**# sequence
**# author
**# genre
* Структура документа: дерево секций, объединенных.
** Оконечные (содержащие текст) секции будут храниться в отдельных файлах, которые описываются в виде атрибута xlink:href.
** Для всех секций возможно указание обложки, картинки, title, subtitle, id.

'''text#.xml''' ? множественные файлы с текстом секций. Аналогичны содержимому оконечных секций в fb2 с небольшими расширениями. Имена и размещение файлов в архиве не оговаривается, но все они должны быть корректно адресованы через атрибут xlink:href секций в файле fb3_meta.xml. Нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width. Возможно, с разрешенной вложенностью. Возможно, с бордерами. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, аналог p.
* Картинки больше не хранятся в XML, лежат в архиве, отдельно.
* Сноски будут типизированные. Выделяются концевые и подстраничные. Читалке желательно отображать сноски соответственно.
* Сноски выделяются в отдельный section (или в несколько), и отделяются друг от друга не секциями, а новым тегом <note>

'''fb3_marks.xml''' содержит закладки ? указывается адрес закладки (с точностью до символа, отмечается начало выделения и конец), тип закладки (закладка, заметка, правка). Адресация с использованием xpointer, в закладке может содержаться текст, аналогичный содержимому секций.

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''fb3_meta.xml'''
| -> Обязательный файл в архиве, содержит метаинформацию и структуру
|-
|    '''cover.png'''
| -> Необязательный файл в архиве, содержит малоразмерную версию обложки
|-
|    '''text.dir'''
| -> Папка, в которой лежат тексты (могли лежать и в корне, но так нагладнее)
|-
|       '''part1.xml'''
| -> Первая секция (у нас всего две текстовых секции в тексте)
|-
|       '''part2.xml'''
| -> Вторая секция
|-
|    '''fb3_marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

FictionBook 3.0 beta - краткое описание

2008-07-05T13:46:13Z

Sclex: /* .xml-файлы в архиве */

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Дата создания: 3 июля 2008 г.''

== Общая информация о структуре fb3-файла ==
# Файл fb3 представляет собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib).
# Все файлы внутри архива имеют латинские имена в нижнем регистре.
# В корне архива ''может'' присутствовать ''один'' из файлов cover.png/cover.jpg, содержащий обложку документа для быстрого отображения. Размер этой картинки не больше, чем 240*240. Полноразмерная обложка может размещаться в другом файле (описывается в fb3_meta.xml, см. ниже).
# В корне архива ''обязательно присутствует'' файл fb3_book.xml, содержащий описание и структуру документа.
# В корне архива ''может присутствовать'' файл fb3_marks.xml, содержащий заметки/закладки.
# Все прочие файлы в архиве должны быть прямо или косвенно указаны в одном из перечисленных выше *.xml-файлов (например, каждая картинка должна быть использована в документе, если она попала в архив).
# Наличие в zip-архиве файлов (помимо указанных выше), не описанных в документе, является некритической ошибкой. При обработке файла о данной ошибке редактор должен обязательно выдавать предупреждение. Читалка должна игнорировать лишние файлы.
# Ссылки на отсутствующие файлы, используемые в документах, являются некритической ошибкой. И читалки, и редакторы должны выдавать сообщение об ошибке или иным образом ясно информировать пользователя о недостающих файлах.
# В качестве графических форматов будет поддерживаться gif/png/jpg

== .xml-файлы в архиве ==
'''fb3_meta.xml''' содержит:
* Метаинформация: название документа (пустое название недопустимо, редактор не должен позволять сохранять такой документ), авторы, жанр, etc. В основном повторяет дескрипшн fb2, со следующими отличиями:
** Упразднен src-title-info (информация библиографического характера будет отдельно обрабатываться, в книге ей делать нечего)
** Тег translator упраздняется
** Тег author в title-info получит новый атрибут role, который будет принимать значения author|translator|compiler|illustrator|editor. Тег translator упраздняется, соответственно.
** Добавлен необязательный book-sub-title для сложных заголовков.
** Новый тег quick-annotation для короткого (120 символов, к примеру) анонса
** Новый порядок тегов title-info:
**# coverpage
**# book-title
**# book-sub-title
**# sequence
**# author
**# genre
* Структура документа: дерево секций, объединенных.
** Оконечные (содержащие текст) секции будут храниться в отдельных файлах, которые описываются в виде атрибута xlink:href.
** Для всех секций возможно указание обложки, картинки, title, subtitle, id.

'''text#.xml''' ? множественные файлы с текстом секций. Аналогичны содержимому оконечных секций в fb2 с небольшими расширениями. Имена и размещение файлов в архиве не оговаривается, но все они должны быть корректно адресованы через атрибут xlink:href секций в файле fb3_meta.xml. Нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width. Возможно, с разрешенной вложенностью. Возможно, с бордерами. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, аналог p.
* Картинки больше не хранятся в XML, лежат в архиве, отдельно.
* Сноски будут типизированные. Выделяются концевые и подстраничные. Читалке желательно отображать сноски соответственно.
* Сноски выделяются в отдельный section (или в несколько), и отделяются друг от друга не секциями, а новым тегом <note>

'''fb3_marks.xml''' содержит закладки ? указывается адрес закладки (с точностью до символа, отмечается начало выделения и конец), тип закладки (закладка, заметка, правка). Адресация с использованием xpointer, в закладке может содержаться текст, аналогичный содержимому секций.

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''fb3_meta.xml'''
| -> Обязательный файл в архиве, содержит метаинформацию и структуру
|-
|    '''cover.png'''
| -> Необязательный файл в архиве, содержит малоразмерную версию обложки
|-
|    '''text.dir'''
| -> Папка, в которой лежат тексты (могли лежать и в корне, но так нагладнее)
|-
|       '''part1.xml'''
| -> Первая секция (у нас всего две текстовых секции в тексте)
|-
|       '''part2.xml'''
| -> Втораая секция
|-
|    '''fb3_marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

FictionBook 3.0 beta - краткое описание

2008-07-05T13:29:41Z

Sclex: /* .xml-файлы в архиве */ вынес слово "секции" из скобок

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Дата создания: 3 июля 2008 г.''

== Общая информация о структуре fb3-файла ==
# Файл fb3 представляет собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib).
# Все файлы внутри архива имеют латинские имена в нижнем регистре.
# В корне архива ''может'' присутствовать ''один'' из файлов cover.png/cover.jpg, содержащий обложку документа для быстрого отображения. Размер этой картинки не больше, чем 240*240. Полноразмерная обложка может размещаться в другом файле (описывается в fb3_meta.xml, см. ниже).
# В корне архива ''обязательно присутствует'' файл fb3_book.xml, содержащий описание и структуру документа.
# В корне архива ''может присутствовать'' файл fb3_marks.xml, содержащий заметки/закладки.
# Все прочие файлы в архиве должны быть прямо или косвенно указаны в одном из перечисленных выше *.xml-файлов (например, каждая картинка должна быть использована в документе, если она попала в архив).
# Наличие в zip-архиве файлов (помимо указанных выше), не описанных в документе, является некритической ошибкой. При обработке файла о данной ошибке редактор должен обязательно выдавать предупреждение. Читалка должна игнорировать лишние файлы.
# Ссылки на отсутствующие файлы, используемые в документах, являются некритической ошибкой. И читалки, и редакторы должны выдавать сообщение об ошибке или иным образом ясно информировать пользователя о недостающих файлах.
# В качестве графических форматов будет поддерживаться gif/png/jpg

== .xml-файлы в архиве ==
'''fb3_meta.xml''' содержит:
* Метаинформация: название документа (пустое название недопустимо, редактор не должен позволять сохранять такой документ), авторы, жанр, etc. В основном повторяет дескрипшн fb2, со следующими отличиями:
** Упразднен src-title-info (иоформация библиографического характера будет отдельно обрабатываться, в книге ей делать нечего)
** Тег translator упраздняется
** Тег author в title-info получит новый атрибут role, который будет принимать значения author|translator|compiler|illustrator|editor. Тег translator упраздняется, соответственно.
** Добавлен необязательный book-sub-title для сложных заголовков.
** Новый тег quick-annotation для короткого (120 символов, к примеру) анонса
** Новый порядок тегов title-info:
**# coverpage
**# book-title
**# book-sub-title
**# sequence
**# author
**# genre
* Структура документа: дерево секций, объединенных.
** Оконечные (содержащие текст) секции будут храниться в отдельных файлах, которые описываются в виде атрибута xlink:href.
** Для всех секций возможно указание обложки, картинки, title, subtitle, id.

'''text#.xml''' ? множественные файлы с текстом секций. Аналогичны содержимому оконечных секций в fb2 с небольшими расширениями. Имена и размещение файлов в архиве не оговаривается, но все они должны быть корректно адресованы через атрибут xlink:href секций в файле fb3_meta.xml. Нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width. Возможно, с разрешенной вложенностью. Возможно, с бордерами. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, аналог p.
* Картинки больше не хранятся в XML, лежат в архиве, отдельно.
* Сноски будут типизированные. Выделяются концевые и подстраничные. Читалке желательно отображать сноски соответственно.
* Сноски выделяются в отдельный section (или в несколько), и отделяются друг от друга не секциями, а новым тегом <note>

'''fb3_marks.xml''' содержит закладки ? указывается адрес закладки (с точностью до символа, отмечается начало выделения и конец), тип закладки (закладка, заметка, правка). Адресация с использованием xpointer, в закладке может содержаться текст, аналогичный содержимому секций.

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''fb3_meta.xml'''
| -> Обязательный файл в архиве, содержит метаинформацию и структуру
|-
|    '''cover.png'''
| -> Необязательный файл в архиве, содержит малоразмерную версию обложки
|-
|    '''text.dir'''
| -> Папка, в которой лежат тексты (могли лежать и в корне, но так нагладнее)
|-
|       '''part1.xml'''
| -> Первая секция (у нас всего две текстовых секции в тексте)
|-
|       '''part2.xml'''
| -> Втораая секция
|-
|    '''fb3_marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

FictionBook 3.0 beta - краткое описание

2008-07-05T13:21:32Z

Sclex: /* Общая информация о структуре fb3-файла */ "может присутствует" заменил на "может присутствовать"

= Описание формата fb3 (предложение) =
''Ответственный: Грибов Д.П., grib@gribuser.ru''

''Дата создания: 3 июля 2008 г.''

== Общая информация о структуре fb3-файла ==
# Файл fb3 представляет собой стандартный zip-архив, допустимые методы сжатия - store (без компрессии) и deflate (совместимый с zlib).
# Все файлы внутри архива имеют латинские имена в нижнем регистре.
# В корне архива ''может'' присутствовать ''один'' из файлов cover.png/cover.jpg, содержащий обложку документа для быстрого отображения. Размер этой картинки не больше, чем 240*240. Полноразмерная обложка может размещаться в другом файле (описывается в fb3_meta.xml, см. ниже).
# В корне архива ''обязательно присутствует'' файл fb3_book.xml, содержащий описание и структуру документа.
# В корне архива ''может присутствовать'' файл fb3_marks.xml, содержащий заметки/закладки.
# Все прочие файлы в архиве должны быть прямо или косвенно указаны в одном из перечисленных выше *.xml-файлов (например, каждая картинка должна быть использована в документе, если она попала в архив).
# Наличие в zip-архиве файлов (помимо указанных выше), не описанных в документе, является некритической ошибкой. При обработке файла о данной ошибке редактор должен обязательно выдавать предупреждение. Читалка должна игнорировать лишние файлы.
# Ссылки на отсутствующие файлы, используемые в документах, являются некритической ошибкой. И читалки, и редакторы должны выдавать сообщение об ошибке или иным образом ясно информировать пользователя о недостающих файлах.
# В качестве графических форматов будет поддерживаться gif/png/jpg

== .xml-файлы в архиве ==
'''fb3_meta.xml''' содержит:
* Метаинформация: название документа (пустое название недопустимо, редактор не должен позволять сохранять такой документ), авторы, жанр, etc. В основном повторяет дескрипшн fb2, со следующими отличиями:
** Упразднен src-title-info (иоформация библиографического характера будет отдельно обрабатываться, в книге ей делать нечего)
** Тег translator упраздняется
** Тег author в title-info получит новый атрибут role, который будет принимать значения author|translator|compiler|illustrator|editor. Тег translator упраздняется, соответственно.
** Добавлен необязательный book-sub-title для сложных заголовков.
** Новый тег quick-annotation для короткого (120 символов, к примеру) анонса
** Новый порядок тегов title-info:
**# coverpage
**# book-title
**# book-sub-title
**# sequence
**# author
**# genre
* Структура документа: дерево секций, объединенных.
** Оконечные (содержащие текст секции) будут храниться в отдельных файлах, которые описываются в виде атрибута xlink:href.
** Для всех секций возможно указание обложки, картинки, title, subtitle, id.

'''text#.xml''' ? множественные файлы с текстом секций. Аналогичны содержимому оконечных секций в fb2 с небольшими расширениями. Имена и размещение файлов в архиве не оговаривается, но все они должны быть корректно адресованы через атрибут xlink:href секций в файле fb3_meta.xml. Нововведения по отношению к fb2:
* Нумерованные и ненумерованные списки
* Блоки, выпадающие из общего потока, с атрибутами float, align, width. Возможно, с разрешенной вложенностью. Возможно, с бордерами. К примеру <block float="left" width="40em" align="right"><p>тутатекст</p></block>.
* Убирается inline-элемент code, добавляется block-элемент code, аналог p.
* Картинки больше не хранятся в XML, лежат в архиве, отдельно.
* Сноски будут типизированные. Выделяются концевые и подстраничные. Читалке желательно отображать сноски соответственно.
* Сноски выделяются в отдельный section (или в несколько), и отделяются друг от друга не секциями, а новым тегом <note>

'''fb3_marks.xml''' содержит закладки ? указывается адрес закладки (с точностью до символа, отмечается начало выделения и конец), тип закладки (закладка, заметка, правка). Адресация с использованием xpointer, в закладке может содержаться текст, аналогичный содержимому секций.

== Пример содержимого fb3-архива: ==
{| border=0
|'''Book.fb3'''
| -> fb3-файл, де-факто ZIP-архив
|-
|    '''fb3_meta.xml'''
| -> Обязательный файл в архиве, содержит метаинформацию и структуру
|-
|    '''cover.png'''
| -> Необязательный файл в архиве, содержит малоразмерную версию обложки
|-
|    '''text.dir'''
| -> Папка, в которой лежат тексты (могли лежать и в корне, но так нагладнее)
|-
|       '''part1.xml'''
| -> Первая секция (у нас всего две текстовых секции в тексте)
|-
|       '''part2.xml'''
| -> Втораая секция
|-
|    '''fb3_marks.xml'''
| -> Заметки/закладки на полях (которые поставила программа-читалка?)
|}

Описание формата FB2 от Sclex

2008-01-01T21:25:14Z

Sclex: /* Степени и индексы */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===

FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''[[Элемент a|<a l:href=...>...</a>]]''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''[[Элемент a|<a xlink:href=...>...</a>]]'''. Аналогично и для ссылок в тэгах '''[[Элемент image|<image/>]]'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''[[Элемент description|<description>]]''' - который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''[[Элемент body|<body>]]''' - описывает тело документа. ''Одно или более вхождений''.
#'''[[Элемент binary|<binary>]]''' - содержит приложенные к файлу двоичные объекты - картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''[[Элемент description|<description>]]''' с '''[[Элемент body|<body>]]''', а остальное - по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''[[Элемент description|<description>]]''' состоит из перечисленных ниже частей в указанном порядке:

#'''[[Элемент title-info|<title-info>]]''' - данные о книге. ''Одно и только одно вхождение''.
#'''[[Элемент src-title-info|<src-title-info>]]''' - данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''[[Элемент document-info|<document-info>]]''' - информация об FB2-документе. ''Одно и только одно вхождение''.
#'''[[Элемент publish-info|<publish-info>]]''' - сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''[[Элемент custom-info|<custom-info>]]''' - произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''[[Элемент title-info|<title-info>]]''' и '''[[Элемент document-info|<document-info>]]''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо:</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо:</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''[[Элемент title-info|<title-info>]]''':

'''[[Элемент genre|<genre>]]''' - указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Одно или более вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''[[Элемент author|<author>]]''' - содержит информацию об авторе книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''[[Элемент book-title|<book-title>]]''' - описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо:".

'''[[Элемент annotation|<annotation>]]''' - аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''[[Элемент keywords|<keywords>]]''' - содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''[[Элемент date|<date>]]''' - хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''[[Элемент coverpage|<coverpage>]]''' - обложка книги. Внутри может содержать только тэг '''[[Элемент image|<image/>]]'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''[[Элемент lang|<lang>]]''' - сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''[[Элемент src-lang|<src-lang>]]''' - определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''[[Элемент lang|<lang>]]'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''[[Элемент translator|<translator>]]''' - информация о переводчике книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Любое число вхождений.''

'''[[Элемент sequence|<sequence>]]''' - сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) - название серии, и '''number''' (целое число) - порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии - вторая.

Внутри раздела '''[[Элемент document-info|<document-info>]]''':

'''[[Элемент author|<author>]]''' - содержит информацию об авторе документа. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''[[Элемент program-used|<program-used>]]''' - в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''[[Элемент date|<date>]]''' - хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''[[Элемент src-url|<src-url>]]''' - URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''[[Элемент src-ocr|<src-ocr>]]''' - автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''[[Элемент id|<id>]]''' - уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''[[Элемент version|<version>]]''' - версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае - 1.1.

'''[[Элемент history|<history>]]''' - история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''[[Элемент publish-info|<publish-info>]]''':

'''[[Элемент book-name|<book-name>]]''' - название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо:".

'''[[Элемент publisher|<publisher>]]''' - название издательства. ''От нуля до одного вхождений''. В примере - Молодая гвардия.

'''[[Элемент city|<city>]]''' - город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''[[Элемент year|<year>]]''' - год издания книги. ''От нуля до одного вхождений''. В нашем случае - 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''[[Элемент body|<body>]]''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''[[Элемент body|<body>]]''' могут идти в указанном порядке:

#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Раздел '''[[Элемент section|<section>]]'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''[[Элемент section|<section>]]'''.

Для раздела '''[[Элемент section|<section>]]''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''[[Элемент section|<section>]]''' состоит из следующих частей в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''[[Элемент annotation|<annotation>]]''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''[[Элемент section|<section>]]''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''[[Элемент p|<p>]]''', '''[[Элемент image|<image>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент table|<table>]]''' (''одно или более вхождений''), но первый тэг не может быть '''[[Элемент image|<image>]]'''.

Следовательно, обязательно наличие либо вложенного подраздела '''[[Элемент section|<section>]]''', либо форматированного текста с картинками.

Разделов '''[[Элемент body|<body>]]''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''[[Элемент body|<body>]]''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''[[Элемент section|<section>]]''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''[[Элемент section|<section>]]''' первого уровня, а главы - в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''[[Элемент section|<section>]]''' первого уровня, то есть в '''[[Элемент title|<title>]]''', относящемся к '''[[Элемент body|<body>]]'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент table|<table>]]'''. Также могут входить пустые строки - '''[[Элемент empty-line|<empty-line/>]]'''.

Тэг '''[[Элемент p|<p>]]''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''[[Элемент p|<p>]]''' может быть вложен в тэги '''[[Элемент title|<title>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент epigraph|<epigraph>]]''', '''[[Элемент annotation|<annotation>]]''', '''[[Элемент section|<section>]]'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''[[Элемент empty-line|<empty-line/>]]'''. Один такой тэг - одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''[[Элемент strong|<strong>]]''', а курсивный - тэгом '''[[Элемент emphasis|<emphasis>]]'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это - <emphasis>курсивным</emphasis>.</p></pre>

=== Верхние и нижние индексы ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста начертание как верхний или нижний индекс. Для нижних индексов (уменьшенные буквы внизу строки) используется выделение тэгом '''[[Элемент sub|<sub>]]''', а для верхних индексов (уменьшенные буквы вверху строки) - выделение тэгом '''[[Элемент sup|<sup>]]'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''[[Элемент strikethrough|<strikethrough>]]'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''[[Элемент code|<code>]]'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''[[Элемент title|<title>]]''', который содержит в себе форматированный текст. Тэг '''[[Элемент title|<title>]]''' как заголовок части книги может быть вложенным в тэги '''[[Элемент body|<body>]]''' и '''[[Элемент section|<section>]]''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''[[Элемент title|<title>]]''' могут быть вложены только тэги '''[[Элемент p|<p>]]''' и/или '''[[Элемент empty-line|<empty-line/>]]'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''[[Элемент title|<title>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент stanza|<stanza>]]'''.

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

Подзаголовки описываются тэгом '''[[Элемент subtitle|<subtitle>]]''', который содержит простой (неформатированный) текст. Тэг '''[[Элемент subtitle|<subtitle>]]''' может быть вложенным в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент stanza|<stanza>]]'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''[[Элемент poem|<poem>]]'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Строфы '''[[Элемент stanza|<stanza>]]'''. ''Одно или более вхождений''. Строфа '''[[Элемент stanza|<stanza>]]''' - это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''[[Элемент v|<v>]]''', который должен быть вложен в '''[[Элемент stanza|<stanza>]]'''. Кроме того в состав '''[[Элемент stanza|<stanza>]]''' могут входить тэги '''[[Элемент title|<title>]]''' (заголовок) и '''[[Элемент subtitle|<subtitle>]]''' (подзаголовок).
#Автор стихотворения '''[[Элемент text-author|<text-author>]]'''. ''Любое число вхождений''.
#Дата написания '''[[Элемент date|<date>]]'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''[[Элемент stanza|<stanza>]]''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''<br>
''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''<br>
''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''[[Элемент epigraph|<epigraph>]]''', который должен содержать внутри себя форматированный текст - тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''' (''любое число вхождений''), а затем автора текста '''[[Элемент text-author|<text-author>]]''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''[[Элемент epigraph|<epigraph>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''' и '''[[Элемент poem|<poem>]]'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''[[Элемент cite|<cite>]]''', который может содержать форматированный текст - вложенные тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''' (''любое число вхождений''), а затем автора цитаты '''[[Элемент text-author|<text-author>]]''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время - деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент epigraph|<epigraph>]]''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''[[Элемент text-author|<text-author>]]'''. Внутри cite и epigraph этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его (родительского тэга) закрытием. Внутри же poem тэг '''[[Элемент text-author|<text-author>]]''' може быть либо последний, либо предпоследний перед '''[[Элемент date|<date>]]''', как это описано в главе ?Стихи? данного описания. ''Допускается любое число вхождений тэга '''[[Элемент text-author|<text-author>]]'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''[[Элемент image|<image/>]]''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''[[Элемент image|<image/>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', и в этом случае он описывает просто картинку. Если же '''[[Элемент image|<image/>]]''' вложен в '''[[Элемент p|<p>]]''' или '''[[Элемент coverpage|<coverpage>]]''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''[[Элемент a|<a>]]''', который может быть вложен в абзацный тэг '''[[Элемент p|<p>]]'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Пример:

<pre><p>Об этом вы можете прочитать <a l:href="#n1">здесь</a>.</p></pre>

В этом примере текстом ссылки будет ?здесь?, а указывать она будет на элемент с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в главе "Раздел FictionBook".

Также тэг '''[[Элемент a|<a>]]''' может иметь атрибут '''type''', что используется при создании ссылок на примечания и описано в разделе "Примечания" данного описания.

=== Таблицы ===

Таблицы оформляются при помощи тэга '''[[Элемент table|<table>]]''', который может быть вложен в '''[[Элемент cite|<cite>]]''', '''[[Элемент section|<section>]]''' и/или '''[[Элемент annotation|<annotation>]]'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''[[Элемент table|<table>]]''' содержит вложенные тэги '''[[Элемент tr|<tr>...</tr>]]''', каждый '''[[Элемент tr|<tr>]]''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения '''"left"''' (по левому краю), '''"right"''' (по правому краю) или '''"center"''' (центрирование). По умолчанию используется значение '''"left"'''.

Тэг '''[[Элемент tr|<tr>]]''', в свою очередь, содержит вложенные тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' (''в любом количестве и порядке каждый''). '''[[Элемент th|<th>]]''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''[[Элемент tr|<tr>]]''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименному свойству тэга '''[[Элемент table|<table>]]'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''[[Элемент body|<body>]]''', поименнованном '''notes''', то есть описан он должен быть как '''[[Элемент body|<body name="notes">]]''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''[[Элемент section|<section>]]''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''[[Элемент binary|<binary>]]''', который идет в документе вслед за последним элементом '''[[Элемент body|<body>]]'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' - MIME-тип вложения. Содержанием элемента '''[[Элемент binary|<binary>]]''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''[[Элемент genre|<genre>]]''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==

Ниже приведены коды языков, которые можно прописывать в тэгах '''[[Элемент lang|<lang>]]''' и '''[[Элемент src-lang|<src-lang>]]'''.

Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2008-01-01T20:45:15Z

Sclex: /* Поля раздела description */ Количество вхождений для genre было описано неверно

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===

FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''[[Элемент a|<a l:href=...>...</a>]]''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''[[Элемент a|<a xlink:href=...>...</a>]]'''. Аналогично и для ссылок в тэгах '''[[Элемент image|<image/>]]'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''[[Элемент description|<description>]]''' - который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''[[Элемент body|<body>]]''' - описывает тело документа. ''Одно или более вхождений''.
#'''[[Элемент binary|<binary>]]''' - содержит приложенные к файлу двоичные объекты - картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''[[Элемент description|<description>]]''' с '''[[Элемент body|<body>]]''', а остальное - по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''[[Элемент description|<description>]]''' состоит из перечисленных ниже частей в указанном порядке:

#'''[[Элемент title-info|<title-info>]]''' - данные о книге. ''Одно и только одно вхождение''.
#'''[[Элемент src-title-info|<src-title-info>]]''' - данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''[[Элемент document-info|<document-info>]]''' - информация об FB2-документе. ''Одно и только одно вхождение''.
#'''[[Элемент publish-info|<publish-info>]]''' - сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''[[Элемент custom-info|<custom-info>]]''' - произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''[[Элемент title-info|<title-info>]]''' и '''[[Элемент document-info|<document-info>]]''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо:</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо:</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''[[Элемент title-info|<title-info>]]''':

'''[[Элемент genre|<genre>]]''' - указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Одно или более вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''[[Элемент author|<author>]]''' - содержит информацию об авторе книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''[[Элемент book-title|<book-title>]]''' - описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо:".

'''[[Элемент annotation|<annotation>]]''' - аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''[[Элемент keywords|<keywords>]]''' - содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''[[Элемент date|<date>]]''' - хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''[[Элемент coverpage|<coverpage>]]''' - обложка книги. Внутри может содержать только тэг '''[[Элемент image|<image/>]]'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''[[Элемент lang|<lang>]]''' - сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''[[Элемент src-lang|<src-lang>]]''' - определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''[[Элемент lang|<lang>]]'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''[[Элемент translator|<translator>]]''' - информация о переводчике книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Любое число вхождений.''

'''[[Элемент sequence|<sequence>]]''' - сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) - название серии, и '''number''' (целое число) - порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии - вторая.

Внутри раздела '''[[Элемент document-info|<document-info>]]''':

'''[[Элемент author|<author>]]''' - содержит информацию об авторе документа. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''[[Элемент program-used|<program-used>]]''' - в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''[[Элемент date|<date>]]''' - хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''[[Элемент src-url|<src-url>]]''' - URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''[[Элемент src-ocr|<src-ocr>]]''' - автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''[[Элемент id|<id>]]''' - уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''[[Элемент version|<version>]]''' - версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае - 1.1.

'''[[Элемент history|<history>]]''' - история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''[[Элемент publish-info|<publish-info>]]''':

'''[[Элемент book-name|<book-name>]]''' - название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо:".

'''[[Элемент publisher|<publisher>]]''' - название издательства. ''От нуля до одного вхождений''. В примере - Молодая гвардия.

'''[[Элемент city|<city>]]''' - город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''[[Элемент year|<year>]]''' - год издания книги. ''От нуля до одного вхождений''. В нашем случае - 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''[[Элемент body|<body>]]''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''[[Элемент body|<body>]]''' могут идти в указанном порядке:

#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Раздел '''[[Элемент section|<section>]]'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''[[Элемент section|<section>]]'''.

Для раздела '''[[Элемент section|<section>]]''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''[[Элемент section|<section>]]''' состоит из следующих частей в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''[[Элемент annotation|<annotation>]]''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''[[Элемент section|<section>]]''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''[[Элемент p|<p>]]''', '''[[Элемент image|<image>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент table|<table>]]''' (''одно или более вхождений''), но первый тэг не может быть '''[[Элемент image|<image>]]'''.

Следовательно, обязательно наличие либо вложенного подраздела '''[[Элемент section|<section>]]''', либо форматированного текста с картинками.

Разделов '''[[Элемент body|<body>]]''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''[[Элемент body|<body>]]''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''[[Элемент section|<section>]]''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''[[Элемент section|<section>]]''' первого уровня, а главы - в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''[[Элемент section|<section>]]''' первого уровня, то есть в '''[[Элемент title|<title>]]''', относящемся к '''[[Элемент body|<body>]]'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент table|<table>]]'''. Также могут входить пустые строки - '''[[Элемент empty-line|<empty-line/>]]'''.

Тэг '''[[Элемент p|<p>]]''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''[[Элемент p|<p>]]''' может быть вложен в тэги '''[[Элемент title|<title>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент epigraph|<epigraph>]]''', '''[[Элемент annotation|<annotation>]]''', '''[[Элемент section|<section>]]'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''[[Элемент empty-line|<empty-line/>]]'''. Один такой тэг - одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''[[Элемент strong|<strong>]]''', а курсивный - тэгом '''[[Элемент emphasis|<emphasis>]]'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это - <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''[[Элемент sub|<sub>]]''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''[[Элемент sup|<sup>]]'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''[[Элемент strikethrough|<strikethrough>]]'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''[[Элемент code|<code>]]'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''[[Элемент title|<title>]]''', который содержит в себе форматированный текст. Тэг '''[[Элемент title|<title>]]''' как заголовок части книги может быть вложенным в тэги '''[[Элемент body|<body>]]''' и '''[[Элемент section|<section>]]''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''[[Элемент title|<title>]]''' могут быть вложены только тэги '''[[Элемент p|<p>]]''' и/или '''[[Элемент empty-line|<empty-line/>]]'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''[[Элемент title|<title>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент stanza|<stanza>]]'''.

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

Подзаголовки описываются тэгом '''[[Элемент subtitle|<subtitle>]]''', который содержит простой (неформатированный) текст. Тэг '''[[Элемент subtitle|<subtitle>]]''' может быть вложенным в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент stanza|<stanza>]]'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''[[Элемент poem|<poem>]]'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Строфы '''[[Элемент stanza|<stanza>]]'''. ''Одно или более вхождений''. Строфа '''[[Элемент stanza|<stanza>]]''' - это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''[[Элемент v|<v>]]''', который должен быть вложен в '''[[Элемент stanza|<stanza>]]'''. Кроме того в состав '''[[Элемент stanza|<stanza>]]''' могут входить тэги '''[[Элемент title|<title>]]''' (заголовок) и '''[[Элемент subtitle|<subtitle>]]''' (подзаголовок).
#Автор стихотворения '''[[Элемент text-author|<text-author>]]'''. ''Любое число вхождений''.
#Дата написания '''[[Элемент date|<date>]]'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''[[Элемент stanza|<stanza>]]''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''<br>
''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''<br>
''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''[[Элемент epigraph|<epigraph>]]''', который должен содержать внутри себя форматированный текст - тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''' (''любое число вхождений''), а затем автора текста '''[[Элемент text-author|<text-author>]]''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''[[Элемент epigraph|<epigraph>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''' и '''[[Элемент poem|<poem>]]'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''[[Элемент cite|<cite>]]''', который может содержать форматированный текст - вложенные тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''' (''любое число вхождений''), а затем автора цитаты '''[[Элемент text-author|<text-author>]]''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время - деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент epigraph|<epigraph>]]''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''[[Элемент text-author|<text-author>]]'''. Внутри cite и epigraph этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его (родительского тэга) закрытием. Внутри же poem тэг '''[[Элемент text-author|<text-author>]]''' може быть либо последний, либо предпоследний перед '''[[Элемент date|<date>]]''', как это описано в главе ?Стихи? данного описания. ''Допускается любое число вхождений тэга '''[[Элемент text-author|<text-author>]]'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''[[Элемент image|<image/>]]''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''[[Элемент image|<image/>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', и в этом случае он описывает просто картинку. Если же '''[[Элемент image|<image/>]]''' вложен в '''[[Элемент p|<p>]]''' или '''[[Элемент coverpage|<coverpage>]]''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''[[Элемент a|<a>]]''', который может быть вложен в абзацный тэг '''[[Элемент p|<p>]]'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Пример:

<pre><p>Об этом вы можете прочитать <a l:href="#n1">здесь</a>.</p></pre>

В этом примере текстом ссылки будет ?здесь?, а указывать она будет на элемент с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в главе "Раздел FictionBook".

Также тэг '''[[Элемент a|<a>]]''' может иметь атрибут '''type''', что используется при создании ссылок на примечания и описано в разделе "Примечания" данного описания.

=== Таблицы ===

Таблицы оформляются при помощи тэга '''[[Элемент table|<table>]]''', который может быть вложен в '''[[Элемент cite|<cite>]]''', '''[[Элемент section|<section>]]''' и/или '''[[Элемент annotation|<annotation>]]'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''[[Элемент table|<table>]]''' содержит вложенные тэги '''[[Элемент tr|<tr>...</tr>]]''', каждый '''[[Элемент tr|<tr>]]''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения '''"left"''' (по левому краю), '''"right"''' (по правому краю) или '''"center"''' (центрирование). По умолчанию используется значение '''"left"'''.

Тэг '''[[Элемент tr|<tr>]]''', в свою очередь, содержит вложенные тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' (''в любом количестве и порядке каждый''). '''[[Элемент th|<th>]]''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''[[Элемент tr|<tr>]]''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименному свойству тэга '''[[Элемент table|<table>]]'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''[[Элемент body|<body>]]''', поименнованном '''notes''', то есть описан он должен быть как '''[[Элемент body|<body name="notes">]]''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''[[Элемент section|<section>]]''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''[[Элемент binary|<binary>]]''', который идет в документе вслед за последним элементом '''[[Элемент body|<body>]]'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' - MIME-тип вложения. Содержанием элемента '''[[Элемент binary|<binary>]]''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''[[Элемент genre|<genre>]]''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==

Ниже приведены коды языков, которые можно прописывать в тэгах '''[[Элемент lang|<lang>]]''' и '''[[Элемент src-lang|<src-lang>]]'''.

Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-04-23T22:23:02Z

Sclex: Поправил инфу, где может располагаться text-author внутри других тэгов

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===

FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''[[Элемент a|<a l:href=...>...</a>]]''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''[[Элемент a|<a xlink:href=...>...</a>]]'''. Аналогично и для ссылок в тэгах '''[[Элемент image|<image/>]]'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''[[Элемент description|<description>]]''' - который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''[[Элемент body|<body>]]''' - описывает тело документа. ''Одно или более вхождений''.
#'''[[Элемент binary|<binary>]]''' - содержит приложенные к файлу двоичные объекты - картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''[[Элемент description|<description>]]''' с '''[[Элемент body|<body>]]''', а остальное - по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''[[Элемент description|<description>]]''' состоит из перечисленных ниже частей в указанном порядке:

#'''[[Элемент title-info|<title-info>]]''' - данные о книге. ''Одно и только одно вхождение''.
#'''[[Элемент src-title-info|<src-title-info>]]''' - данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''[[Элемент document-info|<document-info>]]''' - информация об FB2-документе. ''Одно и только одно вхождение''.
#'''[[Элемент publish-info|<publish-info>]]''' - сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''[[Элемент custom-info|<custom-info>]]''' - произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''[[Элемент title-info|<title-info>]]''' и '''[[Элемент document-info|<document-info>]]''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо:</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо:</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''[[Элемент title-info|<title-info>]]''':

'''[[Элемент genre|<genre>]]''' - указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''[[Элемент author|<author>]]''' - содержит информацию об авторе книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''[[Элемент book-title|<book-title>]]''' - описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо:".

'''[[Элемент annotation|<annotation>]]''' - аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''[[Элемент keywords|<keywords>]]''' - содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''[[Элемент date|<date>]]''' - хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''[[Элемент coverpage|<coverpage>]]''' - обложка книги. Внутри может содержать только тэг '''[[Элемент image|<image/>]]'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''[[Элемент lang|<lang>]]''' - сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''[[Элемент src-lang|<src-lang>]]''' - определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''[[Элемент lang|<lang>]]'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''[[Элемент translator|<translator>]]''' - информация о переводчике книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Любое число вхождений.''

'''[[Элемент sequence|<sequence>]]''' - сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) - название серии, и '''number''' (целое число) - порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии - вторая.

Внутри раздела '''[[Элемент document-info|<document-info>]]''':

'''[[Элемент author|<author>]]''' - содержит информацию об авторе документа. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''[[Элемент program-used|<program-used>]]''' - в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''[[Элемент date|<date>]]''' - хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''[[Элемент src-url|<src-url>]]''' - URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''[[Элемент src-ocr|<src-ocr>]]''' - автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''[[Элемент id|<id>]]''' - уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''[[Элемент version|<version>]]''' - версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае - 1.1.

'''[[Элемент history|<history>]]''' - история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''[[Элемент publish-info|<publish-info>]]''':

'''[[Элемент book-name|<book-name>]]''' - название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо:".

'''[[Элемент publisher|<publisher>]]''' - название издательства. ''От нуля до одного вхождений''. В примере - Молодая гвардия.

'''[[Элемент city|<city>]]''' - город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''[[Элемент year|<year>]]''' - год издания книги. ''От нуля до одного вхождений''. В нашем случае - 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''[[Элемент body|<body>]]''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''[[Элемент body|<body>]]''' могут идти в указанном порядке:

#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Раздел '''[[Элемент section|<section>]]'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''[[Элемент section|<section>]]'''.

Для раздела '''[[Элемент section|<section>]]''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''[[Элемент section|<section>]]''' состоит из следующих частей в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''[[Элемент annotation|<annotation>]]''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''[[Элемент section|<section>]]''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''[[Элемент p|<p>]]''', '''[[Элемент image|<image>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент table|<table>]]''' (''одно или более вхождений''), но первый тэг не может быть '''[[Элемент image|<image>]]'''.

Следовательно, обязательно наличие либо вложенного подраздела '''[[Элемент section|<section>]]''', либо форматированного текста с картинками.

Разделов '''[[Элемент body|<body>]]''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''[[Элемент body|<body>]]''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''[[Элемент section|<section>]]''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''[[Элемент section|<section>]]''' первого уровня, а главы - в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''[[Элемент section|<section>]]''' первого уровня, то есть в '''[[Элемент title|<title>]]''', относящемся к '''[[Элемент body|<body>]]'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент table|<table>]]'''. Также могут входить пустые строки - '''[[Элемент empty-line|<empty-line/>]]'''.

Тэг '''[[Элемент p|<p>]]''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''[[Элемент p|<p>]]''' может быть вложен в тэги '''[[Элемент title|<title>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент epigraph|<epigraph>]]''', '''[[Элемент annotation|<annotation>]]''', '''[[Элемент section|<section>]]'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''[[Элемент empty-line|<empty-line/>]]'''. Один такой тэг - одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''[[Элемент strong|<strong>]]''', а курсивный - тэгом '''[[Элемент emphasis|<emphasis>]]'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это - <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''[[Элемент sub|<sub>]]''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''[[Элемент sup|<sup>]]'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''[[Элемент strikethrough|<strikethrough>]]'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''[[Элемент code|<code>]]'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''[[Элемент title|<title>]]''', который содержит в себе форматированный текст. Тэг '''[[Элемент title|<title>]]''' как заголовок части книги может быть вложенным в тэги '''[[Элемент body|<body>]]''' и '''[[Элемент section|<section>]]''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''[[Элемент title|<title>]]''' могут быть вложены только тэги '''[[Элемент p|<p>]]''' и/или '''[[Элемент empty-line|<empty-line/>]]'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''[[Элемент title|<title>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент stanza|<stanza>]]'''.

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

Подзаголовки описываются тэгом '''[[Элемент subtitle|<subtitle>]]''', который содержит простой (неформатированный) текст. Тэг '''[[Элемент subtitle|<subtitle>]]''' может быть вложенным в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент stanza|<stanza>]]'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''[[Элемент poem|<poem>]]'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Строфы '''[[Элемент stanza|<stanza>]]'''. ''Одно или более вхождений''. Строфа '''[[Элемент stanza|<stanza>]]''' - это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''[[Элемент v|<v>]]''', который должен быть вложен в '''[[Элемент stanza|<stanza>]]'''. Кроме того в состав '''[[Элемент stanza|<stanza>]]''' могут входить тэги '''[[Элемент title|<title>]]''' (заголовок) и '''[[Элемент subtitle|<subtitle>]]''' (подзаголовок).
#Автор стихотворения '''[[Элемент text-author|<text-author>]]'''. ''Любое число вхождений''.
#Дата написания '''[[Элемент date|<date>]]'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''[[Элемент stanza|<stanza>]]''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''<br>
''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''<br>
''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''[[Элемент epigraph|<epigraph>]]''', который должен содержать внутри себя форматированный текст - тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''' (''любое число вхождений''), а затем автора текста '''[[Элемент text-author|<text-author>]]''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''[[Элемент epigraph|<epigraph>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''' и '''[[Элемент poem|<poem>]]'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''[[Элемент cite|<cite>]]''', который может содержать форматированный текст - вложенные тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''' (''любое число вхождений''), а затем автора цитаты '''[[Элемент text-author|<text-author>]]''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время - деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент epigraph|<epigraph>]]''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''[[Элемент text-author|<text-author>]]'''. Внутри cite и epigraph этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его (родительского тэга) закрытием. Внутри же poem тэг '''[[Элемент text-author|<text-author>]]''' може быть либо последний, либо предпоследний перед '''[[Элемент date|<date>]]''', как это описано в главе ?Стихи? данного описания. ''Допускается любое число вхождений тэга '''[[Элемент text-author|<text-author>]]'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''[[Элемент image|<image/>]]''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''[[Элемент image|<image/>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', и в этом случае он описывает просто картинку. Если же '''[[Элемент image|<image/>]]''' вложен в '''[[Элемент p|<p>]]''' или '''[[Элемент coverpage|<coverpage>]]''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''[[Элемент a|<a>]]''', который может быть вложен в абзацный тэг '''[[Элемент p|<p>]]'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Пример:

<pre><p>Об этом вы можете прочитать <a l:href="#n1">здесь</a>.</p></pre>

В этом примере текстом ссылки будет ?здесь?, а указывать она будет на элемент с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в главе "Раздел FictionBook".

Также тэг '''[[Элемент a|<a>]]''' может иметь атрибут '''type''', что используется при создании ссылок на примечания и описано в разделе "Примечания" данного описания.

=== Таблицы ===

Таблицы оформляются при помощи тэга '''[[Элемент table|<table>]]''', который может быть вложен в '''[[Элемент cite|<cite>]]''', '''[[Элемент section|<section>]]''' и/или '''[[Элемент annotation|<annotation>]]'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''[[Элемент table|<table>]]''' содержит вложенные тэги '''[[Элемент tr|<tr>...</tr>]]''', каждый '''[[Элемент tr|<tr>]]''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения '''"left"''' (по левому краю), '''"right"''' (по правому краю) или '''"center"''' (центрирование). По умолчанию используется значение '''"left"'''.

Тэг '''[[Элемент tr|<tr>]]''', в свою очередь, содержит вложенные тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' (''в любом количестве и порядке каждый''). '''[[Элемент th|<th>]]''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''[[Элемент tr|<tr>]]''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименному свойству тэга '''[[Элемент table|<table>]]'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''[[Элемент body|<body>]]''', поименнованном '''notes''', то есть описан он должен быть как '''[[Элемент body|<body name="notes">]]''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''[[Элемент section|<section>]]''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''[[Элемент binary|<binary>]]''', который идет в документе вслед за последним элементом '''[[Элемент body|<body>]]'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' - MIME-тип вложения. Содержанием элемента '''[[Элемент binary|<binary>]]''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''[[Элемент genre|<genre>]]''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==

Ниже приведены коды языков, которые можно прописывать в тэгах '''[[Элемент lang|<lang>]]''' и '''[[Элемент src-lang|<src-lang>]]'''.

Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-04-23T22:11:13Z

Sclex: Дописал, что image может быть вложен в coverpage и тогда считается за инлайн-картинку

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===

FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''[[Элемент a|<a l:href=...>...</a>]]''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''[[Элемент a|<a xlink:href=...>...</a>]]'''. Аналогично и для ссылок в тэгах '''[[Элемент image|<image/>]]'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''[[Элемент description|<description>]]''' - который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''[[Элемент body|<body>]]''' - описывает тело документа. ''Одно или более вхождений''.
#'''[[Элемент binary|<binary>]]''' - содержит приложенные к файлу двоичные объекты - картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''[[Элемент description|<description>]]''' с '''[[Элемент body|<body>]]''', а остальное - по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''[[Элемент description|<description>]]''' состоит из перечисленных ниже частей в указанном порядке:

#'''[[Элемент title-info|<title-info>]]''' - данные о книге. ''Одно и только одно вхождение''.
#'''[[Элемент src-title-info|<src-title-info>]]''' - данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''[[Элемент document-info|<document-info>]]''' - информация об FB2-документе. ''Одно и только одно вхождение''.
#'''[[Элемент publish-info|<publish-info>]]''' - сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''[[Элемент custom-info|<custom-info>]]''' - произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''[[Элемент title-info|<title-info>]]''' и '''[[Элемент document-info|<document-info>]]''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо:</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо:</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''[[Элемент title-info|<title-info>]]''':

'''[[Элемент genre|<genre>]]''' - указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''[[Элемент author|<author>]]''' - содержит информацию об авторе книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''[[Элемент book-title|<book-title>]]''' - описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо:".

'''[[Элемент annotation|<annotation>]]''' - аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''[[Элемент keywords|<keywords>]]''' - содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''[[Элемент date|<date>]]''' - хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''[[Элемент coverpage|<coverpage>]]''' - обложка книги. Внутри может содержать только тэг '''[[Элемент image|<image/>]]'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''[[Элемент lang|<lang>]]''' - сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''[[Элемент src-lang|<src-lang>]]''' - определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''[[Элемент lang|<lang>]]'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''[[Элемент translator|<translator>]]''' - информация о переводчике книги. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Любое число вхождений.''

'''[[Элемент sequence|<sequence>]]''' - сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) - название серии, и '''number''' (целое число) - порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии - вторая.

Внутри раздела '''[[Элемент document-info|<document-info>]]''':

'''[[Элемент author|<author>]]''' - содержит информацию об авторе документа. Возможны такие вложенные тэги как '''[[Элемент first-name|<first-name>]]''' - имя, '''[[Элемент last-name|<last-name>]]''' - фамилия, '''[[Элемент middle-name|<middle-name>]]''' - отчество, '''[[Элемент nickname|<nickname>]]''' - ник, и '''[[Элемент email|<email>]]''' - адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''[[Элемент program-used|<program-used>]]''' - в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''[[Элемент date|<date>]]''' - хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''[[Элемент src-url|<src-url>]]''' - URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''[[Элемент src-ocr|<src-ocr>]]''' - автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''[[Элемент id|<id>]]''' - уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''[[Элемент version|<version>]]''' - версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае - 1.1.

'''[[Элемент history|<history>]]''' - история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''', '''[[Элемент empty-line|<empty-line/>]]''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''[[Элемент publish-info|<publish-info>]]''':

'''[[Элемент book-name|<book-name>]]''' - название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо:".

'''[[Элемент publisher|<publisher>]]''' - название издательства. ''От нуля до одного вхождений''. В примере - Молодая гвардия.

'''[[Элемент city|<city>]]''' - город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''[[Элемент year|<year>]]''' - год издания книги. ''От нуля до одного вхождений''. В нашем случае - 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''[[Элемент body|<body>]]''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''[[Элемент body|<body>]]''' могут идти в указанном порядке:

#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Раздел '''[[Элемент section|<section>]]'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''[[Элемент section|<section>]]'''.

Для раздела '''[[Элемент section|<section>]]''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''[[Элемент section|<section>]]''' состоит из следующих частей в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Картинка '''[[Элемент image|<image/>]]''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''[[Элемент annotation|<annotation>]]''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''[[Элемент section|<section>]]''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''[[Элемент p|<p>]]''', '''[[Элемент image|<image>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент table|<table>]]''' (''одно или более вхождений''), но первый тэг не может быть '''[[Элемент image|<image>]]'''.

Следовательно, обязательно наличие либо вложенного подраздела '''[[Элемент section|<section>]]''', либо форматированного текста с картинками.

Разделов '''[[Элемент body|<body>]]''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''[[Элемент body|<body>]]''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''[[Элемент section|<section>]]''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''[[Элемент section|<section>]]''' первого уровня, а главы - в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''[[Элемент section|<section>]]''' первого уровня, то есть в '''[[Элемент title|<title>]]''', относящемся к '''[[Элемент body|<body>]]'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент table|<table>]]'''. Также могут входить пустые строки - '''[[Элемент empty-line|<empty-line/>]]'''.

Тэг '''[[Элемент p|<p>]]''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''[[Элемент p|<p>]]''' может быть вложен в тэги '''[[Элемент title|<title>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент epigraph|<epigraph>]]''', '''[[Элемент annotation|<annotation>]]''', '''[[Элемент section|<section>]]'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''[[Элемент empty-line|<empty-line/>]]'''. Один такой тэг - одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''[[Элемент strong|<strong>]]''', а курсивный - тэгом '''[[Элемент emphasis|<emphasis>]]'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это - <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''[[Элемент sub|<sub>]]''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''[[Элемент sup|<sup>]]'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''[[Элемент strikethrough|<strikethrough>]]'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''[[Элемент p|<p>]]''', '''[[Элемент v|<v>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент text-author|<text-author>]]''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''[[Элемент code|<code>]]'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''[[Элемент title|<title>]]''', который содержит в себе форматированный текст. Тэг '''[[Элемент title|<title>]]''' как заголовок части книги может быть вложенным в тэги '''[[Элемент body|<body>]]''' и '''[[Элемент section|<section>]]''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''[[Элемент title|<title>]]''' могут быть вложены только тэги '''[[Элемент p|<p>]]''' и/или '''[[Элемент empty-line|<empty-line/>]]'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''[[Элемент title|<title>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент stanza|<stanza>]]'''.

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

Подзаголовки описываются тэгом '''[[Элемент subtitle|<subtitle>]]''', который содержит простой (неформатированный) текст. Тэг '''[[Элемент subtitle|<subtitle>]]''' может быть вложенным в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент stanza|<stanza>]]'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''[[Элемент poem|<poem>]]'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''[[Элемент title|<title>]]'''. ''От нуля до одного вхождений''.
#Эпиграф '''[[Элемент epigraph|<epigraph>]]'''. ''Любое число вхождений''.
#Строфы '''[[Элемент stanza|<stanza>]]'''. ''Одно или более вхождений''. Строфа '''[[Элемент stanza|<stanza>]]''' - это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''[[Элемент v|<v>]]''', который должен быть вложен в '''[[Элемент stanza|<stanza>]]'''. Кроме того в состав '''[[Элемент stanza|<stanza>]]''' могут входить тэги '''[[Элемент title|<title>]]''' (заголовок) и '''[[Элемент subtitle|<subtitle>]]''' (подзаголовок).
#Автор стихотворения '''[[Элемент text-author|<text-author>]]'''. ''Любое число вхождений''.
#Дата написания '''[[Элемент date|<date>]]'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''[[Элемент stanza|<stanza>]]''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''<br>
''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''<br>
''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''[[Элемент epigraph|<epigraph>]]''', который должен содержать внутри себя форматированный текст - тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''', '''[[Элемент empty-line|<empty-line/>]]''' (''любое число вхождений''), а затем автора текста '''[[Элемент text-author|<text-author>]]''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''[[Элемент epigraph|<epigraph>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''' и '''[[Элемент poem|<poem>]]'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''[[Элемент cite|<cite>]]''', который может содержать форматированный текст - вложенные тэги '''[[Элемент p|<p>]]''', '''[[Элемент poem|<poem>]]''', '''[[Элемент empty-line|<empty-line/>]]''', '''[[Элемент subtitle|<subtitle>]]''', '''[[Элемент table|<table>]]''' (''любое число вхождений''), а затем автора цитаты '''[[Элемент text-author|<text-author>]]''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время - деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''[[Элемент poem|<poem>]]''', '''[[Элемент cite|<cite>]]''' и '''[[Элемент epigraph|<epigraph>]]''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''[[Элемент text-author|<text-author>]]'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''[[Элемент text-author|<text-author>]]'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''[[Элемент image|<image/>]]''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''[[Элемент image|<image/>]]''' может быть вложен в тэги '''[[Элемент body|<body>]]''', '''[[Элемент section|<section>]]''', и в этом случае он описывает просто картинку. Если же '''[[Элемент image|<image/>]]''' вложен в '''[[Элемент p|<p>]]''' или '''[[Элемент coverpage|<coverpage>]]''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''[[Элемент a|<a>]]''', который может быть вложен в абзацный тэг '''[[Элемент p|<p>]]'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Пример:

<pre><p>Об этом вы можете прочитать <a l:href="#n1">здесь</a>.</p></pre>

В этом примере текстом ссылки будет ?здесь?, а указывать она будет на элемент с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в главе "Раздел FictionBook".

Также тэг '''[[Элемент a|<a>]]''' может иметь атрибут '''type''', что используется при создании ссылок на примечания и описано в разделе "Примечания" данного описания.

=== Таблицы ===

Таблицы оформляются при помощи тэга '''[[Элемент table|<table>]]''', который может быть вложен в '''[[Элемент cite|<cite>]]''', '''[[Элемент section|<section>]]''' и/или '''[[Элемент annotation|<annotation>]]'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''[[Элемент table|<table>]]''' содержит вложенные тэги '''[[Элемент tr|<tr>...</tr>]]''', каждый '''[[Элемент tr|<tr>]]''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения '''"left"''' (по левому краю), '''"right"''' (по правому краю) или '''"center"''' (центрирование). По умолчанию используется значение '''"left"'''.

Тэг '''[[Элемент tr|<tr>]]''', в свою очередь, содержит вложенные тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' (''в любом количестве и порядке каждый''). '''[[Элемент th|<th>]]''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''[[Элемент tr|<tr>]]''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''[[Элемент th|<th>]]''' и '''[[Элемент td|<td>]]''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименному свойству тэга '''[[Элемент table|<table>]]'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''[[Элемент body|<body>]]''', поименнованном '''notes''', то есть описан он должен быть как '''[[Элемент body|<body name="notes">]]''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''[[Элемент section|<section>]]''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''[[Элемент binary|<binary>]]''', который идет в документе вслед за последним элементом '''[[Элемент body|<body>]]'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' - MIME-тип вложения. Содержанием элемента '''[[Элемент binary|<binary>]]''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''[[Элемент genre|<genre>]]''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==

Ниже приведены коды языков, которые можно прописывать в тэгах '''[[Элемент lang|<lang>]]''' и '''[[Элемент src-lang|<src-lang>]]'''.

Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-10T11:01:56Z

Sclex: /* Ссылки */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>'''.

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<nowiki><a></nowiki>''', который может быть вложен в абзацный тэг '''<nowiki><p></nowiki>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Пример:

<pre><p>Об этом вы можете прочитать <a l:href="#n1">здесь</a>.</p></pre>

В этом примере текстом ссылки будет ?здесь?, а указывать она будет на элемент с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в главе "Раздел FictionBook".

Также тэг '''<nowiki><a></nowiki>''' может иметь атрибут '''type''', что используется при создании ссылок на примечания и описано в разделе "Примечания" данного описания.

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименному свойству тэга '''<nowiki><table></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-10T10:51:03Z

Sclex: /* Ссылки */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>'''.

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<nowiki><a></nowiki>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на элемент с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в главе "Раздел FictionBook".

Также тэг '''<nowiki><a></nowiki>''' может иметь атрибут '''type''', что используется при создании ссылок на примечания и описано в разделе "Примечания".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименному свойству тэга '''<nowiki><table></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-10T10:46:06Z

Sclex: /* Таблицы */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>'''.

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименному свойству тэга '''<nowiki><table></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-10T10:44:45Z

Sclex: /* Таблицы */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>'''.

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка, что позволяет "растягивать" ее по вертикали или горизонтали. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-10T10:43:17Z

Sclex: /* Таблицы */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>'''.

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для ячейки (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-10T10:42:41Z

Sclex: /* Таблицы */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>'''.

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на ячейку можно сослаться. Атрибут '''style''' назначает стиль оформления для таблицы (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Как сделать книгу

2007-02-07T00:58:17Z

Sclex: не забудьДе

Чтобы сделать действительно хорошую книгу, которой не стыдно было бы поделиться с другими (а для частного использования достаточно установить [http://www.the-ebook.org/e107/content.php?article.63 BookDesigner] и/или [http://www.gribuser.ru/xml/fictionbook/2.0/software/Any2FB2.exe Any to FB2] и совершенно не нужно читать этот документ), придётся приложить некоторые усилия.

Хорошей книгой считается валидная книга с грамотно выделенными сносками, стихами, эпиграфами, другим форматированием и имеющая полнокровный заголовок (имя переводчика, обложка, etc.)

== Общая последовательность действий ==

*Получение первичного fb2 из txt|doc|html|etc.
**Программы для создания fb2
**Простой импорт с использованием Any2FB
*Доработка тела документа
**Удаление контейнеров
**Корректировка fb2, выделение стихов и т.п.
**Оформление сносок <small>(инструкция пока не готова, но Any2FB сразу создает нормальные сноски из сносок вида [текст сноски])</small>
*Заполнение заголовка
*Работа с xml-исходником
*Чего НЕТ в этом документ

=== Получение первичного fb2 ===
Этот этап требует наибольшей сноровки. Тут вам могут пригодиться следующие программы:

*[http://www.the-ebook.org/e107/content.php?article.63 BookDesigner] (и его клон [http://www.the-ebook.org/e107/content.php?article.92 Fiction Book Designer])- монстроподобный и не очень эстетичный инструментище. Среди его неоспоримых достоинств - уникальная в своем роде всеядность. Он может достаточно корректно распознать многие экзотически изуродованные тексты, читает всеразличные prc, pdf и даже lit (для этого, впрочем, придется пошаманить). Последняя версия включает достаточно удобный fb2 section editor и умеет работать с регулярными выражениями. Снабжен справкой. Неплохой выбор для начинающих, полезный инструмент в руках мастера. Лично я его на дух не переношу (GribUser).
*[http://www.gribuser.ru/xml/fictionbook/2.0/software/Any2FB2.exe Any to FB2] - не столь всеядный, но куда более легковесный и немного более управляемый инструмент. Замысловатые тексты на входе могут потребовать известной ловкости рук и знания регулярных выражений.
*[http://haali.cs.msu.ru/pocketpc/scripts.html.ru ExportXML.dot] - лаконичный, но эффективный макрос для MSWord. Несмотря на свою седую древность, весьма достойный инструмент для преобразования грамотных doc|rtf файлов.
*[http://home.arcor.de/fb.tools doc2fb] - несколько более современный и простой в эксплуатации аналог ExportXML.dot. Для тех, у кого стоит MSOffoce 2003.
*[http://haali.cs.msu.ru/pocketpc/scripts.html.ru FictionBook Tools] - последний в списке, но первый по важности. Не лишенный недостатков, ено единственный в своем род инструмент для ?доводки? документов fb2. Must have.
*[http://www.gribuser.ru/xml/fictionbook/ Полный список утилит для работы с fb2].

Список выглядит несколько пугающе, но не все так страшно :) Я предлагаю начать работу со связки FBE+Any2FB.

=== Импорт простого документа с использованием FBE+Any2FB ===
Установите [http://haali.cs.msu.ru/pocketpc/scripts.html.ru FictionBook Tools] и [http://www.gribuser.ru/xml/fictionbook/2.0/software/Any2FB2.exe Any to FB2]. Возможно, вам придется установить последний MSXML или даже обновить систему - FBTools не работают в Win9x.

Итак, система обновлена, а программы установлены. Открываем Fictionbook Editor из пакета FBTools, вызываем меню ?Import?/?ANY->FB by GribUser?. Двинемся от простого к сложному, для начала сконвертим документ из lib.ru. Вводим адрес текста в Any2FB, сбрасываем настройки (если вы уже пользовались Any2FB) и нажимаем ?Import?.

<center>[[Image:Url_import_basic.gif|none|Импорт документа]]</center>

После того, как мы увидим на вкладке Log обнадеживающую фразу Export finished , нажимаем кнопку ?Done?. Документ передается в FBE и мы можем увидеть, что получилось при импорте. Были распознаны заголовки, была распознана одна сноска. Параграфы выглядят неплохо. Единственная претензия - заголовок всего документа был преобразован в отдельную пустую секцию плюс как заголовок была распознана строка про OCR.

<center>[[Image:Simple_doc.gif|none|Загруженный документ]]</center>

=== Доводка тела документа в FBE ===

==== Базовые операции по корректировке и облагораживанию fb2. ====
Приступим к тому, ради чего все и затевалось - к доводке. Первую строку исходного документа я предлагаю просто удалить (некоторые делают из нее title для body, но я не считаю это разумным). Простая операция удаления лишней секции с title, однако, сопряжена с известными трудностями в редакторе FBE. Удаление элементов структуры (как то: стихов, секций, эпиграфов) можно производить только из предыдущего элемента.

Установите курсор '''над''' заголовком ?Аркадий и Борис Стругацкие. Частные предположения? и нажмите клавишу ?Del?.

<center>[[Image:del_element.gif|none|Удаление элемента]]</center>

В результате текст перешел в предыдущий элемент, а старый структурный элемент удален. Жмите ?Del?, пока текст не удалиться. Этот метод работает для любых элементов FB2 и использовать его вы будете широко.

<center>[[Image:After_del_element.gif|none|После удаления]]</center>

Прежде, чем аналогичным образом мы разделаемся с секцией ?/* Scaned...? полезно будет заглянуть в редактор заголовка. Среди прочего он предлагает ввести и информацию о OCR. Перенесем туда (Copy+Paste) информацию из тела документа и теперь уже со спокойной совестью удалим текст об OCR - никто не забыт. Не забыто так же и то, что удалять секцию нужно из предыдущего элемента.

<center>[[Image:Ocr_to_fill.gif|none|Заполнение OSR]]</center>

=== Аннотация, эпиграфы, стихи, картинки ===
В режиме ?body? в начале документа цветными маркерами слева отмечаются разделы ?annotation? (серо-голубой) и ?history? (малиновый). Очень желательно заполнить annotaion (аннотация), тем самым существенно облегчив жизнь будущим читателям). Если вы меняли что-то в готовом fb2 документе, заполните историю - например, укажите, что документ вычитан, добавлена пропущенная при сканировании страница и т.п. Не забудьте изменить и номер версии документа (см. ниже).

При необходимости можно добавить эпиграф: поставить курсор туда, где он должен быть (эпиграф должен следовать сразу за началом секции и ее названием, если оно есть) и нажать Ctrl+N (или Edit=>Add=>Epigraph). Появится фиолетовая полоска, в которую и надо скопировать эпиграф (можно просто перетащить). Если эпиграфом служит стихотворение, то внутри фиолетовой полоски (тега <epigraph>) надо нажать Ctrl+P (или Edit=>Insert=>Poem), появятся чёрная (<poem>) и тёмно-красная (<stanza>) полоски, в тёмно-красную следует перетащить стихотворение. <stanza> ? это строфа, и таких тегов может быть несколько подряд. У эпиграфа наверняка есть автор: перетаскиваем его имя в конец стихотворения, выделяем, нажимаем Ctrl+D (Edit=>Add=>Text Author) ? тёмно-красная полоска заканчивается, а чёрная продлевается на одну строчку; копируем имя автора в чёрную полоску (тег <text-author> после </stanza>). Всё, операция завершена (примечание: после эпиграфа должен следовать ещё какой-то текст, то есть тег <section> не должен закрываться сразу после эпиграфа). Нажимаем F8 (вызов встроенного валидатора), чтобы проверить документ на наличие ошибок. Если ошибка есть, откроется режим Source и курсор автоматически переместится к тому тегу, в котором сделана ошибка.

В книгу можно вставить картинку (например, обложку бумажной версии): Edit=>Add Binary Object. После этого файл с картинкой прикрепляется в конец документа и его можно использовать. Чтобы сделать картинку обложкой, в режиме Description вводим в поле Coverpage-Image его название, добавив предварительно # (например, #cover.png). Теперь обложка вставилась в Description книги (где её и можно увидеть в Haali Reader) и будет автоматически показываться на странице книги в библиотеке. Если нужно вставить рисунок в тексте, то следует нажать Ctrl+M (Edit=>Insert=>Image) или Ctrl+G (Edit=>Add=>Image). Появится пустая рамка с надписью Unknown image ID, на неё надо нажать и в выпадающем списке (панель вверху с надписью Href) выбрать ID (название) нужного рисунка.

<center>[[Image:Insimage.gif|none|Вставка картинки]]</center>

Обратите внимание, что обложку '''не нужно''' вставлять в начало документа. Обложка указывается один раз, в description-е.

На закуску можно переименовать сноску ?Note_1? в, скажем ?[1]?. На этом наши злоключения с телом документа завершены.

Однако, кое-что еще на нашу долю осталось. А именно - заголовок, в котором пока есть только информация об OCR, а фамилия автора обозначена как ?Борис Стругацкие?. Не есть гуд.

=== Доводка заголовка ===

Опять переключаемся в режим заголовка (меню ?View?->?Description?) и приступаем к работе. Для начала выберем жанр. При размещении в библиотеке книга будет помещена на соответствующую ?полку? в соответствии с этим полем.

<center>[[Image:Genre_sel.gif|none|Выбор жанра]]</center>

После этого переходим к оформлению авторов. В нашем случае это Аркадий Натанович и Борис Натанович Стругацкие.

<center>[[Image:2authors.gif|none|Вставка авторов]]</center>

В таком же духе следует заполнить весь заголовок. Ниже приведен рисунок с заполненными обязательными и необязательными полями. Обязательные поля помечены красным, где необходимо даны комментарии. Помните, что чем больше достоверной информации вы предоставите, тем лучше. Потратьте время на поиск даты написания произведения, имени переводчика, издательства, выпустившего книгу. Часто такая информация говорит о многом.

<center>[[Image:Descr_hints.gif|none|Заполнение description]]</center>

Обратите внимание на название серии. Не нужно вводить название книги как ?Приключения пупкина I: Пупкин на Луне?, ?Приключения пупкина II: Пупкин на Марсе? и т.п. Вместо этого введите Book title ?Пупкин на Луне?, а в поле Sequence Name введите ?Приключения пупкина?. Не забудьте указать номер книги в серии, это позволит автоматически разложить книги по полочкам в библиотеке - сперва на луну, потом на марс, не наоборот.

Обратите также внимание на поле ID ? если вы будете загружать в библиотеку обновлённую версию своей книги, значение в этом поле (комбинация букв и цифр) должно оставаться прежним, а номер версии - возрасти. Это позволит обновить книгу даже, если вы поменяли название - книга все равно опознается как обновление к существующему документу и старый документ будет корректно заменен. Побочным эффектом такого способа идентификации книг является возможность удалить любую свою книгу из библиотеки - вы просто присваиваете новой книге ID намеченной на заклание жертвы и заливаете книгу в библиотеку поверх старой. Мир жесток.

=== Работа с исходным xml-кодом ===

Этот режим служит для исправления ошибок, сделанных в предыдущих двух а так же для выполнения всяких продвинутых (и не продвинутых) задач (типа вложения section) не имеющих удобной реализации в графическом интерфейсе :). Например, отсюда легко избавиться от лишних тегов <section> (а они наверняка появятся при экспорте). Имя автора и название книги не нужно выделять в отдельные секции, лучше поместить их в тег <title>, идущий сразу после <body>, а это можно сделать только в режиме исходника.

<nowiki>
<body>
<title>
<p>Philip Pullman</p>
<p>The Amber Spyglass</p>
<p>(His Dark Materials?Book Three)</p>
</title>
<section>
...</nowiki>

После этого уже открывается тег <section>, в который вложен текст книги, разбитый на главы (тег <title> после <section>). Если в книге несколько частей, то каждая из них должна находиться в отдельном контейнере <section>, в который будут вложены главы (тоже каждая в своём контейнере).

Вот, вроде, и всё. Ещё раз проверим книгу валидатором (F8), и можно [http://fictionbook.ru/en/upload/ отправлять] в библиотеку (не забудьте ввести свой email и поставить галочку напротив ?разрешить обновление существующих книг?).

Если вы хотите посмотреть на хорошо подготовленный документ и вообще на примерах разобраться, что где ставить, рекомендую скачать книгу '''Психология искусства''', там форматирование весьма навороченное и грамотное.

<center>[[Image:Hardcore.gif|none|Психология искусства]]</center>

=== Чего нет в этом документе ===
Это был курс молодого бойца и вы теперь сможете готовить весьма приличные документы. Однако, как вы обнаружите со временем, самое трудное - первый этап, а именно получение пригодного к доводке fb2. Данный документ, к сожалению, весьма слабо раскрывает эту тему, так что готовьтесь к худшему :).

Подготовка сносок так же сопряжена с известными трудностями, от которых вас избавит только Any2FB, да и то не полностью. Инструкции для всех этих многотрудных операций пока не готовы, и ваша помощь тут может помочь многим людям так же (если не больше), чем вам помог (надеемся) этот документ. Если вам есть, что сказать - поделитесь с народом.

=== Что точно нужно добавить: ===
*Подготовка сложных документов с помощью Any2FB
*Подготовка fb2 с помощью шаблона из ворда
*Подготовка fb2 с помошью BookDesigner
*Работа с регулярными выражениями

Если ваши методы работы отличаются от приведенных выше - пишите, мы включим их в инструкцию.

Шлите на grib@gribuser.ru ваши предложения, поправки, инструкции и гневные требования.

'''''Rollon и Дмитрий Грибов'''''
[[Категория:FB статьи]]

Описание формата FB2 от Sclex

2007-02-05T16:25:42Z

Sclex: /* Тело документа (структура разделов body и section) */ убрал лишнюю скобку

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>'''.

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на таблицу можно сослаться. Атрибут '''style''' назначает стиль оформления для таблицы (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}
=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-05T01:12:20Z

Sclex: /* Тело документа (структура разделов body и section) */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одно или более вхождений''), но первый тэг не может быть '''<nowiki><image></nowiki>''').

Следовательно, обязательно наличие либо вложенного подраздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на таблицу можно сослаться. Атрибут '''style''' назначает стиль оформления для таблицы (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}
=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-05T01:09:52Z

Sclex: /* Тело документа (структура разделов body и section) */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Одно или более вхождений''.

Откуда видно, что обязателен только раздел '''<section>'''.

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Одно из двух. Либо подраздел '''<section>''' (''одно или более вхождений''); либо форматированный текст с картинками - тэги '''<nowiki><p></nowiki>''', '''<nowiki><image></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><table></nowiki>''' (''одного или более вхождений'', но первый тэг не может быть '''<nowiki><image></nowiki>''').

Следовательно, обязательно наличие либо раздела '''<section>''', либо форматированного текста с картинками.

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на таблицу можно сослаться. Атрибут '''style''' назначает стиль оформления для таблицы (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}
=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-03T12:40:28Z

Sclex: /* Картинки */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<nowiki><image/></nowiki>''' (закрывающий тэг не требуется). Он может иметь атрибуты '''type''', '''href''', '''alt''', '''title''', '''id'''. Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><p>Абзац текста до картинки.</p>
<image l:href="#picture.jpg"/>
<p>Абзац текста после картинки.</p>
</pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Тэг '''<nowiki><image/></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', и в этом случае он описывает просто картинку. Если же '''<nowiki><image/></nowiki>''' вложен в '''<nowiki><p></nowiki>''', он обозначает inline-картинку, то есть такую, которая отображается наравне с текстом, внутри его. У Inline-картинок допустимы только атрибуты '''type''', '''href''', '''alt'''.

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на таблицу можно сослаться. Атрибут '''style''' назначает стиль оформления для таблицы (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}
=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-03T11:52:59Z

Sclex: Сделал описание тэга table

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>''' и/или '''<nowiki><annotation></nowiki>'''.

Этот тэг может иметь свойства '''id''' и '''style'''. '''id''' описывает идентификатор таблицы, который можно использовать в ссылке, а '''style''' определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут '''align''', которое предписывает программе-просмотрщику использовать определенный тип горизонтального выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты '''id''', '''style''', '''colspan''', '''rowspan''' и '''align'''. Свойство '''id''' задает идентификатор, по которому на таблицу можно сослаться. Атрибут '''style''' назначает стиль оформления для таблицы (нужно при использовании CSS). Свойства '''colspan''' и '''rowspan''' определяют количество колонок и рядов, которые занимает ячейка. Атрибут '''align''' описывает тип горизонтального выравнивания, аналогично одноименно свойству тэга '''<nowiki><td></nowiki>'''.

В примере показано, как оформить таблицей небольшую табличку умножения:
<pre>
<table>
<tr>
<th></th>
<th>2</th>
<th>3</th>
<th>4</th>
</tr>
<tr>
<th>5</th>
<td>10</td>
<td>15</td>
<td>20</td>
</tr>
<tr>
<th>6</th>
<td>12</td>
<td>18</td>
<td>24</td>
</tr>
<tr>
<th>7</th>
<td>14</td>
<td>21</td>
<td>28</td>
</tr>
</table></pre>

{| border=1
|bgcolor=#CCFF00|
|bgcolor=#CCFF00|2
|bgcolor=#CCFF00|3
|bgcolor=#CCFF00|4
|-
|bgcolor=#CCFF00|5
|10
|15
|20
|-
|bgcolor=#CCFF00|6
|12
|18
|24
|-
|bgcolor=#CCFF00|7
|14
|21
|28
|}
=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-02-03T11:15:30Z

Sclex: Описание тэга table

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Таблицы ===

Таблицы оформляются при помощи тэга '''<nowiki><table></nowiki>''', который может быть вложен в тэги '''<nowiki><cite></nowiki>''', '''<nowiki><section></nowiki>'''.

Этот тэг может иметь свойства id и style. id описывает идентификатор таблицы, который можно использовать в ссылке, а style определяет, какой стиль отображения сопоставлен данной таблице.

Тэг '''<nowiki><table></nowiki>''' содержит вложенные тэги '''<nowiki><tr>...</tr></nowiki>''', каждый тэг '''<nowiki><tr></nowiki>''' описывает один горизонтальный ряд ячеек таблицы. Этот тэг может иметь атрибут ?align?, которое предписывает программе-просмотрщику использовать определенный тип выравнивания для ряда таблицы. Этот атрибут может принимать значения ?left? (по левому краю), ?right? (по правому краю) или ?center? (центрирование). По умолчанию используется значение ?left?.

Тэг '''<tr>''', в свою очередь, содержит вложенные тэги '''<th>''' и '''<td>''' (''в любом количестве и порядке каждый''). '''<th>''' описывает ячейку, которая должна быть отображена как заголовок таблицы. '''<tr>''' обрамляет простую ячейку таблицы. Эти два тэга могут содержать только текст без всяких тэгов.

Тэги '''<nowiki><th></nowiki>''' и '''<nowiki><td></nowiki>''' могут иметь атрибуты ?id?, ?style?, ?colspan?, ?rowspan? и ?align?. Свойство ?id? задает идентификатор, по которому на таблицу можно сослаться. Атрибут ?style? назначает стиль оформления для таблицы (нужно при использовании CSS). Свойства ?colspan? и ?rowspan? определяют количество колонок и рядов, которые занимает ячейка. Атрибут ?align? описывает тип выравнивания, который следует использовать для ячейки (аналогично одноименно свойству тэга '''<nowiki><tr></nowiki>''').

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2007-01-12T13:54:30Z

Sclex: /* Текст моноширинным шрифтом */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Программный код ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно логически разметить текст, который при просмотре файла должен быть отображен как программный код. Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''. Читалкам рекомендуется текст внутри этого тэга оформлять при выводе моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину).

<pre>
<p><code>Assign(f,'name.txt');</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Документы

2006-11-19T13:50:56Z

Sclex:

:* [[XML схема FictionBook2.0]]
:* [[XML схема FictionBook2.1]]
:* [[FictionBook 2.0 Schema - комментарии]]
:* [[Нововведения в FictionBook 2.1 по сравнению с 2.0]]
:* [[Таблица автоматической конвертации жанров FB2.0 - FB2.1]]
:* [[Тестовый ознакомительный документ FictionBook 2.1]]
:* [[Тестовый платный документ FictionBook 2.1]]
:* [[Пример документа в FB2]]
:* [[FAQ по подготовке документа в FB2]]
:* [[Элементы стандарта FictionBook]]
:* [[Описание формата FB2 от Sclex]]
:* [[Жанры FictionBook 2.1]]
:* [[XML-файл для преобразования кодов жанров всех версий в двухуровневое описание жанра]]

Описание формата FB2 от Sclex

2006-11-19T13:49:48Z

Sclex: ?Описание стандарта FictionBook от Sclex? переименована в ?Описание формата FB2 от Sclex?

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Обсуждение:Описание формата FB2 от Sclex

2006-11-19T13:49:48Z

Sclex: ?Обсуждение:Описание стандарта FictionBook от Sclex? переименована в ?Обсуждение:Описание формата FB2 от Sclex?

В разделе "Жанры" фраза "'''Здесь''' перечислены значения, которые принимает поле <genre> в заголовке FB2-документа." слово '''Здесь''' является ссылкой на стандарт жанров. Этого достаточно. Просто, если перегрузить документ (более 30К), то он не во всех браузерах будет нормально читаться, да и зачем дважды писать одно и то же.

Также надо поступить и с кодами - оформить их отдельным документом и сослаться. Только я бы сделал ввиде таблицы и указал стандарты.

--[[Участник:FBAdmin|FBAdmin]] 13:20, 25 мая 2006 (MSD)

Список жанров должен быть оформлен в виде простого текста, а не в виде стандарта.

--[[Участник:Sclex|Sclex]] 13:24, 25 мая 2006 (MSD)Sclex

Не понял. В ссылке он и есть текстом. А стандартом я называю, потому что он официальный. Впрочем как хочешь.

--[[Участник:FBAdmin|FBAdmin]] 13:32, 25 мая 2006 (MSD)

Присвоил категорию статье, все, больше не вмешиваюсь.

--[[Участник:FBAdmin|FBAdmin]] 13:42, 25 мая 2006 (MSD)

Какая-то тавтология получается:
=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<p class=p>Далее перечислены значения, которые принимает поле <b><genre></b> в заголовке FB2-документа.</p>
<p class=p><pre>sf_history Альтернативная история</pre></p>

--[[Участник:M0l0h|M0l0h]] 14:42, 25 мая 2006 (MSD)

Описание стандарта FictionBook от Sclex

2006-11-19T13:49:48Z

Sclex: ?Описание стандарта FictionBook от Sclex? переименована в ?Описание формата FB2 от Sclex?: при поиске в гугле скорее будут вводить "описание формата FB2"

#redirect [[Описание формата FB2 от Sclex]]

Обсуждение:Описание стандарта FictionBook от Sclex

2006-11-19T13:49:48Z

Sclex: ?Обсуждение:Описание стандарта FictionBook от Sclex? переименована в ?Обсуждение:Описание формата FB2 от Sclex?: при поиске в гугле скорее будут вводи

#redirect [[Обсуждение:Описание формата FB2 от Sclex]]

Описание формата FB2 от Sclex

2006-11-19T13:32:42Z

Sclex: /* Стихи */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''. Кроме того в состав '''<nowiki><stanza></nowiki>''' могут входить тэги '''<nowiki><title></nowiki>''' (заголовок) и '''<nowiki><subtitle></nowiki>''' (подзаголовок).
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2006-11-19T13:27:54Z

Sclex: /* Подзаголовки */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<nowiki><subtitle></nowiki>''', который содержит простой (неформатированный) текст. Тэг '''<nowiki><subtitle></nowiki>''' может быть вложенным в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><cite></nowiki>''' и '''<nowiki><stanza></nowiki>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''.
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2006-11-19T13:24:48Z

Sclex: /* Заголовки */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

Тэг '''<nowiki><title></nowiki>''' может быть вложен в тэги '''<nowiki><body></nowiki>''', '''<nowiki><section></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><stanza></nowiki>'''.

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

Подзаголовки описываются тэгом '''<subtitle>''', который содержит простой (неформатированный) текст. Тэг '''<subtitle>''' может быть вложенным в тэги '''<body>''' и '''<section>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''.
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2006-11-19T13:11:52Z

Sclex: /* Форматированный текст */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется из соображений читабельности использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8. utf-8 также является кодировкой по умолчанию, использующейся в случае отсутствия атрибута encoding или всего XML-объявления.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

Тэг '''<nowiki><p></nowiki>''' может быть вложен в тэги '''<nowiki><title></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><epigraph></nowiki>''', '''<nowiki><annotation></nowiki>''', '''<nowiki><section></nowiki>'''.

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

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

Подзаголовки описываются тэгом '''<subtitle>''', который содержит простой (неформатированный) текст. Тэг '''<subtitle>''' может быть вложенным в тэги '''<body>''' и '''<section>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''.
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2006-10-04T21:42:18Z

Sclex: /* Двоичные вложения */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

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

Подзаголовки описываются тэгом '''<subtitle>''', который содержит простой (неформатированный) текст. Тэг '''<subtitle>''' может быть вложенным в тэги '''<body>''' и '''<section>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''.
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''<binary>''', который идет в документе вслед за последним элементом '''<body>'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2006-10-04T21:38:29Z

Sclex: /* Двоичные вложения */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

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

Подзаголовки описываются тэгом '''<subtitle>''', который содержит простой (неформатированный) текст. Тэг '''<subtitle>''' может быть вложенным в тэги '''<body>''' и '''<section>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''.
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''binary''', который идет в документе вслед за последним элементов '''body'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Вычитка, редактура и создание fb2-файла с начала и до конца, с помощью FBD и не только

2006-10-04T19:01:41Z

Sclex: "Аод названием"

==Зачем, или введение==

В последнее время автор данной статьи регулярно занимается вычиткой книг и созданием fb-файлов для библиотек. Так как мой способ сделать файл красивым и правильным нигде не описан, появилась данная статья. Автор ни в коем случае не претендует на то, что этот способ есть единственно верный и правильный, даже напротив, часть функций программ не используется (хотя и могло бы), но привычка и инерция мышления свойственны, увы, всем людям.

Все основные правила создания fb2-книг описаны в статье [[Как сделать книгу]], с которой советую ознакомиться.

В работе мною используется несколько программ:
* Microsoft Word, или MW (любая версия) - для предварительной правки документа и оформления ссылок
* [http://www.the-ebook.org/e107/download.php?view.19 FictionBookDesigner], или FBD - для красивого оформления книги, расстановки заголовков и вложенных частей и создания fb2-файла
* [http://haali.cs.msu.ru/pocketpc/scripts.html.ru FictionBookEditor], или FBE - для окончательной правки книги после вычитки и проверки ее валидности
* [http://www.the-ebook.org/e107/download.php?view.8 BookDesigner], или BD для изготовления из fb2 файла в формате устройства для чтения. [http://www.the-ebook.org/e107/e107_files/downloads/bd/Bd_Update_2006_09_13.zip Последний апдейт]
* [http://soft.primedance.ru/mtp.php MassTextProcessor], или MTP - для корректировки некоторых неточностей, недопустимых в библиотеках, но допустимых в FBD

В принципе, последнюю программу можно и опустить, в FBD имеются все необходимые инструменты, но я ее люблю за простоту использования, маленький размер и отсутствие необходимости ее инсталляции. Кроме того, она позволяет работать сразу с большим колличеством файлов, что, правда, здесь описываться не будет.

На вопрос - зачем я использую две программы одного типа (BD и FBD) ответ простой. Разница между BD и FBD есть и большая: FBD полностью юникдный, а BD - только частично. Т.е. если надо сделать книгу с языками, несовместимыми внутри одной локальной кодировки (например, русский и французский), то это только в FBD. Кроме того FBD сделан специально для изготовления fb2-файлов, а BD - всеяден. Он имеет множество форматов как на входе, так и на выходе.

Автор исходит из того, что вышеперечисленные программы у читателя имеются и установлены, кроме того, что у читателя есть минимальные навыки редактирования и сохранения текста.

Новичкам же настоятельно рекомендуется внимательно прочитать урок по редактированию в последнем апдейте BD: Help -> Self Teaching -> my first e-book.

==Последовательность работы==
=== MW, предварительная правка ===

Итак, файл, который приходит ко мне после сканирования и распознавания от сканщика находится в формате .rtf {RichTextFormat) который распознается и редактируется обычным MW. Посему, первым делом входим в Word. Главная задача этого этапа - оформить ссылки и исправить явный очень "кривой" текст.

Первым делом, чтобы не пропустить разрывы абзацев, выделяем весь текст и првой клавишей мышки вызываем меню. Проходим в пункт "Абзац" и выбираем "Отступ"->"Первая строка"->"Отступ".

[[Image:Абзац.jpg]]

Снова вызываем меню "Шрифт"->выбираем размер и тип шрифта всего документа. Это делается потому, что при распознавании текста часто смена типа или размера шрифта попадает на середину слова. В этом случае, при закачке файла в FBD в этом месте будет пробел.

Далее, "Сервис"->"Параметры"->"Правописание" проверяем, что стоят галочки: автоматически проверять орфографию, всегда предлагать замену, пропускать слова из прописных букв, пропускать слова с цифрами, пропускать адреса Интернета и имена файлов, автоматически проверять грамматику, также проверять орфографию. Делаем "Повторную проверку".

[[Image:Орфография.jpg]]

Есть несколько иной вариант работы с MW - подгрузка шаблона. Этот способ хорошо описан [http://www.oldmaglib.com/help/assistent.php тут], и повторяться я не буду. Мое единственное возражение к указанному способу - такого объемного форматирования FBD все равно не понимает, так стоит ли огород городить. Но, может, кому-то это будет приятнее или удобнее.

Затем начинается самая нудная и противная работа - просматриваем внимательно весь файл, исправляя ошибки и формируя сноски. В исходном файле сноски бывают двух видов - обозначаемые звездочкой и обозначаемые надстрочными цифрами. Сначала заходим "Вставка"->"Ссылка"->"Сноска", и настраиваем. Сноски должны быть внизу текста, формат номера 1,2,3..., начать с 1, нумерация продолжить. Применяем сделанные изменения. Далее "Сервис"->"Настройка"->"Команды", в левом окошечке выбираем "Вставка" и из правого перетаскиваем мышкой команду "Сноска..." на панель инструментов.

[[Image:Сноски.jpg]]

При появлении сноски в тексте, устанавливаем курсор на место сноски и мышкой щелкаем по появившейся кнопке на панели инструментов. В возникшее внизу окошко перекидываем текст сноски.

[[Image:Общий_вид.jpg]]

Дойдя до конца файла проверяем дополнительно поиском, нет ли потерявшихся сносок.

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

Сохраняем файл и выходим из MW.

=== FBD - изготовление fb2-файла ===

В принципе, все здесь описанное - это просто последовательность действий, предпринимаемых лично мной. Для краткого ознакомления с возможностями программы рекомендую статью про изготовление книг [[BookDesigner 4.x - как быстро и правильно делать ebook]].

Перед открытием файла с помощью FBD, особенно при первом использовании, имеет смысл проверить настройки этой программы. У меня настроено так. Самое главное - проверить, если многоязыковая поддержка для книг с испанским, французским и тому подобными языками. Кроме того, я всегда сохраняю исходный формат и часто пользуюсь определением заголовков не только по ключевым словам, но и по выделенному тексту, так как часто при распознавании названия глав выделяются жирным шрифтом.

[[Image:Настройки_FBD.jpg]]

Вызов этого меню происходит с помощью кнопки [[Image:Настройить.jpg]]

После проведения всех предварительных настроек рекомендуется перезагрузить файл, чтобы они были применены к нему. Дальше следует опять длительная и нудная работа - пролистывание всей книги и проверка заголовков. Часть ошибок определяется и правится на этой стадии работы. Сразу оговорюсь, для выделения куска текста надо дважды щелкнуть по нему мышкой. В этом случае выделяется абзац. Если надо выделить больше одного абзаца - сначала выделить первый двойным щелчком, а потом перейти к последнему и Shift+щелчок мышкой. Только в этом случае выделение текста будет 100% правильным. Все команды BookCorrector применяются только к выделенному тексту.

[[Image:Корректор.jpg]]

Сначала проверяем, правильно ли определился автор и название книги. Если нет - корректируем с помощью BookCorrector (выбрать соответственно book author и book title). Затем определяем аннотацию (если она есть) как аннотацию (BookCorrector annotation). Далее ищем все заголовки (BookCorrector title), эпиграфы (epigraph), стихи (verse) и цитаты. С цитатами (письмами и т.п.) сложнее всего! Дело в том, что они не поддерживаются BookDesigner как отдельная функция. В связи с чем, чтобы получить красивый и грамотно сделанный файл приходится поизвращаться. Лично я делаю так: выделяю текст, как эпиграф, и потом правлю в FBE.

Кроме того, в эпиграфах, стихотворениях и цитатах может быть автор текста, которого следует оформить, как text author.

После выделения всех заголовков надо сформировать будущую структуру книги. На этом этапе очень удобен в использовании FictionBookSectionEditor. Он вызывается с помощью иконки
[[Image:Дерево.jpg]] и выглядит так

[[Image:Секция.jpg]]

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

[[Image:Секция1.jpg]]

После чего обязательно нажимаем кнопочку apply, чтобы записать текущее расположение секций. ВНИМАНИЕ! Если вы выйдете из редактора секций и снова войдете в него секции снова будут выглядеть неразмеченными! Ваши изменения в редакторе станут не видны! Поэтому, не выходите из редактора секций до получения желаемого результата!

Осталось сделать последнее перед собственно изготовлением fb2-файла - отформатировать сноски. Для этого выделите сноски и сделайте Format->selected notes.

Теперь можно вызвать меню создания FB2.

[[Image:Изготовление.jpg]]

Если Вы все сделали правильно, то поля автора, названия книги и аннотации уже заполнены. Вам останется выбрать жанр из предлагаемого списка и вставить обложку, перетащив ее мышкой из окошка проводника Windows в окошко book cover picture. Проверьте настройки - обязательно должна быть включена опция book for library. Нажимаем на кнопочку make book и ждем звукового сигнала, сигнализирующего о том, что книга готова.

В принципе теперь нужно провести валидацию получившегося файла. В случае возникновения ошибок автоматически включается очень удобный инструмент FictionBookInvestigator, в котором можно поправить неправильные куски кода. Он же вызывается в окне "Make Fiction Book File" кнопкой "load to FBI", которая активируется после создания fb2. FBI (Fiction Book Investigator) - это специализированный ручной редактор/валидатор fb2-файлов. По опциям - раз в несколько помощнее FBE.

Но я, обычно, завершаю на этом работу с FBD и перехожу к редактору FBE.

=== FBE - доводка до ума ===

Редактор FBE удобен тем, что позволяет редактировать как внешний вид, так и исходный код документа и хорошо выявляет его структуру. При раскрытии "дерева" оглавления все огрехи и недоработки видны сразу и их легко поправить.

Первым делом надо удостовериться, что структура документа красива и логична, нет лишнего дробления на секции, оглавление будет хорошо выглядеть. Как пример - разбитые на секции заголовки.

[[Image:brake_sec.jpg]]

Когда такой разбитый заголовок встречается в тексте это во-первых - некрасиво, а во-вторых неудобно, так как этот заголовок - название главы. Это - два заголовка одного уровня, поэтому можно смело объединить секции и избежать ненужного увеличения количества секций. Для этого, поставив курсор на верхнюю из объединяемых секций, надо нажать Alt+Del. После этого выделить заголовок, превратившийся в секцию, и перетащить его в заголовок. Убрать лишние пустые строки, или добавить их, если заголовок слишком длинный и получается некрасиво.

[[Image:no_brake_sec.jpg]]

Есть несколько пунктов, которые я правлю в любом документе, сделанном в FBD.
1. Аннотация. FBD, кроме создания отдельного пункта в description под названием annotation дублирует ее в отдельную секцию сразу после автора и названия книги. Этот дубляж не очень удобен для последующего использования файла, поэтому эту секцию я удаляю целиком. Правая кнопка мыши Select->body/section, и правой же кнопкой Cut или Delete.

2. Часто валидацию не проходят файлы, в которых картинки идут друг за другом. Дело в том, что FBD не вставляет пустую строку между такими картинками, что требует схема, даже если вручную попытаться вставить строку. Поэтому, ставим курсор на вторую, третью и т.д. картинки и жмем Enter.

3. Правим цитаты. Как Вы помните, мы выделили цитаты как эпиграфы. Теперь надо сделать из них цитаты. Это удобнее делать в редакторе исходных кодов (View->Source). Находим поиском тег <epigraph> и смотрим чуть выше. Непосредственно перед ним идет разрыв секций, так как эпиграф может ставиться только в начале секции. А вот цитата может идти в любом месте секции, поэтому разрыв секций можно убрать, а вместо <nowiki><epigraph>...</epigraph> вставить <cite>...</cite> </nowiki>

Было

[[Image:FBE-epigraph.jpg]]

Стало

[[Image:FBE-cite.jpg]]

4. Пустые строки до и после названия главы. Такие строки встречаются крайне редко, но их нужно убирать по правилам создания валидного документа.

=== MTP - чистка сносок ===

В принципе, как я уже говорила, без этой программы можно было вполне обойтись. Но я ее люблю, а потому и расскажу. Она очень удобна, когда надо сделать массовую замену в файле (или нескольких файлах) текстовых конструкций с переменным текстом внутри на другие конструкции с тем же текстом. В принципе с тем же успехом можно применять BookCleaner, входящий в состав FBD, написав к нему соответствующий скрипт, и так, наверное, будет даже быстрее, но я пользуюсь MTP.

В этом процессоре есть свой, очень простой, язык макросов, текст на котором я приведу полностью.

Суть проблемы, которую надо решить, в том, что FBD и его автор категорически не согласны с правилами, установленными в fb2 относительно возвратных сносок. В формате возвратные ссылки в принципе разрешены, за исключением сносок. Поэтому, их приходится в обязательном порядке корректировать, чтобы библиотека приняла валидный файл. Кроме того, вид ссылок приводится к библиотечному стандарту.

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

1. Ликвидация маркировки параграфов.

Итак, в окошко ''ИСХОДНЫЙ ТЕКСТ'' пишем такой блок

<nowiki>TEXT="<p id=\""</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="\">"</nowiki>

а в окошко ''ЗАМЕНИТЬ НА'' - такой

<nowiki> TEXT="<p>"</nowiki>

и запускаем процессор.

[[Image:Blok1.jpg]]

2. Добавление в ссылки типа "сноска"

''ИСХОДНЫЙ ТЕКСТ''

<nowiki>TEXT="<a l:href=\""</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="\">"</nowiki>

''ЗАМЕНИТЬ НА''

<nowiki>TEXT="<a l:href=\""</nowiki>

<nowiki>NAME=BLOCK1</nowiki>

<nowiki>TEXT="\" type="note\">"</nowiki>

[[Image:Blok2.jpg]]

3. Определение номера сноски, как заголовка.

''ИСХОДНЫЙ ТЕКСТ''

<nowiki>TEXT="<p>["</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="]"</nowiki>

''ЗАМЕНИТЬ НА ''

<nowiki>TEXT=" <title>\n <p>"</nowiki>

<nowiki>NAME=BLOCK1</nowiki>

<nowiki>TEXT="</p>\n </title>\n <p>"</nowiki>

[[Image:Blok3.jpg]]

После такого количества правок файл готов к вычитке настолько, что встречающиеся ошибки не будут вызывать раздражения и желания забросить книгу в какой-нибудь дальний угол...

=== BD - для вычитки ===

Программой BookDesigner я пользуюсь для того, чтобы сделать файл для того устройства, на котором я читаю. Я бы совсем не упоминала здесь об этом, но есть яркий и красивый пример использования BookCleaner, программы, входящей как в BD, так и в FBD, и подсказанный мне разработчиком этих программ. Это - прекрасная иллюстрация того, как можно заменить MTP, написав небольшой скрипт.

Если Вы помните, BD и FBD не создают, не понимают и не отображают цитаты. В будущем это, скорее всего, изменится, но в настоящем - увы. А хотелось бы видеть в устройстве все форматирование fb2 - во-первых, во избежание возможных ошибок и некорректностей, а во-вторых красивую книгу просто приятно читать. Поэтому, чтобы в ридере иметь выделение цитат и был написан данный скрипт.

Пример для BD, должен быть установлен последний апдейт. В FBD тоже можно это делать, но там старый вариант Book Cleaner, скрипт тот же, но кнопки другие.

Tools -> Book Cleaner
script -> new

find what:
<nowiki><cite[^>]*> replace by: <SPAN id=cite><FONT color=red></nowiki>
RegExp: поставить галку.

table -> add row

find what:
<nowiki></cite> replace by: </FONT></SPAN></nowiki>

script -> save as -> "fb2cite"

input file: before formatting -> выбрать "fb2cite.bcf"
input file: after formatting -> none
output file (fb2): -> none

Закрыть Book Cleaner. После загрузки fb2 все cite будут выделены красным. Если внутри cite есть text-author, то он будет выделяться своим цветом.
При двойном клике на первую строку cite будет селектироваться весь элемент, а на 4-ой панели статуса появится его тип: cite

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

[[Image:BookCleaner.jpg]]

== Окончательный результат ==

Ну вот, мы и добрались до финиша. Вычитывает каждый на своем устройстве, поэтому вычитку описывать смысла нет, окончательная правка файла происходит в FBE, про который мы уже говорили, на выходе получаем довольно чистую от ошибок, красиво оформленную книгу, готовую к заливке в библиотеку. Работа эта долгая и нудноватая, но результат, на мой взгляд, окупает все усилия.

Приятного чтения!

--[[Участник:Marina Ch|Marina Ch]] 21:27, 4 октября 2006 (MSD)

[править]

Вычитка, редактура и создание fb2-файла с начала и до конца, с помощью FBD и не только

2006-10-04T18:58:25Z

Sclex: распознОвание, нажимаеИ, если вы выйдИте

==Зачем, или введение==

В последнее время автор данной статьи регулярно занимается вычиткой книг и созданием fb-файлов для библиотек. Так как мой способ сделать файл красивым и правильным нигде не описан, появилась данная статья. Автор ни в коем случае не претендует на то, что этот способ есть единственно верный и правильный, даже напротив, часть функций программ не используется (хотя и могло бы), но привычка и инерция мышления свойственны, увы, всем людям.

Все основные правила создания fb2-книг описаны в статье [[Как сделать книгу]], с которой советую ознакомиться.

В работе мною используется несколько программ:
* Microsoft Word, или MW (любая версия) - для предварительной правки документа и оформления ссылок
* [http://www.the-ebook.org/e107/download.php?view.19 FictionBookDesigner], или FBD - для красивого оформления книги, расстановки заголовков и вложенных частей и создания fb2-файла
* [http://haali.cs.msu.ru/pocketpc/scripts.html.ru FictionBookEditor], или FBE - для окончательной правки книги после вычитки и проверки ее валидности
* [http://www.the-ebook.org/e107/download.php?view.8 BookDesigner], или BD для изготовления из fb2 файла в формате устройства для чтения. [http://www.the-ebook.org/e107/e107_files/downloads/bd/Bd_Update_2006_09_13.zip Последний апдейт]
* [http://soft.primedance.ru/mtp.php MassTextProcessor], или MTP - для корректировки некоторых неточностей, недопустимых в библиотеках, но допустимых в FBD

В принципе, последнюю программу можно и опустить, в FBD имеются все необходимые инструменты, но я ее люблю за простоту использования, маленький размер и отсутствие необходимости ее инсталляции. Кроме того, она позволяет работать сразу с большим колличеством файлов, что, правда, здесь описываться не будет.

На вопрос - зачем я использую две программы одного типа (BD и FBD) ответ простой. Разница между BD и FBD есть и большая: FBD полностью юникдный, а BD - только частично. Т.е. если надо сделать книгу с языками, несовместимыми внутри одной локальной кодировки (например, русский и французский), то это только в FBD. Кроме того FBD сделан специально для изготовления fb2-файлов, а BD - всеяден. Он имеет множество форматов как на входе, так и на выходе.

Автор исходит из того, что вышеперечисленные программы у читателя имеются и установлены, кроме того, что у читателя есть минимальные навыки редактирования и сохранения текста.

Новичкам же настоятельно рекомендуется внимательно прочитать урок по редактированию в последнем апдейте BD: Help -> Self Teaching -> my first e-book.

==Последовательность работы==
=== MW, предварительная правка ===

Итак, файл, который приходит ко мне после сканирования и распознавания от сканщика находится в формате .rtf {RichTextFormat) который распознается и редактируется обычным MW. Посему, первым делом входим в Word. Главная задача этого этапа - оформить ссылки и исправить явный очень "кривой" текст.

Первым делом, чтобы не пропустить разрывы абзацев, выделяем весь текст и првой клавишей мышки вызываем меню. Проходим в пункт "Абзац" и выбираем "Отступ"->"Первая строка"->"Отступ".

[[Image:Абзац.jpg]]

Снова вызываем меню "Шрифт"->выбираем размер и тип шрифта всего документа. Это делается потому, что при распознавании текста часто смена типа или размера шрифта попадает на середину слова. В этом случае, при закачке файла в FBD в этом месте будет пробел.

Далее, "Сервис"->"Параметры"->"Правописание" проверяем, что стоят галочки: автоматически проверять орфографию, всегда предлагать замену, пропускать слова из прописных букв, пропускать слова с цифрами, пропускать адреса Интернета и имена файлов, автоматически проверять грамматику, также проверять орфографию. Делаем "Повторную проверку".

[[Image:Орфография.jpg]]

Есть несколько иной вариант работы с MW - подгрузка шаблона. Этот способ хорошо описан [http://www.oldmaglib.com/help/assistent.php тут], и повторяться я не буду. Мое единственное возражение к указанному способу - такого объемного форматирования FBD все равно не понимает, так стоит ли огород городить. Но, может, кому-то это будет приятнее или удобнее.

Затем начинается самая нудная и противная работа - просматриваем внимательно весь файл, исправляя ошибки и формируя сноски. В исходном файле сноски бывают двух видов - обозначаемые звездочкой и обозначаемые надстрочными цифрами. Сначала заходим "Вставка"->"Ссылка"->"Сноска", и настраиваем. Сноски должны быть внизу текста, формат номера 1,2,3..., начать с 1, нумерация продолжить. Применяем сделанные изменения. Далее "Сервис"->"Настройка"->"Команды", в левом окошечке выбираем "Вставка" и из правого перетаскиваем мышкой команду "Сноска..." на панель инструментов.

[[Image:Сноски.jpg]]

При появлении сноски в тексте, устанавливаем курсор на место сноски и мышкой щелкаем по появившейся кнопке на панели инструментов. В возникшее внизу окошко перекидываем текст сноски.

[[Image:Общий_вид.jpg]]

Дойдя до конца файла проверяем дополнительно поиском, нет ли потерявшихся сносок.

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

Сохраняем файл и выходим из MW.

=== FBD - изготовление fb2-файла ===

В принципе, все здесь описанное - это просто последовательность действий, предпринимаемых лично мной. Для краткого ознакомления с возможностями программы рекомендую статью про изготовление книг [[BookDesigner 4.x - как быстро и правильно делать ebook]].

Перед открытием файла с помощью FBD, особенно при первом использовании, имеет смысл проверить настройки этой программы. У меня настроено так. Самое главное - проверить, если многоязыковая поддержка для книг с испанским, французским и тому подобными языками. Кроме того, я всегда сохраняю исходный формат и часто пользуюсь определением заголовков не только по ключевым словам, но и по выделенному тексту, так как часто при распознавании названия глав выделяются жирным шрифтом.

[[Image:Настройки_FBD.jpg]]

Вызов этого меню происходит с помощью кнопки [[Image:Настройить.jpg]]

После проведения всех предварительных настроек рекомендуется перезагрузить файл, чтобы они были применены к нему. Дальше следует опять длительная и нудная работа - пролистывание всей книги и проверка заголовков. Часть ошибок определяется и правится на этой стадии работы. Сразу оговорюсь, для выделения куска текста надо дважды щелкнуть по нему мышкой. В этом случае выделяется абзац. Если надо выделить больше одного абзаца - сначала выделить первый двойным щелчком, а потом перейти к последнему и Shift+щелчок мышкой. Только в этом случае выделение текста будет 100% правильным. Все команды BookCorrector применяются только к выделенному тексту.

[[Image:Корректор.jpg]]

Сначала проверяем, правильно ли определился автор и название книги. Если нет - корректируем с помощью BookCorrector (выбрать соответственно book author и book title). Затем определяем аннотацию (если она есть) как аннотацию (BookCorrector annotation). Далее ищем все заголовки (BookCorrector title), эпиграфы (epigraph), стихи (verse) и цитаты. С цитатами (письмами и т.п.) сложнее всего! Дело в том, что они не поддерживаются BookDesigner как отдельная функция. В связи с чем, чтобы получить красивый и грамотно сделанный файл приходится поизвращаться. Лично я делаю так: выделяю текст, как эпиграф, и потом правлю в FBE.

Кроме того, в эпиграфах, стихотворениях и цитатах может быть автор текста, которого следует оформить, как text author.

После выделения всех заголовков надо сформировать будущую структуру книги. На этом этапе очень удобен в использовании FictionBookSectionEditor. Он вызывается с помощью иконки
[[Image:Дерево.jpg]] и выглядит так

[[Image:Секция.jpg]]

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

[[Image:Секция1.jpg]]

После чего обязательно нажимаем кнопочку apply, чтобы записать текущее расположение секций. ВНИМАНИЕ! Если вы выйдете из редактора секций и снова войдете в него секции снова будут выглядеть неразмеченными! Ваши изменения в редакторе станут не видны! Поэтому, не выходите из редактора секций до получения желаемого результата!

Осталось сделать последнее перед собственно изготовлением fb2-файла - отформатировать сноски. Для этого выделите сноски и сделайте Format->selected notes.

Теперь можно вызвать меню создания FB2.

[[Image:Изготовление.jpg]]

Если Вы все сделали правильно, то поля автора, названия книги и аннотации уже заполнены. Вам останется выбрать жанр из предлагаемого списка и вставить обложку, перетащив ее мышкой из окошка проводника Windows в окошко book cover picture. Проверьте настройки - обязательно должна быть включена опция book for library. Нажимаем на кнопочку make book и ждем звукового сигнала, сигнализирующего о том, что книга готова.

В принципе теперь нужно провести валидацию получившегося файла. В случае возникновения ошибок автоматически включается очень удобный инструмент FictionBookInvestigator, в котором можно поправить неправильные куски кода. Он же вызывается в окне "Make Fiction Book File" кнопкой "load to FBI", которая активируется после создания fb2. FBI (Fiction Book Investigator) - это специализированный ручной редактор/валидатор fb2-файлов. По опциям - раз в несколько помощнее FBE.

Но я, обычно, завершаю на этом работу с FBD и перехожу к редактору FBE.

=== FBE - доводка до ума ===

Редактор FBE удобен тем, что позволяет редактировать как внешний вид, так и исходный код документа и хорошо выявляет его структуру. При раскрытии "дерева" оглавления все огрехи и недоработки видны сразу и их легко поправить.

Первым делом надо удостовериться, что структура документа красива и логична, нет лишнего дробления на секции, оглавление будет хорошо выглядеть. Как пример - разбитые на секции заголовки.

[[Image:brake_sec.jpg]]

Когда такой разбитый заголовок встречается в тексте это во-первых - некрасиво, а во-вторых неудобно, так как этот заголовок - название главы. Это - два заголовка одного уровня, поэтому можно смело объединить секции и избежать ненужного увеличения количества секций. Для этого, поставив курсор на верхнюю из объединяемых секций, надо нажать Alt+Del. После этого выделить заголовок, превратившийся в секцию, и перетащить его в заголовок. Убрать лишние пустые строки, или добавить их, если заголовок слишком длинный и получается некрасиво.

[[Image:no_brake_sec.jpg]]

Есть несколько пунктов, которые я правлю в любом документе, сделанном в FBD.
1. Аннотация. FBD, кроме создания отдельного пункта в description аод названием annotation дублирует ее в отдельную секцию сразу после автора и названия книги. Этот дубляж не очень удобен для последующего использования файла, поэтому эту секцию я удаляю целиком. Правая кнопка мыши Select->body/section, и правой же кнопкой Cut или Delete.

2. Часто валидацию не проходят файлы, в которых картинки идут друг за другом. Дело в том, что FBD не вставляет пустую строку между такими картинками, что требует схема, даже если вручную попытаться вставить строку. Поэтому, ставим курсор на вторую, третью и т.д. картинки и жмем Enter.

3. Правим цитаты. Как Вы помните, мы выделили цитаты как эпиграфы. Теперь надо сделать из них цитаты. Это удобнее делать в редакторе исходных кодов (View->Source). Находим поиском тег <epigraph> и смотрим чуть выше. Непосредственно перед ним идет разрыв секций, так как эпиграф может ставиться только в начале секции. А вот цитата может идти в любом месте секции, поэтому разрыв секций можно убрать, а вместо <nowiki><epigraph>...</epigraph> вставить <cite>...</cite> </nowiki>

Было

[[Image:FBE-epigraph.jpg]]

Стало

[[Image:FBE-cite.jpg]]

4. Пустые строки до и после названия главы. Такие строки встречаются крайне редко, но их нужно убирать по правилам создания валидного документа.

=== MTP - чистка сносок ===

В принципе, как я уже говорила, без этой программы можно было вполне обойтись. Но я ее люблю, а потому и расскажу. Она очень удобна, когда надо сделать массовую замену в файле (или нескольких файлах) текстовых конструкций с переменным текстом внутри на другие конструкции с тем же текстом. В принципе с тем же успехом можно применять BookCleaner, входящий в состав FBD, написав к нему соответствующий скрипт, и так, наверное, будет даже быстрее, но я пользуюсь MTP.

В этом процессоре есть свой, очень простой, язык макросов, текст на котором я приведу полностью.

Суть проблемы, которую надо решить, в том, что FBD и его автор категорически не согласны с правилами, установленными в fb2 относительно возвратных сносок. В формате возвратные ссылки в принципе разрешены, за исключением сносок. Поэтому, их приходится в обязательном порядке корректировать, чтобы библиотека приняла валидный файл. Кроме того, вид ссылок приводится к библиотечному стандарту.

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

1. Ликвидация маркировки параграфов.

Итак, в окошко ''ИСХОДНЫЙ ТЕКСТ'' пишем такой блок

<nowiki>TEXT="<p id=\""</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="\">"</nowiki>

а в окошко ''ЗАМЕНИТЬ НА'' - такой

<nowiki> TEXT="<p>"</nowiki>

и запускаем процессор.

[[Image:Blok1.jpg]]

2. Добавление в ссылки типа "сноска"

''ИСХОДНЫЙ ТЕКСТ''

<nowiki>TEXT="<a l:href=\""</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="\">"</nowiki>

''ЗАМЕНИТЬ НА''

<nowiki>TEXT="<a l:href=\""</nowiki>

<nowiki>NAME=BLOCK1</nowiki>

<nowiki>TEXT="\" type="note\">"</nowiki>

[[Image:Blok2.jpg]]

3. Определение номера сноски, как заголовка.

''ИСХОДНЫЙ ТЕКСТ''

<nowiki>TEXT="<p>["</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="]"</nowiki>

''ЗАМЕНИТЬ НА ''

<nowiki>TEXT=" <title>\n <p>"</nowiki>

<nowiki>NAME=BLOCK1</nowiki>

<nowiki>TEXT="</p>\n </title>\n <p>"</nowiki>

[[Image:Blok3.jpg]]

После такого количества правок файл готов к вычитке настолько, что встречающиеся ошибки не будут вызывать раздражения и желания забросить книгу в какой-нибудь дальний угол...

=== BD - для вычитки ===

Программой BookDesigner я пользуюсь для того, чтобы сделать файл для того устройства, на котором я читаю. Я бы совсем не упоминала здесь об этом, но есть яркий и красивый пример использования BookCleaner, программы, входящей как в BD, так и в FBD, и подсказанный мне разработчиком этих программ. Это - прекрасная иллюстрация того, как можно заменить MTP, написав небольшой скрипт.

Если Вы помните, BD и FBD не создают, не понимают и не отображают цитаты. В будущем это, скорее всего, изменится, но в настоящем - увы. А хотелось бы видеть в устройстве все форматирование fb2 - во-первых, во избежание возможных ошибок и некорректностей, а во-вторых красивую книгу просто приятно читать. Поэтому, чтобы в ридере иметь выделение цитат и был написан данный скрипт.

Пример для BD, должен быть установлен последний апдейт. В FBD тоже можно это делать, но там старый вариант Book Cleaner, скрипт тот же, но кнопки другие.

Tools -> Book Cleaner
script -> new

find what:
<nowiki><cite[^>]*> replace by: <SPAN id=cite><FONT color=red></nowiki>
RegExp: поставить галку.

table -> add row

find what:
<nowiki></cite> replace by: </FONT></SPAN></nowiki>

script -> save as -> "fb2cite"

input file: before formatting -> выбрать "fb2cite.bcf"
input file: after formatting -> none
output file (fb2): -> none

Закрыть Book Cleaner. После загрузки fb2 все cite будут выделены красным. Если внутри cite есть text-author, то он будет выделяться своим цветом.
При двойном клике на первую строку cite будет селектироваться весь элемент, а на 4-ой панели статуса появится его тип: cite

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

[[Image:BookCleaner.jpg]]

== Окончательный результат ==

Ну вот, мы и добрались до финиша. Вычитывает каждый на своем устройстве, поэтому вычитку описывать смысла нет, окончательная правка файла происходит в FBE, про который мы уже говорили, на выходе получаем довольно чистую от ошибок, красиво оформленную книгу, готовую к заливке в библиотеку. Работа эта долгая и нудноватая, но результат, на мой взгляд, окупает все усилия.

Приятного чтения!

--[[Участник:Marina Ch|Marina Ch]] 21:27, 4 октября 2006 (MSD)

[править]

Вычитка, редактура и создание fb2-файла с начала и до конца, с помощью FBD и не только

2006-10-04T18:54:26Z

Sclex: "францУСким"

==Зачем, или введение==

В последнее время автор данной статьи регулярно занимается вычиткой книг и созданием fb-файлов для библиотек. Так как мой способ сделать файл красивым и правильным нигде не описан, появилась данная статья. Автор ни в коем случае не претендует на то, что этот способ есть единственно верный и правильный, даже напротив, часть функций программ не используется (хотя и могло бы), но привычка и инерция мышления свойственны, увы, всем людям.

Все основные правила создания fb2-книг описаны в статье [[Как сделать книгу]], с которой советую ознакомиться.

В работе мною используется несколько программ:
* Microsoft Word, или MW (любая версия) - для предварительной правки документа и оформления ссылок
* [http://www.the-ebook.org/e107/download.php?view.19 FictionBookDesigner], или FBD - для красивого оформления книги, расстановки заголовков и вложенных частей и создания fb2-файла
* [http://haali.cs.msu.ru/pocketpc/scripts.html.ru FictionBookEditor], или FBE - для окончательной правки книги после вычитки и проверки ее валидности
* [http://www.the-ebook.org/e107/download.php?view.8 BookDesigner], или BD для изготовления из fb2 файла в формате устройства для чтения. [http://www.the-ebook.org/e107/e107_files/downloads/bd/Bd_Update_2006_09_13.zip Последний апдейт]
* [http://soft.primedance.ru/mtp.php MassTextProcessor], или MTP - для корректировки некоторых неточностей, недопустимых в библиотеках, но допустимых в FBD

В принципе, последнюю программу можно и опустить, в FBD имеются все необходимые инструменты, но я ее люблю за простоту использования, маленький размер и отсутствие необходимости ее инсталляции. Кроме того, она позволяет работать сразу с большим колличеством файлов, что, правда, здесь описываться не будет.

На вопрос - зачем я использую две программы одного типа (BD и FBD) ответ простой. Разница между BD и FBD есть и большая: FBD полностью юникдный, а BD - только частично. Т.е. если надо сделать книгу с языками, несовместимыми внутри одной локальной кодировки (например, русский и французский), то это только в FBD. Кроме того FBD сделан специально для изготовления fb2-файлов, а BD - всеяден. Он имеет множество форматов как на входе, так и на выходе.

Автор исходит из того, что вышеперечисленные программы у читателя имеются и установлены, кроме того, что у читателя есть минимальные навыки редактирования и сохранения текста.

Новичкам же настоятельно рекомендуется внимательно прочитать урок по редактированию в последнем апдейте BD: Help -> Self Teaching -> my first e-book.

==Последовательность работы==
=== MW, предварительная правка ===

Итак, файл, который приходит ко мне после сканирования и распознавания от сканщика находится в формате .rtf {RichTextFormat) который распознается и редактируется обычным MW. Посему, первым делом входим в Word. Главная задача этого этапа - оформить ссылки и исправить явный очень "кривой" текст.

Первым делом, чтобы не пропустить разрывы абзацев, выделяем весь текст и првой клавишей мышки вызываем меню. Проходим в пункт "Абзац" и выбираем "Отступ"->"Первая строка"->"Отступ".

[[Image:Абзац.jpg]]

Снова вызываем меню "Шрифт"->выбираем размер и тип шрифта всего документа. Это делается потому, что при распознавании текста часто смена типа или размера шрифта попадает на середину слова. В этом случае, при закачке файла в FBD в этом месте будет пробел.

Далее, "Сервис"->"Параметры"->"Правописание" проверяем, что стоят галочки: автоматически проверять орфографию, всегда предлагать замену, пропускать слова из прописных букв, пропускать слова с цифрами, пропускать адреса Интернета и имена файлов, автоматически проверять грамматику, также проверять орфографию. Делаем "Повторную проверку".

[[Image:Орфография.jpg]]

Есть несколько иной вариант работы с MW - подгрузка шаблона. Этот способ хорошо описан [http://www.oldmaglib.com/help/assistent.php тут], и повторяться я не буду. Мое единственное возражение к указанному способу - такого объемного форматирования FBD все равно не понимает, так стоит ли огород городить. Но, может, кому-то это будет приятнее или удобнее.

Затем начинается самая нудная и противная работа - просматриваем внимательно весь файл, исправляя ошибки и формируя сноски. В исходном файле сноски бывают двух видов - обозначаемые звездочкой и обозначаемые надстрочными цифрами. Сначала заходим "Вставка"->"Ссылка"->"Сноска", и настраиваем. Сноски должны быть внизу текста, формат номера 1,2,3..., начать с 1, нумерация продолжить. Применяем сделанные изменения. Далее "Сервис"->"Настройка"->"Команды", в левом окошечке выбираем "Вставка" и из правого перетаскиваем мышкой команду "Сноска..." на панель инструментов.

[[Image:Сноски.jpg]]

При появлении сноски в тексте, устанавливаем курсор на место сноски и мышкой щелкаем по появившейся кнопке на панели инструментов. В возникшее внизу окошко перекидываем текст сноски.

[[Image:Общий_вид.jpg]]

Дойдя до конца файла проверяем дополнительно поиском, нет ли потерявшихся сносок.

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

Сохраняем файл и выходим из MW.

=== FBD - изготовление fb2-файла ===

В принципе, все здесь описанное - это просто последовательность действий, предпринимаемых лично мной. Для краткого ознакомления с возможностями программы рекомендую статью про изготовление книг [[BookDesigner 4.x - как быстро и правильно делать ebook]].

Перед открытием файла с помощью FBD, особенно при первом использовании, имеет смысл проверить настройки этой программы. У меня настроено так. Самое главное - проверить, если многоязыковая поддержка для книг с испанским, французским и тому подобными языками. Кроме того, я всегда сохраняю исходный формат и часто пользуюсь определением заголовков не только по ключевым словам, но и по выделенному тексту, так как часто при распозновании названия глав выделяются жирным шрифтом.

[[Image:Настройки_FBD.jpg]]

Вызов этого меню происходит с помощью кнопки [[Image:Настройить.jpg]]

После проведения всех предварительных настроек рекомендуется перезагрузить файл, чтобы они были применены к нему. Дальше следует опять длительная и нудная работа - пролистывание всей книги и проверка заголовков. Часть ошибок определяется и правится на этой стадии работы. Сразу оговорюсь, для выделения куска текста надо дважды щелкнуть по нему мышкой. В этом случае выделяется абзац. Если надо выделить больше одного абзаца - сначала выделить первый двойным щелчком, а потом перейти к последнему и Shift+щелчок мышкой. Только в этом случае выделение текста будет 100% правильным. Все команды BookCorrector применяются только к выделенному тексту.

[[Image:Корректор.jpg]]

Сначала проверяем, правильно ли определился автор и название книги. Если нет - корректируем с помощью BookCorrector (выбрать соответственно book author и book title). Затем определяем аннотацию (если она есть) как аннотацию (BookCorrector annotation). Далее ищем все заголовки (BookCorrector title), эпиграфы (epigraph), стихи (verse) и цитаты. С цитатами (письмами и т.п.) сложнее всего! Дело в том, что они не поддерживаются BookDesigner как отдельная функция. В связи с чем, чтобы получить красивый и грамотно сделанный файл приходится поизвращаться. Лично я делаю так: выделяю текст, как эпиграф, и потом правлю в FBE.

Кроме того, в эпиграфах, стихотворениях и цитатах может быть автор текста, которого следует оформить, как text author.

После выделения всех заголовков надо сформировать будущую структуру книги. На этом этапе очень удобен в использовании FictionBookSectionEditor. Он вызывается с помощью иконки
[[Image:Дерево.jpg]] и выглядит так

[[Image:Секция.jpg]]

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

[[Image:Секция1.jpg]]

После чего обязательно нажимаем кнопочку apply, чтобы записать текущее расположение секций. ВНИМАНИЕ! Если вы выйдите из редактора секций и снова войдете в него секции снова будут выглядеть неразмеченными! Ваши изменения в редакторе станут не видны! Поэтому, не выходите из редактора секций до получения желаемого результата!

Осталось сделать последнее перед собственно изготовлением fb2-файла - отформатировать сноски. Для этого выделите сноски и сделайте Format->selected notes.

Теперь можно вызвать меню создания FB2.

[[Image:Изготовление.jpg]]

Если Вы все сделали правильно, то поля автора, названия книги и аннотации уже заполнены. Вам останется выбрать жанр из предлагаемого списка и вставить обложку, перетащив ее мышкой из окошка проводника Windows в окошко book cover picture. Проверьте настройки - обязательно должна быть включена опция book for library. Нажимаеи на кнопочку make book и ждем звукового сигнала, сигнализирующего о том, что книга готова.

В принципе теперь нужно провести валидацию получившегося файла. В случае возникновения ошибок автоматически включается очень удобный инструмент FictionBookInvestigator, в котором можно поправить неправильные куски кода. Он же вызывается в окне "Make Fiction Book File" кнопкой "load to FBI", которая активируется после создания fb2. FBI (Fiction Book Investigator) - это специализированный ручной редактор/валидатор fb2-файлов. По опциям - раз в несколько помощнее FBE.

Но я, обычно, завершаю на этом работу с FBD и перехожу к редактору FBE.

=== FBE - доводка до ума ===

Редактор FBE удобен тем, что позволяет редактировать как внешний вид, так и исходный код документа и хорошо выявляет его структуру. При раскрытии "дерева" оглавления все огрехи и недоработки видны сразу и их легко поправить.

Первым делом надо удостовериться, что структура документа красива и логична, нет лишнего дробления на секции, оглавление будет хорошо выглядеть. Как пример - разбитые на секции заголовки.

[[Image:brake_sec.jpg]]

Когда такой разбитый заголовок встречается в тексте это во-первых - некрасиво, а во-вторых неудобно, так как этот заголовок - название главы. Это - два заголовка одного уровня, поэтому можно смело объединить секции и избежать ненужного увеличения количества секций. Для этого, поставив курсор на верхнюю из объединяемых секций, надо нажать Alt+Del. После этого выделить заголовок, превратившийся в секцию, и перетащить его в заголовок. Убрать лишние пустые строки, или добавить их, если заголовок слишком длинный и получается некрасиво.

[[Image:no_brake_sec.jpg]]

Есть несколько пунктов, которые я правлю в любом документе, сделанном в FBD.
1. Аннотация. FBD, кроме создания отдельного пункта в description аод названием annotation дублирует ее в отдельную секцию сразу после автора и названия книги. Этот дубляж не очень удобен для последующего использования файла, поэтому эту секцию я удаляю целиком. Правая кнопка мыши Select->body/section, и правой же кнопкой Cut или Delete.

2. Часто валидацию не проходят файлы, в которых картинки идут друг за другом. Дело в том, что FBD не вставляет пустую строку между такими картинками, что требует схема, даже если вручную попытаться вставить строку. Поэтому, ставим курсор на вторую, третью и т.д. картинки и жмем Enter.

3. Правим цитаты. Как Вы помните, мы выделили цитаты как эпиграфы. Теперь надо сделать из них цитаты. Это удобнее делать в редакторе исходных кодов (View->Source). Находим поиском тег <epigraph> и смотрим чуть выше. Непосредственно перед ним идет разрыв секций, так как эпиграф может ставиться только в начале секции. А вот цитата может идти в любом месте секции, поэтому разрыв секций можно убрать, а вместо <nowiki><epigraph>...</epigraph> вставить <cite>...</cite> </nowiki>

Было

[[Image:FBE-epigraph.jpg]]

Стало

[[Image:FBE-cite.jpg]]

4. Пустые строки до и после названия главы. Такие строки встречаются крайне редко, но их нужно убирать по правилам создания валидного документа.

=== MTP - чистка сносок ===

В принципе, как я уже говорила, без этой программы можно было вполне обойтись. Но я ее люблю, а потому и расскажу. Она очень удобна, когда надо сделать массовую замену в файле (или нескольких файлах) текстовых конструкций с переменным текстом внутри на другие конструкции с тем же текстом. В принципе с тем же успехом можно применять BookCleaner, входящий в состав FBD, написав к нему соответствующий скрипт, и так, наверное, будет даже быстрее, но я пользуюсь MTP.

В этом процессоре есть свой, очень простой, язык макросов, текст на котором я приведу полностью.

Суть проблемы, которую надо решить, в том, что FBD и его автор категорически не согласны с правилами, установленными в fb2 относительно возвратных сносок. В формате возвратные ссылки в принципе разрешены, за исключением сносок. Поэтому, их приходится в обязательном порядке корректировать, чтобы библиотека приняла валидный файл. Кроме того, вид ссылок приводится к библиотечному стандарту.

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

1. Ликвидация маркировки параграфов.

Итак, в окошко ''ИСХОДНЫЙ ТЕКСТ'' пишем такой блок

<nowiki>TEXT="<p id=\""</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="\">"</nowiki>

а в окошко ''ЗАМЕНИТЬ НА'' - такой

<nowiki> TEXT="<p>"</nowiki>

и запускаем процессор.

[[Image:Blok1.jpg]]

2. Добавление в ссылки типа "сноска"

''ИСХОДНЫЙ ТЕКСТ''

<nowiki>TEXT="<a l:href=\""</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="\">"</nowiki>

''ЗАМЕНИТЬ НА''

<nowiki>TEXT="<a l:href=\""</nowiki>

<nowiki>NAME=BLOCK1</nowiki>

<nowiki>TEXT="\" type="note\">"</nowiki>

[[Image:Blok2.jpg]]

3. Определение номера сноски, как заголовка.

''ИСХОДНЫЙ ТЕКСТ''

<nowiki>TEXT="<p>["</nowiki>

<nowiki>NAME=BLOCK1 MAXLENGTH=20</nowiki>

<nowiki>TEXT="]"</nowiki>

''ЗАМЕНИТЬ НА ''

<nowiki>TEXT=" <title>\n <p>"</nowiki>

<nowiki>NAME=BLOCK1</nowiki>

<nowiki>TEXT="</p>\n </title>\n <p>"</nowiki>

[[Image:Blok3.jpg]]

После такого количества правок файл готов к вычитке настолько, что встречающиеся ошибки не будут вызывать раздражения и желания забросить книгу в какой-нибудь дальний угол...

=== BD - для вычитки ===

Программой BookDesigner я пользуюсь для того, чтобы сделать файл для того устройства, на котором я читаю. Я бы совсем не упоминала здесь об этом, но есть яркий и красивый пример использования BookCleaner, программы, входящей как в BD, так и в FBD, и подсказанный мне разработчиком этих программ. Это - прекрасная иллюстрация того, как можно заменить MTP, написав небольшой скрипт.

Если Вы помните, BD и FBD не создают, не понимают и не отображают цитаты. В будущем это, скорее всего, изменится, но в настоящем - увы. А хотелось бы видеть в устройстве все форматирование fb2 - во-первых, во избежание возможных ошибок и некорректностей, а во-вторых красивую книгу просто приятно читать. Поэтому, чтобы в ридере иметь выделение цитат и был написан данный скрипт.

Пример для BD, должен быть установлен последний апдейт. В FBD тоже можно это делать, но там старый вариант Book Cleaner, скрипт тот же, но кнопки другие.

Tools -> Book Cleaner
script -> new

find what:
<nowiki><cite[^>]*> replace by: <SPAN id=cite><FONT color=red></nowiki>
RegExp: поставить галку.

table -> add row

find what:
<nowiki></cite> replace by: </FONT></SPAN></nowiki>

script -> save as -> "fb2cite"

input file: before formatting -> выбрать "fb2cite.bcf"
input file: after formatting -> none
output file (fb2): -> none

Закрыть Book Cleaner. После загрузки fb2 все cite будут выделены красным. Если внутри cite есть text-author, то он будет выделяться своим цветом.
При двойном клике на первую строку cite будет селектироваться весь элемент, а на 4-ой панели статуса появится его тип: cite

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

[[Image:BookCleaner.jpg]]

== Окончательный результат ==

Ну вот, мы и добрались до финиша. Вычитывает каждый на своем устройстве, поэтому вычитку описывать смысла нет, окончательная правка файла происходит в FBE, про который мы уже говорили, на выходе получаем довольно чистую от ошибок, красиво оформленную книгу, готовую к заливке в библиотеку. Работа эта долгая и нудноватая, но результат, на мой взгляд, окупает все усилия.

Приятного чтения!

--[[Участник:Marina Ch|Marina Ch]] 21:27, 4 октября 2006 (MSD)

[править]

Обсуждение:Вычитка, редактура и создание fb2-файла с начала и до конца, с помощью FBD и не только

2006-10-04T18:52:37Z

Sclex:

Самое главное - проверить, если многоязыковая поддержка для книг с испанским, француским и тому подобными языками.

Неясно, что имеется в виду в этом предложении. Возможно вместо "если" должно быть "есть ли".

--[[Участник:Sclex|Sclex]] 22:52, 4 октября 2006 (MSD)

Описание формата FB2 от Sclex

2006-09-05T08:02:59Z

Sclex: /* Заголовки */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки частей книги описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' как заголовок части книги может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line/>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

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

Подзаголовки описываются тэгом '''<subtitle>''', который содержит простой (неформатированный) текст. Тэг '''<subtitle>''' может быть вложенным в тэги '''<body>''' и '''<section>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''.
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''binary'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]

Описание формата FB2 от Sclex

2006-09-05T07:57:52Z

Sclex: /* Заголовки */

{{Toc-Right}}
=== FB2-файл - это файл XML ===

FB2-документ является файлом в формате XML.

'''XML''' (англ. Extensible Markup Language ? расширяемый язык разметки; произносится [икс-эм-э?л]) ? рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий из себя свод общих синтаксических правил. XML предназначен для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями.

Ниже приведён пример простого кулинарного рецепта, размеченного с помощью XML:

<?xml version="1.0" encoding="UTF-8"?>

<Recipe name="хлеб" prep_time="5 мин" cook_time="3 час">
<название>Простой хлеб</название>
<ingredient amount="3" unit="стакан">Мука</ingredient>
<ingredient amount="0.25" unit="грамм">Дрожжи</ingredient>
<ingredient amount="1.5" unit="стакан">Тёплая вода</ingredient>
<ingredient amount="1" unit="чайная ложка">Соль</ingredient>
<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>
</Recipe>

''Обратите внимание, что названия и значения элементов и атрибутов могут состоять не только из букв латинского алфавита, но десятичным разделителем может быть только точка.''

Первая строка XML-документа называется '''объявлением XML''' ? это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

Остальная часть этого XML-документа состоит из вложенных ''элементов'', некоторые из которых имеют ''атрибуты'' и ''содержимое''. '''Элемент''' обычно состоит из открывающего и закрывающего тегов (меток), обрамляющих текст и другие элементы. '''Открывающий тег''' состоит из имени элемента в угловых скобках, например ?<code><step></code>?; '''закрывающий тег''' состоит из того же имени в угловых скобках, но перед именем ещё добавляется косая черта, например ?<code></step></code>?. '''Содержимым элемента''' называется всё, что расположено между открывающим и закрывающим тегами, включая текст и другие (вложенные) элементы. Ниже приведён пример XML-элемента, который содержит открывающий тег, закрывающий тег и содержимое элемента:

<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>

Кроме содержания у элемента могут быть '''атрибуты''' ? пары имя-значение, добавляемые в открывающий тег после названия элемента. Значения атрибутов всегда заключаются в кавычки (одинарные или двойные), одно и то же имя атрибута не может встречаться дважды в одном элементе. Не рекомендуется использовать разные типы кавычек для значений атрибутов одного тега.

<ingredient amount="3" unit="стакан">Мука</ingredient>

В приведённом примере у элемента ?ingredient? есть два атрибута: ?amount?, имеющий значение ?3?, и ?unit?, имеющий значение ?стакан?. С точки зрения XML-разметки, приведённые атрибуты не несут никакого смысла, а являются просто набором символов.

Кроме текста элемент может содержать другие элементы:

<Instructions>
<step>Смешать все ингредиенты и тщательно замесить.</step>
<step>Закрыть тканью и оставить на один час в тёплом помещении.</step>
<step>Замесить ещё раз, положить на противень и поставить в духовку.</step>
</Instructions>

В данном случае элемент ?Instructions? содержит три элемента ?step?. XML не допускает перекрывающихся элементов. Например, приведённый ниже фрагмент некорректен, так как элементы ?em? и ?strong? перекрываются.


<p>Обычный <em>акцентированный <strong>выделенный и акцентированный</em> выделенный</strong></p>

Каждый XML-документ должен содержать в точности один '''корневой элемент''' или ''document element''), таким образом, следующий фрагмент не может считаться корректным XML-документом.


<thing>Cущность ?1</thing>
<thing>Cущность ?2</thing>

Для обозначения элемента без содержания, называемого '''пустым элементом''', допускается применять особую форму записи, состоящую из одного тега, в котором после имени элемента ставится косая черта. Следующие фрагменты полностью равнозначны:

<foo></foo>

<foo/>

В XML определены два метода записи специальных символов: ссылка на сущность и ссылка по номеру символа. '''Сущностью''' в XML называются именованные данные, обычно текстовые, в частности спецсимволы. '''Ссылка на сущность''' указывается в том месте, где должна быть сущность и состоит из амперсанда (?<code>&</code>?), имени сущности и точки с запятой (?<code>;</code>?). В XML есть несколько предопределённых сущностей, таких как ?lt? (ссылаться на неё можно написав ?<code>&lt;</code>?) для левой угловой скобки и ?amp? (ссылка ? ?<code>&amp;</code>?) для амперсанда, возможно также определять собственные сущности. Помимо записи с помощью сущностей отдельных символов, их можно использовать для записи часто встречающихся текстовых блоков. Ниже приведён пример использования предопределённой сущности для избежания использования знака амперсанда в названии:

<company-name>AT&amp;T</company-name>

Полный список предопределённых сущностей состоит из &amp; (?&?), &lt; (?<?), &gt; (?>?), &apos; (?'?), и &quot; (?"?) ? последние две полезны для записи разделителей внутри значений атрибутов. Определить свои сущности можно в [[DTD]]-документе.
Иногда бывает необходимо определить неразрывный пробел, который в HTML обозначается как &nbsp; в XML его записывают &#160;

'''Cсылка по номеру символа''' выглядит как ссылка на сущность, но вместо имени сущности указывается символ <code>#</code> и число (в десятичной или шестнадцатеричной записи), являющееся номером символа в кодовой таблице Юникод. Это обычно символы, которые невозможно закодировать напрямую, например буква арабского алфавита в ASCII-кодированном документе. Амперсанд может быть представлен следующим образом:

<company-name>AT&#038;T</company-name>

Существует ещё множество правил, касающихcя составления корректного XML-документа, но целью данного краткого обзора было лишь показать основы, необходимые для понимания структуры XML-документа.

=== Общая структура документа. Кодировки ===
FB2-документ состоит из объявления XML и корневого элемента <FictionBook>. То есть выглядит это так:

<pre>
<?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
...
</FictionBook>
</pre>

Как видно, в первой строке в значении атрибута encoding надо правильно указать кодировку документа. В приведенном примере это windows-1251, а в другом случае могла бы быть и utf-8.

Ниже указано, какая кодировка каким языкам соответствует:
<pre>
windows-1251 - английский и кириллица (русский, болгарский и т.д.)
windows-1252 - западно-европейские языки (английский, французский, испанский и т.д.)
windows-1250 - английский и восточно-европейские (польский, чешский и т.д.)
</pre>

=== Раздел FictionBook ===

Этот раздел начинается сразу за первой строкой и открывается таким образом:

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

А закрывается в самом конце FB2-документа.

В '''xmlns:l''' вместо l может быть написано и другое имя, главное, чтобы потом оно использовалось в ссылках по всему документу. То есть, если объявлено '''xmlns:l="http://www.w3.org/1999/xlink"''', то ссылки надо оформлять как '''<a l:href=...>...</a>''', а если объявлено '''xmlns:xlink="http://www.w3.org/1999/xlink"''', то надо так: '''<a xlink:href=...>...</a>'''. Аналогично и для ссылок в тэгах '''<image/>'''.

Раздел FictionBook состоит из вложенных подразделов в указанном ниже порядке:

#'''<description>''' ? который описывает заголовок документа. ''Одно и только одно вхождение.'' (фразы вроде "одно и только одно вхождение" говорят, сколько раз подряд может идти данный тэг в данном месте документа)
#'''<body>''' ? описывает тело документа. ''Одно или более вхождений''.
#'''<binary>''' ? содержит приложенные к файлу двоичные объекты ? картинки и прочее. ''Любое число вхождений''.

Иными словами, присутствуют как минимум разделы '''<description>''' с '''<body>''', а остальное ? по необходимости.

Пример:

<pre><?xml version="1.0" encoding="windows-1251"?>
<FictionBook xmlns="http://www.gribuser.ru/xml/fictionbook/2.0"
xmlns:l="http://www.w3.org/1999/xlink">
<description>
...
</description>
<body>
...
</body>
<body name="notes">
...
</body>
<binary id="cover.jpg" content-type="image/jpeg">/9j/
4AAQSkZJRgABAgAAZABkAAD/
...
</binary>
</FictionBook>
</pre>

=== Поля раздела description ===

Раздел '''<description>''' состоит из перечисленных ниже частей в указанном порядке:

#'''<title-info>''' ? данные о книге. ''Одно и только одно вхождение''.
#'''<src-title-info>''' ? данные об исходнике книги (до перевода). ''От нуля до одного вхождений''.
#'''<document-info>''' ? информация об FB2-документе. ''Одно и только одно вхождение''.
#'''<publish-info>''' ? сведения об издании книги, которая была использована как источник при подготовке документа. ''От нуля до одного вхождений''.
#'''<custom-info>''' ? произвольная информация. ''Любое число вхождений''.

То есть обязательны разделы '''<title-info>''' и '''<document-info>''', а остальные добавляются по необходимости.

Рассмотрим пример заполнения его полей (они должны следовать в указанном порядке):

<pre> <description>
<title-info>
<genre>sci_medicine</genre>
<genre>science</genre>
<author>
<first-name>Борис</first-name>
<last-name>Сергеев</last-name>
</author>
<book-title>Ум хорошо?</book-title>
<annotation>
<p>Об организации высших психических функций.</p>
</annotation>
<date value="1984-01-01">1984</date>
<coverpage><image l:href="#cover.jpg"/></coverpage>
<lang>ru</lang>
<src-lang>ru</src-lang>
<sequence name="Раскрывая тайны психики" number="2"/>
</title-info>
<document-info>
<author>
<nickname>Sclex</nickname>
<email>sclex_at_inbox.ru</email>
</author>
<program-used>Dn/2, Opera 8.50, Bred3</program-used>
<date value="2006-05-21">2006-05-21</date>
<id>91824ABE-EEF7-48C3-AAAA-A719EFC4824A</id>
<version>1.1</version>
<history>
<p>1.0 - подготовка fb2 by Sclex</p>
<p>1.1 - вычитка ошибок by Sclex</p>
</history>
</document-info>
<publish-info>
<book-name>Борис Федорович Сергеев. Ум хорошо?</book-name>
<publisher>Молодая гвардия</publisher>
<city>М.</city>
<year>1984</year>
</publish-info>
</description>
</pre>

Рассмотрим последовательно смысл значений тэгов заголовка. (Некоторые из тэгов отсутствуют в примере, но описаны ниже).

Внутри раздела '''<title-info>''':

'''<genre>''' ? указывает жанр книги. Список возможных значений приведен в соответствующем разделе данного описания. ''Любое число вхождений'', то есть книга может относиться к нескольким жанрам одновременно. В нашем примере это sci_medicine и science, то есть книга относится к жанрам "Медицина" и "Научно-образовательная: Прочее".

'''<author>''' ? содержит информацию об авторе книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений'', так как может быть несколько авторов у одной книги. В нашем примере определены имя Борис и фамилия Сергеев.

'''<book-title>''' ? описывает название книги. ''Одно и только одно вхождение''. В нашем примере книга называется "Ум хорошо?".

'''<annotation>''' ? аннотация книги. ''Возможны в любом количестве и порядке'' следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождения''.

'''<keywords>''' ? содержит ключевые слова к данной книге для поисковых систем. Слова должны быть в виде неформатированного текста. ''От нуля до одного вхождения''.

'''<date>''' ? хранит дату написания книги. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''От нуля до одного вхождения.'' В нашем примере свойство '''value''' имеет значение 1984-01-01, то есть первое января 1984-го года, а внутри тэга прописано значение 1984.

'''<coverpage>''' ? обложка книги. Внутри может содержать только тэг '''<image/>'''. ''От нуля до одного вхождения.'' В нашем примере ссылка указывает на картинку cover.jpg, приложенную к документу (значок # говорит, что эта ссылка локальная, то есть адресует в пределах документа).

'''<lang>''' ? сообщает язык книги в документе, то есть язык после перевода. ''Одно и только одно вхождение.'' В нашем примере это '''ru''', то есть русский язык. Полный список кодов приведен в соответствующем разделе данного описания.

'''<src-lang>''' ? определяет язык, на котором исходно написана книга, то есть язык до перевода. ''От нуля до одного вхождений''. Те же коды, что для тэга '''<lang>'''. В нашем примере это '''ru''', то есть русский язык. Английскому языку соответствует код '''en'''.

'''<translator>''' ? информация о переводчике книги. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Любое число вхождений.''

'''<sequence>''' ? сведения о том, к каким сериям относится книга. Имеет такие свойства, как '''name''' (текстовая строка) ? название серии, и '''number''' (целое число) ? порядковый номер книги в серии. ''Любое число вхождений''. В нашем примере описана серия "Раскрывая тайны психики", и указан номер книги в серии ? вторая.

Внутри раздела '''<document-info>''':

'''<author>''' ? содержит информацию об авторе документа. Возможны такие вложенные тэги как '''<first-name>''' ? имя, '''<last-name>''' ? фамилия, '''<middle-name>''' ? отчество, '''<nick>''' ? ник, и '''<email>''' ? адрес электронной почты. ''Одно или более вхождений''. В нашем примере определены ник Sclex и адрес электронной почты sclex_at_inbox.ru.

'''<program-used>''' ? в виде простого перечисляет программы, использованные при создании FB2-документа. ''От нуля до одного вхождений''. В нашем примере это Dn/2, Opera 8.50 и Bred3.

'''<date>''' ? хранит дату создания документа. В свойстве '''value''' дата описывается в формате ГГГГ-ММ-ДД, а внутри тэга дата задается в текстовом виде. ''Одно и только одно вхождение''. В нашем примере свойство '''value''' имеет значение 2006-05-21, то есть 21-е мая 2006-го года, и такое же значение прописано внутри тэга.

'''<src-url>''' ? URL страницы, откуда взят текст для подготовки документа. ''Любое число вхождений''.

'''<src-ocr>''' ? автор текста, который был использован при подготовке документа. Но не тот автор, который написал книгу, а тот, который сканировал ее и подготовил электронный текст. ''От нуля до одного вхождений''.

'''<id>''' ? уникальный идентификатор документа FB2. Каждый отдельный FB2-документ должен иметь собственный ID, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, ID нужно сохранить. Если же создается новая книга, это поле необходимо заполнить уникальной записью. Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. ''Одно и только одно вхождение''.

'''<version>''' ? версия документа в текстовом виде. Описывается дробным числом. ''Одно и только одно вхождение''. В нашем случае ? 1.1.

'''<history>''' ? история создания и изменения документа. Содержит форматированный текст. Возможны в любом количестве и порядке следующие вложенные тэги: '''<nowiki><p></nowiki>''', '''<poem>''', '''<nowiki><cite></nowiki>''', '''<subtitle>''', '''<nowiki><table></nowiki>''', '''<empty-line/>''' с соответствующим содержанием. ''От нуля до одного вхождений''.

Внутри тэга '''<publish-info>''':

'''<book-name>''' ? название оригинальной (бумажной) книги. ''От нуля до одного вхождений''. В примере это "Борис Федорович Сергеев. Ум хорошо?".

'''<publisher>''' ? название издательства. ''От нуля до одного вхождений''. В примере ? Молодая гвардия.

'''<city>''' ? город, в котором издана книга. ''От нуля до одного вхождений''. В нашем случае это М., то есть Москва.

'''<year>''' ? год издания книги. ''От нуля до одного вхождений''. В нашем случае ? 1984.

=== Тело документа (структура разделов body и section) ===

Тэг '''<body>''' предназначен для описания собственно тела документа. Этот тэг может иметь свойство '''name''', которое описывает имя раздела. Например:

<pre><body name="notes"></pre>

Внутри раздела '''<body>''' могут идти в указанном порядке:

#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Раздел '''<section>'''. ''Любое число вхождений''.

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

Для раздела '''<section>''' имя описывается свойством '''id'''. Например так:

<pre><section id="note33"></pre>

Раздел '''<section>''' состоит из следующих частей в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Картинка '''<image/>''', которая будет отображаться вверху раздела. ''От нуля до одного вхождений''.
#Аннотация '''<annotation>''', описывающая раздел. ''От нуля до одного вхождений''.
#Либо подраздел '''<section>''' (''любое число вхождений''), либо форматированный текст с картинками (''любое число вхождений'').

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

Разделов '''<body>''' в документе может быть несколько. Это используется, например, для оформления примечаний (footnotes). По умолчанию пользователю показывается первый раздел '''<body>''', а содержание остальных должно быть доступно по гиперссылкам. Имя раздела должно отражать смысл его содержания, но для основного раздела это необязательно.

Разделы '''<section>''' должны иметь вложенную структуру согласно иерархии оглавления. Например, если документ делится на части, которые в свою очередь делятся на главы, то части будут будут описаны в разделе '''<section>''' первого уровня, а главы ? в подразделе второго уровня. Проще понять это на примере:

<pre><body>
<title><p>Борис Сергеев</p><p>Парадоксы мозга</p></title>
<section>
<title><p>Часть 1. Великие невежды.</p></title>
<section>
<title><p>Глава 1. Во тьме веков.</p></title>
<p>Когда люди стали о себе задумываться? ...</p>
...
</section>
</section>
</body>
</pre>

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

Еще принято кроме того, что указано в заголовке, давать имя автора и название книги в тексте документа до того, как открывается '''<section>''' первого уровня, то есть в '''<title>''', относящемся к '''<body>'''. Это видно из вышеприведенного примера.

=== Форматированный текст ===

Форматированный текст представляет собой последовательность фрагментов, ограниченных тэгами '''<nowiki><p></nowiki>''', '''<poem>''', '''<subtitle>''', '''<nowiki><cite></nowiki>''', '''<nowiki><table></nowiki>'''. Также могут входить пустые строки ? '''<empty-line/>'''.

Тэг '''<nowiki><p></nowiki>''' предназначен для описания одного абзаца текста книги.

Например:

<pre><p>Вот абзац текста.</p>
<p>Еще один абзац текста.</p></pre>

=== Пустые строки ===

Если нужно в форматированном тексте вставить пустую строку, это делается с помощью тэга '''<empty-line/>'''. Один такой тэг ? одна пустая строка. Закрывающий тэг в данном случае не требуется.

Например:

<pre><p>Абзац до пустой строки.</p>
<empty-line/>
<p>А вот это уже абзац после пустой строки.</p>
</pre>

=== Жирный и курсивный текст ===

Для форматированного текста, а именно внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''' возможно описать текст как жирный или курсивный. Жирный текст следует выделить тэгом '''<nowiki><strong></nowiki>''', а курсивный ? тэгом '''<emphasis>'''.

Например:

<pre><p>Вот это слово выведем <strong>жирным</strong>,
а вот это ? <emphasis>курсивным</emphasis>.</p></pre>

=== Степени и индексы ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание как индекс или степень. Для индексов (маленькие буквы внизу строки) используется выделение тэгом '''<nowiki><sub></nowiki>''', а для степеней (маленькие буквы вверху строки) - выделение тэгом '''<nowiki><sup></nowiki>'''.

Пример:

<pre>
<p>2<sup>4</sup>=16</p>
<p>a<sub>1</sub>+a<sub>2</sub>=b</p>
</pre>

=== Перечеркнутый текст ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<v>''', '''<subtitle>''', '''<nowiki><text-author></nowiki>''') можно задать для текста отображение перечеркнутым шрифтом. Для этого используется выделение тэгом '''<nowiki><strikethrough></nowiki>'''.

<pre>
<p><strikethrough>Перечеркнутый текст.</strikethrough></p>
</pre>

=== Текст моноширинным шрифтом ===

В форматированном тексте (внутри тэгов '''<nowiki><p></nowiki>''', '''<nowiki><v></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><text-author></nowiki>''') можно задать для текста начертание моноширинным шрифтом (то есть шрифтом, символы которого имеют одинаковую ширину). Для этого используется выделение тэгом '''<nowiki><code></nowiki>'''.

<pre>
<p><code>Буквы одинаковой ширины.</code></p>
</pre>

=== Заголовки ===

Заголовки описываются тэгом '''<title>''', который содержит в себе форматированный текст. Тэг '''<title>''' может быть вложенным в тэги '''<body>''' и '''<section>''', причем ''более одного заголовка в разделе не допускается, а может его и не быть вовсе''.

В тэг '''<title>''' могут быть вложены только тэги '''<nowiki><p></nowiki>''' и/или '''<empty-line>'''.

Вот пример правильного оформления заголовка с пустой строкой:

<pre><title>
<p>Глава 1</p>
<empty-line/>
<p>От Александрии до Лондона</p>
</title></pre>

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

Подзаголовки описываются тэгом '''<subtitle>''', который содержит простой (неформатированный) текст. Тэг '''<subtitle>''' может быть вложенным в тэги '''<body>''' и '''<section>'''.

Обычно описание подзаголовка выглядит так:

<pre><subtitle>* * *<subtitle></pre>

Подзгаловком, в отличие от нормального заголовка, оформляется элемент оглавления, незначимый для структуры документа. Обычно это те самые три звездочки или x x x.

=== Стихи ===

Чтобы разместить стихотворение в тексте документа, используют тэг '''<poem>'''. Он может нести внутри себя следующие части в указанном порядке:

#Заголовок '''<title>'''. ''От нуля до одного вхождений''.
#Эпиграф '''<epigraph>'''. ''Любое число вхождений''.
#Строфы '''<stanza>'''. ''Одно или более вхождений''. Строфа '''<stanza>''' ? это группа строк стихотворения, отделенная пустым промежутком от остальных строк. Отдельная строка стихотворения помечается тэгом '''<v>''', который должен быть вложен в '''<stanza>'''.
#Автор стихотворения '''<text-author>'''. ''Любое число вхождений''.
#Дата написания '''<date>'''. ''От нуля до одного вхождений''.

То есть обязательно присутствует как минимум одна строфа '''<stanza>''', а остальное добавляется при необходимости.

Например, стихотворение из двух строф:

''Наша Таня громко плачет,''

''Уронила в речку мячик.''

''Тише, Танечка, не плачь,''

''Не утонет в речке мяч.''

Следует разметить таким образом:

<pre><poem>
<stanza>
<v>Наша Таня громко плачет,</v>
<v>Уронила в речку мячик.</v>
</stanza>
<stanza>
<v>Тише, Танечка, не плачь,</v>
<v>Не утонет в речке мяч.</v>
</stanza>
</poem></pre>

=== Эпиграфы ===

Для оформления эпиграфов предусмотрен тэг '''<epigraph>''', который должен содержать внутри себя форматированный текст ? тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><cite></nowiki>''', '''<nowiki><empty-line/></nowiki>''' (''любое число вхождений''), а затем автора текста '''<nowiki><text-author></nowiki>''' (''тоже любое число вхождений'').

Пример:

<pre><epigraph>
<p>Читателям, которые станут доискиваться, какие реальные
люди и места описаны здесь под вымышленными именами и названиями,
я бы посоветовал посмотреть вокруг себя и заглянуть в собственную душу,
так как в этом романе рассказано о том, что происходит сегодня почти
во всей Америке.</p>
</epigraph></pre>

Тэг '''<epigraph>''' может быть вложен в тэги '''<body>''', '''<section>''' и '''<poem>'''.

=== Цитированный текст ===

Для разметки цитированного текста существует тэг '''<nowiki><cite></nowiki>''', который может содержать форматированный текст ? вложенные тэги '''<nowiki><p></nowiki>''', '''<nowiki><poem></nowiki>''', '''<nowiki><empty-line/></nowiki>''', '''<nowiki><subtitle></nowiki>''', '''<nowiki><table></nowiki>''' (''любое число вхождений''), а затем автора цитаты '''<nowiki><text-author></nowiki>''' (''любое число вхождений'').

Пример:

<pre><cite>
<p>Время ? деньги.<p>
<text-author>Бенджамин Франклин</text-author>
</cite>
</pre>

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

Внутри тэгов '''<poem>''', '''<nowiki><cite></nowiki>''' и '''<epigraph>''' возможно указать автора соответственно стихотворения, цитаты или эпиграфа. Для этого служит тэг '''<text-author>'''. Этот тэг должен стоять в самом конце родительского тэга, то есть непосредственно перед его закрытием. ''Допускается любое число вхождений тэга '''<text-author>'''''.

Вот пример:

<pre><epigraph>
<p>Кажется, знаешь о себе все, так нет.
Находятся люди, которые знают о тебе больше.</p>
<text-author>В. Андреев</text-author>
</epigraph></pre>

=== Картинки ===

Картинки вставляются с помощью тэга '''<image/>''' (закрывающий тэг не требуется). Свойство '''href''' указывает на адрес картинки. Если адрес картинки начинается с символа # (решетка), то картинка находится внутри документа.

Пример:

<pre><image l:href="#picture.jpg"/></pre>

В этом примере в текст вставляется картинка picture.jpg, приложенная к документу (на что указывает символ решетки перед именем).

Файл обложки принято называть cover.jpg или cover.png.

=== Ссылки ===

Ссылки вставляются с помощью тэга '''<a>'''. Свойство '''href''' определяет адрес ссылки. Адреса с символа # (решетка) задают расположение внутри документа.

Примеры:

<pre><a l:href="#n1" type="note">[1]</a></pre>

В этом примере текстом ссылки будет '''[1]''', а указывать она будет на раздел с идентификатором '''n1''' внутри документа.

В '''l:href''' вместо '''l''' может быть и другой идентификатор, подробнее это описано в разделе "Раздел FictionBook".

=== Примечания ===

Примечания к тексту книги должны находиться в специальном разделе '''<body>''', поименнованном '''notes''', то есть описан он должен быть как '''<body name="notes">''', причем именно так - notes - пятью маленькими буквами и не иначе. Каждое примечание должно находиться в отдельном разделе '''<section>''' и иметь уникальный '''id''', по которому оно будет доступно в ссылках. Вот типичный пример оформления тела примечаний:

<pre> <body name="notes">
<title><p>Примечания</p></title>
<section id="note1">
<title>
<p>1</p>
</title>
<p>Известный английский архитектор XVIII века, испытавший в
своем творчестве сильное влияние античной архитектуры. (Здесь и
далее прим. ред.)</p>
</section>
<section id="note2">
<title>
<p>2</p>
</title>
<p>Американский просветитель, живший в XVIII веке</p>
</section>
</body>
</pre>

Ссылка на примечание должна иметь свойство '''type''', равное значению '''"note"'''. Соответствующая размещенному выше примеру ссылка на первое примечание будет выглядеть таким образом:

<pre>в стиле Роберта Адама <a l:href="#note1" type="note">[1]</a></pre>

=== Двоичные вложения ===

К документу FB2 могут быть приложены файлы, например картинки или что-нибудь другое. (Библиотека, правда, не примет файлы с иными вложениями, чем картинки).

Для описания двоичных вложений служит элемент '''binary'''. Вот пример вложения:

<pre><binary id="cover.jpg" content-type="image/jpeg">
AQMAEAMDBgkAAA/tAAAe7gAANHz/2wCEAAgGBgYGBggGBggMCAcIDA4KCAgKDhANDQ4NDRAR
DA4NDQ4MEQ8SExQTEg8YGBoaGBgjIiIiIycnJycnJycnJycBCQgICQoJCwkJCw4LDQsOEQ4O
...
h9x8OJ/B/c+gfbXM/wDQ/qcPZ9HHjqaPi17zZ4+6deEYNxtP+H1v8Opsec//2Q==
</binary>
</pre>

Свойство '''id''' описывает идентификатор (имя) двоичного объекта, а свойство '''content-type''' ? MIME-тип вложения. Содержанием элемента '''<binary>''' является файл, закодированный по методу BASE64.

Чтобы библиотека приняла файл, нужно чтобы в документе не было приложенных объектов, на которые нет ссылки, и чтобы не было ссылок, которые указывают на двоичные объекты, не приложенные к файлу.

Из картинок поддерживаются форматы JPG (тип image/jpeg) и PNG (тип image/png). Поддержка формата GIF отсутствует. Файл обложки обычно принято называть cover.jpg.

=== Символы Unicode ===

В текст можно вставлять символы по их коду в таблице Unicode. Для этого нужно написать значок &, потом значок #, потом десятичный код символа, потом точку с запятой.

Например для значка ? (не равно) ? десятичный код 8800, надо написать так:

''&#8800'';

=== Список возможных жанров ===

[[Жанры FictionBook 2.1|Здесь]] перечислены значения, которые принимает поле '''<genre>''' в заголовке FB2-документа.
<pre>sf_history Альтернативная история
sf_action Боевая Фантастика
sf_epic Эпическая Фантастика
sf_heroic Героическая фантастика
sf_detective Детективная Фантастика
sf_cyberpunk Киберпанк
sf_space Космическая Фантастика
sf_social Социальная фантастика
sf_horror Ужасы и Мистика
sf_humor Юмористическая фантастика
sf_fantasy Фэнтези
sf Научная Фантастика
child_sf Детская Фантастика
det_classic Классический Детектив
det_police Полицейский Детектив
det_action Боевики
det_irony Иронический Детектив
det_history Исторический Детектив
det_espionage Шпионский Детектив
det_crime Криминальный Детектив
det_political Политический Детектив
det_maniac Маньяки
det_hard Крутой Детектив
thriller Триллеры
detective Детектив
sf_detective Детективная Фантастика
child_det Детские Остросюжетные
love_detective Остросюжетные Любовные Романы
prose Проза
prose_classic Классическая Проза
prose_history Историческая Проза
prose_contemporary Современная Проза
prose_counter Контркультура
prose_rus_classic Русская Классика
prose_su_classics Советская Классика
humor_prose Юмористическая Проза
child_prose Детская Проза
love Любовные романы
love_contemporary Современные Любовные Романы
love_history Исторические Любовные Романы
love_detective Остросюжетные Любовные Романы
love_short Короткие Любовные Романы
love_erotica Эротика
adv_western Вестерны
adv_history Исторические Приключения
adv_indian Приключения: Индейцы
adv_maritime Морские Приключения
adv_geo Путешествия и География
adv_animal Природа и Животные
adventure Приключения: Прочее
child_adv Детские Приключения
children Детское
child_tale Сказки
child_verse Детские Стихи
child_prose Детская Проза
child_sf Детская Фантастика
child_det Детские Остросюжетные
child_adv Детские Приключения
child_education Детская Образовательная литература
children Детское: Прочее
poetry Поэзия
dramaturgy Драматургия
humor_verse Юмористические Стихи
child_verse Детские Стихи
antique_ant Античная Литература
antique_european Европейская Старинная Литература
antique_russian Древнерусская Литература
antique_east Древневосточная Литература
antique_myths Мифы. Легенды. Эпос
antique Старинная Литература: Прочее
sci_history История
sci_psychology Психология
sci_culture Культурология
sci_religion Религиоведение
sci_philosophy Философия
sci_politics Политика
sci_business Деловая литература
sci_juris Юриспруденция
sci_linguistic Языкознание
sci_medicine Медицина
sci_phys Физика
sci_math Математика
sci_chem Химия
sci_biology Биология
sci_tech Технические
science Научно-образовательная: Прочее
adv_animal Природа и Животные
comp_www Интернет
comp_programming Программирование
comp_hard Компьютерное Железо
comp_soft Программы
comp_db Базы Данных
comp_osnet ОС и Сети
computers Компьютеры: Прочее
ref_encyc Энциклопедии
ref_dict Словари
ref_ref Справочники
ref_guide Руководства
reference Справочная Литература: Прочее
nonf_biography Биографии и Мемуары
nonf_publicism Публицистика
nonf_criticism Критика
nonfiction Документальное: Прочее
design Искусство, Дизайн
adv_animal Природа и Животные
religion Религия
religion_rel Религия
religion_esoterics Эзотерика
religion_self Самосовершенствование
religion Религия и духовность: Прочее
sci_religion Религиоведение
humor_anecdote Анекдоты
humor_prose Юмористическая Проза
humor_verse Юмористические Стихи
humor Юмор: Прочее
home_cooking Кулинария
home_pets Домашние Животные
home_crafts Хобби, Ремесла
home_entertain Развлечения
home_health Здоровье
home_garden Сад и Огород
home_diy Сделай Сам
home_sport Спорт
home_sex Эротика, Секс
home Дом и Семья: Прочее</pre>

== Список возможных языков ==
<p class=p>Ниже приведены коды языков, которые можно прописывать в тэгах <b><lang></b> и <b><src-lang></b>.</p>
<p class=p>Здесь приведены только основные кодировки, полный список содержится в стандарте [[:ru:ISO 639|ISO 639]]:</p>
<pre>
abk ab Абхазский
aze az Азербайджанский
alb/sqi sq Албанский
eng en Английский
arm/hye hy Армянский
BA Башкирский
bel be Белорусский
bul bg Болгарский
hun hu Венгерский
vie vi Вьетнамский
dut/nla nl Голландский
ell/gre el Греческий современный (1453-)
dan da Данийский
grc Древнегреческий (до 1453)
heb he Иврит
esl/spa es Испанский
ita it Итальянский
kaz kk Казахский
kir ky Киргизский
chi/zho zh Китайский
kor ko Корейский
lat la Латинский
lav lv Латвийский
lit lt Литовский
mac/mak mk Македонийский
mol mo Молдавский
mon mn Монгольский
deu/ger de Немецкий
mul Несколько языков
und Неопределенный
nor no Норвежский
fas/per fa Персидский
pol pl Польский
por pt Португальский
rus ru Русский
san sa Санскрит
slk/slo sk Словакский
slv sl Словенский
tgk tg Таджикский
tat tt Татарский
tur tr Турецкий
uzb uz Узбекский
ukr uk Украинский
cym/wel cy Уэльский
fin fi Финский
fra/fre fr Французский
che Чеченский
ces/cze cs Чешский
hr Хорватский
sve/swe sv Шведский
epo eo Эсперанто
est et Эстонский
jpn ja Японский
</pre>

[[Категория:FB документы]]