FictionBook 2.0 Schema - комментарии — различия между версиями

Материал из FictionBook
Перейти к: навигация, поиск
Строка 173: Строка 173:
 
  </custom-info>
 
  </custom-info>
 
  </description>
 
  </description>
 +
 +
== Тело ==
 +
Тело документа FictionBook (<body>) состоит из одной или более части (<section>). <section> может быть вложена внутрь другой <section>, при этом одновременное вложение текстов и <section> не допускается.
 +
 +
Всегда допустимые теги втутри <section>:
 +
 +
<title> - аналог атрибута title, допускающий использование параграфов (<nowiki><p></nowiki>) и пустых строк (<empty-line>) для сложных заголовков.
 +
 +
<image> - рисунок.
 +
 +
<epigraph> - эпиграф, допустим в начале, может быть несколько.
 +
 +
<annotation> - краткое описание главы.
 +
 +
Теги, допустимые в любом порядке и количестве внутри <section>, если в нее не вложена другая <section>:
 +
 +
<nowiki><p></nowiki> - параграф. Допускает использование стилей <style>, выделения <nowiki><strong></nowiki> и сносок <note>.
 +
 +
<image> - рисунок.
 +
 +
<empty-line> - пустая строка.
 +
 +
<poem> - стихи.
 +
 +
<subtitle> - смысловой разделитель, имеющий внутри себя текст.
 +
 +
<nowiki><cite></nowiki> - цитата.
 +
 +
Более полную информацию можно найти, просмотрев исходный текст и комментарии в примере документа FictionBook.

Версия 14:59, 1 февраля 2006

Что такое 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=1954»