Материал из FictionBook.

Версия 13:58, 30 марта 2007 Mike Sinkovsky (Обсуждение | вклад) Форматирование, пример ← К предыдущему изменению		Текущая версия Mike Sinkovsky (Обсуждение | вклад)
Строка 34:		Строка 34:
	|children=		|children=
-	Произвольный набор (в произвольном количестве) из следующих элементов:	+	Может содержать произвольный набор (в произвольном количестве) из следующих элементов:
	* [[Элемент p|<p>]];		* [[Элемент p|<p>]];
	* [[Элемент poem|<poem>]];		* [[Элемент poem|<poem>]];
	* [[Элемент cite|<cite>]];		* [[Элемент cite|<cite>]];
	* [[Элемент subtitle|<subtitle>]];		* [[Элемент subtitle|<subtitle>]];
-	* [[Элемент table|<table>]];	+	* [[Элемент empty-line|<empty-line>]];
-	* [[Элемент empty-line|<empty-line>]].	+	* [[Элемент table|<table>]] ''(с версии 2.1)''.
	|parents=		|parents=
		+	Может содержаться в следующих элементах:
	* [[Элемент title-info|<title-info>]] ''(опционально)'';		* [[Элемент title-info|<title-info>]] ''(опционально)'';
-	* [[Элемент src-title-info|<src-title-info>]] ''(опционально)'';	+	* [[Элемент src-title-info|<src-title-info>]] ''(опционально) с версии 2.1'';
	* [[Элемент section|<section>]] ''(опционально)''.		* [[Элемент section|<section>]] ''(опционально)''.

---

Текущая версия

Внимание! Содержимое этой страницы требуется написать или доделать начатое.

Содержание 1 Элемент <annotation> 1.1 Описание 1.2 Версия FB 1.3 Поддерживается 1.4 Атрибуты 1.5 Подчиненные элементы 1.6 Подчинен 1.7 Пример использования 1.8 Смотри также 1.9 Комментарии 1.10 Фрагмент схемы

Элемент <annotation>

Описание

Аннотация, т.е. краткое описание книги, служащее чтобы составить приблизительное мнение о ней. Может содержать или описание сюжета, не мешающее прочтению книги, т.е. не раскрывающее интриги книги, или небольшую рецензию.

Используется в библиотеках и отображается как на странице самой книги, так и в некоторых списках (например списке новинок).

По этой причине не рекомендуется писать аннотации больше чем на два-три коротких абзаца (и уж никак не два экрана текста).

Также не следует помещать в аннотацию биографию автора - для этого в библиотеках существует страница автора.

Может также применяться в секции (<section>), например, как аннотация к отдельному произведению к рамках сборника (хотя сборники лучше обормлять как отдельные произведения), или как аннотации к главе, как развернутые аннотации, присутствовавшие к бумажном издании в рамках книги.

Версия FB

2.0 и выше

Поддерживается

• Всеми (обеими) библиотеками, ориентироваными на FB2.
• Библиотечным софтом.
• Рядом ориентированных на FB2 «читалок».

Атрибуты

• id (опционально) - Идентификатор (якорь, метка) для ссылок на данный элемент.
• xml:lang (опционально) - язык.

Подчиненные элементы

Может содержать произвольный набор (в произвольном количестве) из следующих элементов:

• <p>;
• <poem>;
• <cite>;
• <subtitle>;
• <empty-line>;
• <table> (с версии 2.1).

Подчинен

Может содержаться в следующих элементах:

• <title-info> (опционально);
• <src-title-info> (опционально) с версии 2.1;
• <section> (опционально).

Пример использования

<annotation>
<p>«Смерть или слава», «Черная эстафета». И теперь наконец - «Наследие исполинов»!</p>
<p>Случайная находка, сделанная землянами в космосе? Непонятный артефакт давно исчезнувшей цивилизации? 
Или все-таки - генератор нуль-тоннелей, ведущих, согласно легенде, в другую галактику - к сокровищу, 
открывающему власть над Вселенной?!</p>
<p>Чтобы понять - надо ДОБРАТЬСЯ!</p>
<p>Охота начинается. Люди и «чужие» вступают в гонку Победитель ПОЛУЧИТ ВСЕ!</p>
<p>Читайте «Наследие исполинов» - первую книгу нового цикла Владимира Васильева «Война за мобильность»!</p>
</annotation>

Смотри также

• <history>, как аналогичный по структуре, но не по смыслу элемент.

Комментарии

Фрагмент схемы

<xs:complexType name="annotationType">
 <xs:annotation>
  <xs:documentation>A cut-down version of <section>
    used in annotations</xs:documentation>
 </xs:annotation>
 <xs:choice minOccurs="0" maxOccurs="unbounded">
  <xs:element name="p" type="pType"/>
  <xs:element name="poem" type="poemType"/>
  <xs:element name="cite" type="citeType"/>
  <xs:element name="subtitle" type="pType"/>
  <xs:element name="table" type="tableType"/>
  <xs:element name="empty-line"/>
 </xs:choice>
 <xs:attribute name="id" type="xs:ID" use="optional"/>
 <xs:attribute ref="xml:lang"/>
</xs:complexType>