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

Материал из FictionBook
Перейти к: навигация, поиск
Строка 35: Строка 35:
  
 
=== Пример развернутого заголовка: ===
 
=== Пример развернутого заголовка: ===
<description>
+
<description>
 
  <title-info>
 
  <title-info>
 
  <!--Вы можете указывать необходимое колличество жанров,которым соответствует книга. Это облегчит ее каталогизацию в библиотеке.
 
  <!--Вы можете указывать необходимое колличество жанров,которым соответствует книга. Это облегчит ее каталогизацию в библиотеке.
Строка 55: Строка 55:
 
   <last-name>Толстой</last-name>
 
   <last-name>Толстой</last-name>
 
   <nickname>Лева</nickname>
 
   <nickname>Лева</nickname>
   <home-page>lev@tolstoy.ru</home-page>
+
   <home-page>http://www.pupkin.ru</home-page>
   <email>http://www.pupkin.ru</email>
+
   <email>lev@tolstoy.ru</email>
 
   </author>
 
   </author>
 
  <!--Название книги - комментарии излишни.--!>
 
  <!--Название книги - комментарии излишни.--!>
Строка 63: Строка 63:
 
  в библиотеке оценить, подходит ему книга, или нет--!>
 
  в библиотеке оценить, подходит ему книга, или нет--!>
 
   <annotation>
 
   <annotation>
  <p>Это тестовый файл FictionBook 2.0. Создан грибовым дмитрием
+
  <nowiki><p></nowiki>
 +
Это тестовый файл FictionBook 2.0. Создан грибовым дмитрием
 
  в демонстрационных целях и для экспериментов с библиотекой FIctionBook.lib.
 
  в демонстрационных целях и для экспериментов с библиотекой FIctionBook.lib.
 
  К сожалению сам роман я в FB2 пока не перевел.
 
  К сожалению сам роман я в FB2 пока не перевел.
  </p>
+
  <nowiki></p></nowiki>
 
  <empty-line/>
 
  <empty-line/>
  <p>
+
  <nowiki><p></nowiki>
 
  Роман Толстого ?Война и мир? был написан в 1869 году. Это
 
  Роман Толстого ?Война и мир? был написан в 1869 году. Это
 
  произведение явилось, по словам многих известных писателей и
 
  произведение явилось, по словам многих известных писателей и
 
  критиков, ?величайшим романом в мире?. Главная мысль в романе -
 
  критиков, ?величайшим романом в мире?. Главная мысль в романе -
 
  мысль народная.
 
  мысль народная.
  </p>
+
  <nowiki></p></nowiki>
 
  <!--Аннотация может включать в себя все текстовые элементы:
 
  <!--Аннотация может включать в себя все текстовые элементы:
 
  стихи
 
  стихи
Строка 81: Строка 82:
 
  <poem>
 
  <poem>
 
  <title>
 
  <title>
  <p>Название стиха</p>
+
  <nowiki><p></nowiki>
 +
Название стиха
 +
<nowiki></p></nowiki>
 
  </title>
 
  </title>
 
  <epigraph>
 
  <epigraph>
  <p>Стихотворение посвящается
+
  <nowiki><p></nowiki>
  тегу "stanza"</p>
+
Стихотворение посвящается
 +
  тегу "stanza"
 +
<nowiki></p></nowiki>
 
  </epigraph>
 
  </epigraph>
 
  <stanza>
 
  <stanza>
Строка 94: Строка 99:
 
  </stanza>
 
  </stanza>
 
  </poem>
 
  </poem>
  <cite>
+
  <nowiki><cite></nowiki>
  <p>Здесь можно кого-нибудь процитировать</p>
+
  <nowiki><p></nowiki>
 +
Здесь можно кого-нибудь процитировать
 +
<nowiki></p></nowiki>
 
  <text-author>Автор/Источник Цитаты</text-author>
 
  <text-author>Автор/Источник Цитаты</text-author>
  </cite>
+
<nowiki></cite></nowiki>
  <p>
+
<nowiki><p></nowiki>
 
  Большую часть романа занимают картины военных действий. В этом
 
  Большую часть романа занимают картины военных действий. В этом
 
  произведении Толстым дано изображение двух войн: 1805 и 1812 годов. В обеих войнах
 
  произведении Толстым дано изображение двух войн: 1805 и 1812 годов. В обеих войнах
 
  главным и решающим фактором явились
 
  главным и решающим фактором явились
 
  народные массы. <a xlink:href="#annotation_src" type="note">[источник]</a>.
 
  народные массы. <a xlink:href="#annotation_src" type="note">[источник]</a>.
  </p>
+
  <nowiki></p></nowiki>
 
   </annotation>
 
   </annotation>
 
  <!--Уф. Вот и кончилась эта чудовищная аннотация,
 
  <!--Уф. Вот и кончилась эта чудовищная аннотация,
Строка 145: Строка 152:
 
  <version>2.0</version>
 
  <version>2.0</version>
 
  <history>
 
  <history>
   <p>Этот документ первоначально был создан для
+
   <nowiki><p></nowiki>
   FictionBook 1.0 и позднее переделан для FB2.0</p>
+
  Этот документ первоначально был создан для
 +
   FictionBook 1.0 и позднее переделан для FB2.0<nowiki></p></nowiki>
 
   </history>
 
   </history>
 
  </document-info>
 
  </document-info>

Версия 14:34, 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>