Элемент annotation — различия между версиями

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

Текущая версия на 06:37, 2 апреля 2007

Ошибка создания миниатюры: Не удаётся сохранить эскиз по месту назначения
Внимание!
Содержимое этой страницы требуется написать или доделать начатое.

Элемент <annotation>

Описание

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

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

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

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

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

Версия FB

2.0 и выше

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

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

Атрибуты

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

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

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

Подчинен

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

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

<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>

Эквивалент в EPUB3

{{{epub3}}}