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

Материал из FictionBook
Перейти к: навигация, поиск
м
м
 
(не показаны 4 промежуточных версий 2 участников)
Строка 1: Строка 1:
 
{{Надо написать| [[Участник:Gremlin|Gremlin]] }}
 
{{Надо написать| [[Участник:Gremlin|Gremlin]] }}
{{Шаблон:FB Элемент|name=description|description=Информация о книге (автор(ы), название, выходные данные, ...) и файле (создател(ь/и), история, ссылки на источник, ...)
+
{{Шаблон:FB Элемент|name=description
 +
 
 +
|description=
 +
Метаинформация о книге (автор(ы), название, выходные данные, ...) и файле (создатель(и), история, ссылки на источник, ...)
 
Используется в основном библиотечным софтом, но может представлять интерес и рядовому читателю.
 
Используется в основном библиотечным софтом, но может представлять интерес и рядовому читателю.
  
Рекомендуется серьезно отнесится к заполнению, поскольку неправильно (или неполно) заполненное описание приводит к некорректному позиционированию книги в библиотеке, что затрудняет ее поиск, приводит к появлению "двойников" авторов и просто не позволяет потенциальному читателю составить предварительное мнение о книге.|version=2.0, 2.1|supported by=
+
Рекомендуется серьезно отнесится к заполнению, поскольку неправильно (или неполно) заполненное описание приводит  
 +
к некорректному позиционированию книги в библиотеке, что затрудняет ее поиск, приводит к появлению "двойников"  
 +
авторов и просто не позволяет потенциальному читателю составить предварительное мнение о книге.
 +
 
 +
|version=2.0 и выше
 +
 
 +
|supported by=
 
* Всеми (обеими) библиотеками, ориентироваными на FB2.
 
* Всеми (обеими) библиотеками, ориентироваными на FB2.
 
* Библиотечным софтом.
 
* Библиотечным софтом.
* "Читалками" обеспечивающими поддержку стандарта на уровне выше, чем "выкусывание тэгов".|attributes=Нет атрибутов.|children=
+
* "Читалками" обеспечивающими поддержку стандарта на уровне выше, чем "выкусывание тэгов".
# [[Элемент title-info|<nowiki><title-info></nowiki>]] - 1 (один, обязателен);
+
 
# [[Элемент srcTitle-info|<nowiki><src-title-info></nowiki>]] - 0..1 (один, опционально);
+
|attributes=Нет атрибутов.
# [[Элемент document-info|<nowiki><document-info></nowiki>]] - 1 (один, обязателен);
+
 
# [[Элемент publish-info|<nowiki><publish-info></nowiki>]] - 0..1 (один, опционально);
+
|children=
# [[Элемент custom-info|<nowiki><custom-info></nowiki>]] - 0..n (любое число, опционально).|parents=
+
Содержит в указанном порядке элементы:
* [[Элемент FictionBook|<nowiki><FictionBook></nowiki>]]|example=|see=}}
+
# [[Элемент title-info|&lt;title-info&gt;]] - ''1 (один, обязателен)'';
 +
# [[Элемент src-title-info|&lt;src-title-info&gt;]] - ''0..1 (один, опционально) с версии 2.1'';
 +
# [[Элемент document-info|&lt;document-info&gt;]] - ''1 (один, обязателен)'';
 +
# [[Элемент publish-info|&lt;publish-info&gt;]] - ''0..1 (один, опционально)'';
 +
# [[Элемент custom-info|&lt;custom-info&gt;]] - ''0..n (любое число, опционально)'';
 +
# [[Элемент output|&lt;output&gt;]] - ''0..2 (опционально один или два) с версии 2.1''.
 +
 
 +
|parents=
 +
Может содержаться в следующих элементах:
 +
* [[Элемент FictionBook|&lt;FictionBook&gt;]] - ''1 (один, обязателен)''
 +
 
 +
|example=
 +
 
 +
|see=
 +
 
 +
|comments=
 +
 
 +
|style=
 +
 
 +
|dtd=
 +
<pre>
 +
<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>
 +
</pre>
 +
 
 +
|epub3=
 +
}}

Текущая версия на 13:18, 24 октября 2013

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

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