Элемент description

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

Элемент <description>

Описание

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

Рекомендуется серьезно отнесится к заполнению, поскольку неправильно (или неполно) заполненное описание приводит к некорректному позиционированию книги в библиотеке, что затрудняет ее поиск, приводит к появлению "двойников" авторов и просто не позволяет потенциальному читателю составить предварительное мнение о книге.

Версия FB

2.0 и выше

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

  • Всеми (обеими) библиотеками, ориентироваными на FB2.
  • Библиотечным софтом.
  • "Читалками" обеспечивающими поддержку стандарта на уровне выше, чем "выкусывание тэгов".

Атрибуты

Нет атрибутов.

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

Содержит в указанном порядке элементы:

  1. <title-info> - 1 (один, обязателен);
  2. <src-title-info> - 0..1 (один, опционально) с версии 2.1;
  3. <document-info> - 1 (один, обязателен);
  4. <publish-info> - 0..1 (один, опционально);
  5. <custom-info> - 0..n (любое число, опционально);
  6. <output> - 0..2 (опционально один или два) с версии 2.1.

Подчинен

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

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

Смотри также

Комментарии

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

<xs:element name="description">
 <xs:complexType>
  <xs:sequence>
   <xs:element name="title-info" type="title-infoType">
    <xs:annotation>
     <xs:documentation>Generic information about the book</xs:documentation>
    </xs:annotation>
   </xs:element>
   <xs:element name="src-title-info" type="title-infoType" minOccurs="0">
    <xs:annotation>
     <xs:documentation>Generic information about the original book (for translations)
     </xs:documentation>
    </xs:annotation>
   </xs:element>
   <xs:element name="document-info">
    <xs:annotation>
     <xs:documentation>Information about this particular (xml) document</xs:documentation>
    </xs:annotation>
     ....
   </xs:element>
   <xs:element name="publish-info" minOccurs="0">
    <xs:annotation>
     <xs:documentation>Information about some paper/outher published document, that was 
       used as a source of this xml document</xs:documentation>
    </xs:annotation>
     ....
   </xs:element>
   <xs:element name="custom-info" minOccurs="0" maxOccurs="unbounded">
    <xs:annotation>
     <xs:documentation>Any other information about the book/document that didnt fit 
       in the above groups</xs:documentation>
    </xs:annotation>
     ....
   </xs:element>
   <xs:element name="output" type="shareInstructionType" minOccurs="0" maxOccurs="2"/>
  </xs:sequence>
 </xs:complexType>
</xs:element>

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

{{{epub3}}}