Элемент annotation
| Ошибка создания миниатюры: Не удаётся сохранить эскиз по месту назначения
|
Внимание! Содержимое этой страницы требуется написать или доделать начатое. |
Содержание
Элемент <annotation>
Описание
Аннотация, т.е. краткое описание книги, служащее чтобы составить приблизительное мнение о ней. Может содержать или описание сюжета, не мешающее прочтению книги, т.е. не раскрывающее интриги книги, или небольшую рецензию.
Используется в библиотеках и отображается как на странице самой книги, так и в некоторых списках (например списке новинок).
По этой причине не рекомендуется писать аннотации больше чем на два-три коротких абзаца (и уж никак не два экрана текста).
Также не следует помещать в аннотацию биографию автора - для этого в библиотеках существует страница автора.
Может также применяться в секции (<section>), например, как аннотация к отдельному произведению к рамках сборника (хотя сборники лучше обормлять как отдельные произведения), или как аннотации к главе, как развернутые аннотации, присутствовавшие к бумажном издании в рамках книги.
Версия FB
2.0 и выше
Поддерживается
- Всеми (обеими) библиотеками, ориентироваными на FB2.
- Библиотечным софтом.
- Рядом ориентированных на FB2 ?читалок?.
Атрибуты
- id (опционально) - Идентификатор (якорь, метка) для ссылок на данный элемент.
- xml:lang (опционально) - язык.
Подчиненные элементы
Произвольный набор (в произвольном количестве) из следующих элементов:
- <p>;
- <poem>;
- <cite>;
- <subtitle>;
- <table>;
- <empty-line>.
Подчинен
Может содержаться в:
- <title-info> (опционально);
- <src-title-info> (опционально);
- <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>
Эквивалент в EPUB3
{{{epub3}}}