FictionBook 2.0 Schema - комментарии

Материал из FictionBook
Перейти к: навигация, поиск

Что такое Schema?

W3C Schema - формальное описание требований к документу XML. Schema определяет какие теги можно использовать, и где они могут располагаться, и что они могут содержать. Так же Schema определяет, какие теги должны присутствовать обязательно, а какие могут быть опущены.

Структура документа FictionBook

Документ FictionBook состоит из двух частей - заголовка (<description>) и тела (<body>). За ними могут следовать включенные в документ двоичные файлы. Пока обрабатываются программами файлы *.PNG и *.JPG, но вложить в документ можно любые файлы.

Заголовок

Заголовок состоит из трех частей: информация о содержимом книги (<title-info>), информация о XML-документе (<document-info>), и информация о бумажном издании (<publish-info>), на котором основывается данный документ XML.

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

<publish-info> описывает бумажное издание, на котором основан документ и является необязательным, хотя его заполнение при создании книг всячески приветствуется. Такая информация позволит легко отслеживать ошибки в документах и позволит объективно оценить удобство различных средств и методов разработки документов FictionBook и совершенствовать такие средства и методы.

Пример минимального заголовка:

<description>
<title-info>
  <genre>history_russia</genre>
  <author>
  <first-name>Лев</first-name>
  <middle-name>Николаевич</middle-name>
  <last-name>Толстой</last-name>
  </author>
  <book-title>Война и мир</book-title>
  <lang>ru</lang>
</title-info>
<document-info>
  <author>
  <nickname>GribUser</nickname>
  </author>
<date value="2002-10-15">15 ноября 2002г., 19:53</date>
<id>GribUser_WarAndWorld_D49FHSH8l0HS5</id>
<version>2.0</version>
</document-info>
</description>

Пример развернутого заголовка:

<description> 

<title-info>
Источник — «http://fictionbook.org/index.php?title=FictionBook_2.0_Schema_-_комментарии&oldid=1953»