Элемент annotation
Материал из FictionBook.
Версия 10:10, 14 июля 2006 Iarspider (Обсуждение | вклад) ← К предыдущему изменению |
Версия 13:58, 30 марта 2007 Mike Sinkovsky (Обсуждение | вклад) Форматирование, пример К след. изменению → |
||
Строка 1: | Строка 1: | ||
{{Надо написать}} | {{Надо написать}} | ||
- | {{Шаблон:FB Элемент|name=annotation|description=Аннотация, т.е. краткое описание книги, служащее чтобы составить приблизительное мнение о ней. Может содержать или описание сюжета, не мешающее прочтению книги, т.е. не раскрывающее интриги книги, или небольшую рецензию. | + | {{Шаблон:FB Элемент|name=annotation |
- | Используется в библиотеках и отображается как на странице самой книги, так и в некоторых списках (например списке новинок). | + | |description=Аннотация, т.е. краткое описание книги, служащее чтобы |
+ | составить приблизительное мнение о ней. Может содержать или описание сюжета, | ||
+ | не мешающее прочтению книги, т.е. не раскрывающее интриги книги, или | ||
+ | небольшую рецензию. | ||
- | По этой причине не рекомендуется писать аннотации больше чем на два-три коротких абзаца (и уж никак не два экрана текста). | + | Используется в библиотеках и отображается как на странице самой книги, |
+ | так и в некоторых списках (например списке новинок). | ||
- | Также не следует помещать в аннотацию биографию автора - для этого в библиотеках существует страница автора. | + | По этой причине не рекомендуется писать аннотации больше чем на два-три |
+ | коротких абзаца (и уж никак не два экрана текста). | ||
- | Может также применяться в секции ([[Элемент section|<section>]]), например, как аннотация к отдельному произведению к рамках сборника (хотя сборники лучше обормлять как отдельные произведения), или как аннотации к главе, как развернутые аннотации, присутствовавшие к бумажном издании в рамках книги.|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>]] | + | Произвольный набор (в произвольном количестве) из следующих элементов: |
- | * [[Элемент section|<section>]] | + | * [[Элемент p|<p>]]; |
- | * [[Элемент src-title-info|<src-title-info>]]|example=|see= | + | * [[Элемент poem|<poem>]]; |
+ | * [[Элемент cite|<cite>]]; | ||
+ | * [[Элемент subtitle|<subtitle>]]; | ||
+ | * [[Элемент table|<table>]]; | ||
+ | * [[Элемент empty-line|<empty-line>]]. | ||
+ | |||
+ | |parents= | ||
+ | * [[Элемент title-info|<title-info>]] ''(опционально)''; | ||
+ | * [[Элемент src-title-info|<src-title-info>]] ''(опционально)''; | ||
+ | * [[Элемент section|<section>]] ''(опционально)''. | ||
+ | |||
+ | |example= | ||
+ | <pre> | ||
+ | <annotation> | ||
+ | <p>«Смерть или слава», «Черная эстафета». И теперь наконец - «Наследие исполинов»!</p> | ||
+ | <p>Случайная находка, сделанная землянами в космосе? Непонятный артефакт давно исчезнувшей цивилизации? | ||
+ | Или все-таки - генератор нуль-тоннелей, ведущих, согласно легенде, в другую галактику - к сокровищу, | ||
+ | открывающему власть над Вселенной?!</p> | ||
+ | <p>Чтобы понять - надо ДОБРАТЬСЯ!</p> | ||
+ | <p>Охота начинается. Люди и «чужие» вступают в гонку Победитель ПОЛУЧИТ ВСЕ!</p> | ||
+ | <p>Читайте «Наследие исполинов» - первую книгу нового цикла Владимира Васильева «Война за мобильность»!</p> | ||
+ | </annotation> | ||
+ | </pre> | ||
+ | |||
+ | |see= | ||
* [[Элемент history|<history>]], как аналогичный по структуре, но не по смыслу элемент. | * [[Элемент history|<history>]], как аналогичный по структуре, но не по смыслу элемент. | ||
+ | |||
+ | |comments= | ||
+ | |||
+ | |style= | ||
+ | |||
+ | |dtd= | ||
+ | <pre> | ||
+ | <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> | ||
+ | </pre> | ||
}} | }} |
Версия 13:58, 30 марта 2007
Внимание! Содержимое этой страницы требуется написать или доделать начатое. |
Содержание |
Элемент <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>