Элемент annotation

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

(Различия между версиями)

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

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

Содержание

1 Элемент <annotation>

[править]

Элемент <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>

Получено с http://alexstmp.vsi.ru/index.php/%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82_annotation

Категории: Надо написать | Стандарт FB Элементы

 {{Надо написать}}
-{{Шаблон:FB Элемент|name=annotationr|description=Аннотация, т.е. краткое описание книги, служащее чтобы составить приблизительное мнение о ней. Может содержать или описание сюжета, не мешающее прочтению книги, т.е. не раскрывающее интриги книги, или небольшую рецензию.
+{{Шаблон:FB Элемент|name=annotation
-Используется в библиотеках и итображается как на странице самой книги, так и в некоторых списках (например списке новинок).
+|description=Аннотация, т.е. краткое описание книги, служащее чтобы
+составить приблизительное мнение о ней. Может содержать или описание сюжета,
+не мешающее прочтению книги, т.е. не раскрывающее интриги книги, или
+небольшую рецензию.
-По этой причине не рекомендуется писать аннотации больше чем на два-три коротких абзаца (и уж никак не два экрана текста).
+Используется в библиотеках и отображается как на странице самой книги,
+так и в некоторых списках (например списке новинок).
-Также не следует помещать в аннотацию биографию автора - для этого в библиотеках существует страница автора.|version=2.0, 2.1|supported by=
+По этой причине не рекомендуется писать аннотации больше чем на два-три
+коротких абзаца (и уж никак не два экрана текста).
+Также не следует помещать в аннотацию биографию автора - для этого в
+библиотеках существует страница автора.
+Может также применяться в секции ([[Элемент section|&lt;section&gt;]]),
+например, как аннотация к отдельному произведению к рамках сборника
+(хотя сборники лучше обормлять как отдельные произведения), или как
+аннотации к главе, как развернутые аннотации, присутствовавшие к бумажном
+издании в рамках книги.
+|version=2.0 и выше
+|supported by=
 * Всеми (обеими) библиотеками, ориентироваными на FB2.
 * Библиотечным софтом.
-* Рядом ориентированных на FB2 «читалок».|children=Произвольный набор (в произвольном количестве из следующих элементов):
+* Рядом ориентированных на FB2 «читалок».
-#
-#* [[Элемент p|&lt;p&gt;]]
+|attributes=
-#* [[Элемент poem|&lt;poem&gt;]]
+* '''id''' ''(опционально)'' - Идентификатор (якорь, метка) для ссылок на данный элемент.
-#* [[Элемент cite|&lt;cite&gt;]]
+* '''xml:lang''' ''(опционально)'' - язык.
-#* [[Элемент empty-line|&lt;empty-line&gt;]]|parents=
-* [[Элемент title-info|&lt;title-info&gt;]]
+|children=
-* [[Элемент src-title-info|&lt;src-title-info&gt;]]|example=|see=
+Может содержать произвольный набор (в произвольном количестве) из следующих элементов:
+* [[Элемент p|&lt;p&gt;]];
+* [[Элемент poem|&lt;poem&gt;]];
+* [[Элемент cite|&lt;cite&gt;]];
+* [[Элемент subtitle|&lt;subtitle&gt;]];
+* [[Элемент empty-line|&lt;empty-line&gt;]];
+* [[Элемент table|&lt;table&gt;]] ''(с версии 2.1)''.
+|parents=
+Может содержаться в следующих элементах:
+* [[Элемент title-info|&lt;title-info&gt;]] ''(опционально)'';
+* [[Элемент src-title-info|&lt;src-title-info&gt;]] ''(опционально) с версии 2.1'';
+* [[Элемент section|&lt;section&gt;]] ''(опционально)''.
+|example=
+<pre>
+<annotation>
+<p>«Смерть или слава», «Черная эстафета». И теперь наконец - «Наследие исполинов»!</p>
+<p>Случайная находка, сделанная землянами в космосе? Непонятный артефакт давно исчезнувшей цивилизации?
+Или все-таки - генератор нуль-тоннелей, ведущих, согласно легенде, в другую галактику - к сокровищу,
+открывающему власть над Вселенной?!</p>
+<p>Чтобы понять - надо ДОБРАТЬСЯ!</p>
+<p>Охота начинается. Люди и «чужие» вступают в гонку Победитель ПОЛУЧИТ ВСЕ!</p>
+<p>Читайте «Наследие исполинов» - первую книгу нового цикла Владимира Васильева «Война за мобильность»!</p>
+</annotation>
+</pre>
+|see=
 * [[Элемент history|&lt;history&gt;]], как аналогичный по структуре, но не по смыслу элемент.
+|comments=
+|style=
+|dtd=
+<pre>
+<xs:complexType name="annotationType">
+ <xs:annotation>
+  <xs:documentation>A cut-down version of &lt;section&gt;
+    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>
+</pre>
 }}

Элемент annotation

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

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

Содержание

Элемент <annotation>

Описание

Версия FB

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

Атрибуты

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

Подчинен

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

Смотри также

Комментарии

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

Просмотры

Личные инструменты

Навигация

Поиск

Инструменты