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

Материал из FictionBook
Перейти к: навигация, поиск
м
 
(не показаны 7 промежуточные версии 2 участников)
Строка 1: Строка 1:
 
{{Надо написать| [[Участник:Gremlin|Gremlin]] }}
 
{{Надо написать| [[Участник:Gremlin|Gremlin]] }}
{{Шаблон:FB Элемент|name=body|description=Здесь собственно и находится текст книги.
+
{{Шаблон:FB Элемент|name=body
  
Допускается использование нескольких экземпляров <body>. На данный момент второй <body> может использоваться для сносок.
+
|description=Здесь собственно и находится текст книги.
|version=2.0, 2.1|supported by=Любой читалкой (или конвертером).|attributes=
+
 
* '''name''' - опциональное название <body>, обычно задается в ''"notes"'' для тела, содержащего сноски.
+
Хотя формально количество и порядок экземпляров [[Элемент body|<body>]] не ограничены, но для совместимости с существующим софтом рекомендуется:
* '''xml:lang''' - опциональное задание языка для <body> ('''''TODO: нужна ссылка на описание xml:lang в FB2''''')|children=
+
# Помещать весь основной текст документа в первом [[Элемент body|<body>]] (сразу после [[Элемент description|<description>]]).
# [[Элемент image|<nowiki><image></nowiki>]] - 0..1 (один, опционально) задается изображение для отображения в начале книги (или конкретного &lt;body&gt;);
+
# При наличии в тексте сносок ([[Элемент a|&lt;a type="note"&gt;]]) сам текст сносок должен размещаться во втором [[Элемент body|&lt;body&gt;]] с атрибутом '''name="notes"'''.<br>
# [[Элемент title|<nowiki><title></nowiki>]] - 0..1 (один, опционально) задается заглавие для отображения в начале книги (или конкретного &lt;body&gt;);
+
# При наличии кроме сносок также комментариев и т.п., что в оригинале размещено в конце книги - создается третье [[Элемент body|&lt;body&gt;]] с атрибутом '''name="comments"''' или без атрибута '''name'''.<br>
# [[Элемент epigraph|<nowiki><epigraph></nowiki>]] ? 0..n (любое число, опционально) задаются эпиграфы к книге;
+
# При отсутствии сносок второе и третье [[Элемент body|&lt;body&gt;]] должно отсутствовать, а весь текст размещаться в первом.
# [[Элемент section|<nowiki><section></nowiki>]] - 1..n (любое число, один обязaтелен) задаются части (главы, прочие структурные единицы) книги;|parents=
+
 
* [[Элемент FictionBook|<nowiki><FictionBook></nowiki>]]|example=|see=}}
+
|version=2.0 и выше
 +
 
 +
|supported by=Любой читалкой (или конвертером).
 +
 
 +
|attributes=
 +
* '''name''' - ''(опционально)'' - название '''&lt;body&gt;''', устанавливается в '''"notes"''' для тела, содержащего сноски.
 +
* [[Атрибут xml:lang|'''xml:lang''']] - ''(опционально)'' - задание языка для '''&lt;body&gt;'''
 +
 
 +
|children=
 +
Содержит в перечисленном порядке следующие элементаы:
 +
# [[Элемент image|&lt;image&gt;]] - ''0..1 (один, опционально)'' - задается изображение для отображения в начале книги (или конкретного '''&lt;body&gt;''');
 +
# [[Элемент title|&lt;title&gt;]] - ''0..1 (один, опционально)'' - задается заглавие для отображения в начале книги (или конкретного '''&lt;body&gt;''');
 +
# [[Элемент epigraph|&lt;epigraph&gt;]] - ''0..n (любое число, опционально)'' - задаются эпиграфы к книге;
 +
# [[Элемент section|&lt;section&gt;]] - ''1..n (любое число, один обязaтелен)'' - задаются части (главы, прочие структурные единицы) книги;
 +
 
 +
|parents=
 +
Может содержаться в следующих элементах:
 +
* [[Элемент FictionBook|&lt;FictionBook&gt;]] ''(любое число, один обязaтелен)''
 +
 
 +
|example=
 +
<pre>
 +
<body name="notes">
 +
<title><p>Примечания</p></title>
 +
<section id="note1">
 +
  <title>
 +
  <p>1</p>
 +
  </title>
 +
  <p>Известный английский архитектор XVIII века, испытавший в
 +
  своем творчестве сильное влияние античной архитектуры. (Здесь и
 +
  далее прим. ред.)</p>
 +
</section>
 +
<section id="note2">
 +
  <title>
 +
  <p>2</p>
 +
  </title>
 +
  <p>Американский просветитель, живший в XVIII веке</p>
 +
</section>
 +
</body>
 +
</pre>
 +
 
 +
|see=
 +
 
 +
|comments=
 +
Все ссылки на текст в [[Элемент body|&lt;body&gt;]] с атрибутом '''name="notes"''' должны иметь атрибут '''type="note"'''
 +
- опять же для совместимости с существующим софтом.
 +
Отображение текста, недоступного через [[Элемент a|&lt;a type="note"&gt;]] не гарантируется.
 +
 
 +
|style=
 +
<pre>
 +
body {
 +
  margin: 0.5em;
 +
  text-align: justify;
 +
  text-indent: 2em;
 +
  line-height: 100% }
 +
</pre>
 +
 
 +
|dtd=
 +
<pre>
 +
<xs:element name="body" maxOccurs="unbounded">
 +
<xs:annotation>
 +
  <xs:documentation>Main content of the book, multiple bodies are
 +
    used for additional information, like footnotes, that do not
 +
    appear in the main book flow. The first body is presented to
 +
    the reader by default, and content in the other bodies should
 +
    be accessible by hyperlinks. Name attribute should describe
 +
    the meaning of this body, this is optional for the main body.
 +
  </xs:documentation>
 +
</xs:annotation>
 +
<xs:complexType>
 +
  <xs:sequence>
 +
  <xs:element name="image" type="imageType" minOccurs="0">
 +
    <xs:annotation>
 +
    <xs:documentation>Image to be displayed at the top of this
 +
      section</xs:documentation>
 +
    </xs:annotation>
 +
  </xs:element>
 +
  <xs:element name="title" type="titleType" minOccurs="0">
 +
    <xs:annotation>
 +
    <xs:documentation>A fancy title for the entire book, should
 +
      be used if the simple text version in &lt;description&gt;
 +
      is not adequate, e.g. the book title has multiple paragraphs
 +
      and/or character styles</xs:documentation>
 +
    </xs:annotation>
 +
  </xs:element>
 +
  <xs:element name="epigraph" type="epigraphType" minOccurs="0" maxOccurs="unbounded">
 +
    <xs:annotation>
 +
    <xs:documentation>Epigraph(s) for the entire book, if any</xs:documentation>
 +
    </xs:annotation>
 +
  </xs:element>
 +
  <xs:element name="section" type="sectionType" maxOccurs="unbounded"/>
 +
  </xs:sequence>
 +
  <xs:attribute name="name" type="xs:string" use="optional"/>
 +
  <xs:attribute ref="xml:lang"/>
 +
</xs:complexType>
 +
</xs:element>
 +
</pre>
 +
}}

Текущая версия на 09:28, 11 октября 2010

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

Элемент <body>

Описание

Здесь собственно и находится текст книги.

Хотя формально количество и порядок экземпляров <body> не ограничены, но для совместимости с существующим софтом рекомендуется:

  1. Помещать весь основной текст документа в первом <body> (сразу после <description>).
  2. При наличии в тексте сносок (<a type="note">) сам текст сносок должен размещаться во втором <body> с атрибутом name="notes".
  3. При наличии кроме сносок также комментариев и т.п., что в оригинале размещено в конце книги - создается третье <body> с атрибутом name="comments" или без атрибута name.
  4. При отсутствии сносок второе и третье <body> должно отсутствовать, а весь текст размещаться в первом.

Версия FB

2.0 и выше

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

Любой читалкой (или конвертером).

Атрибуты

  • name - (опционально) - название <body>, устанавливается в "notes" для тела, содержащего сноски.
  • xml:lang - (опционально) - задание языка для <body>

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

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

  1. <image> - 0..1 (один, опционально) - задается изображение для отображения в начале книги (или конкретного <body>);
  2. <title> - 0..1 (один, опционально) - задается заглавие для отображения в начале книги (или конкретного <body>);
  3. <epigraph> - 0..n (любое число, опционально) - задаются эпиграфы к книге;
  4. <section> - 1..n (любое число, один обязaтелен) - задаются части (главы, прочие структурные единицы) книги;

Подчинен

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

  • <FictionBook> (любое число, один обязaтелен)

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

<body name="notes">
 <title><p>Примечания</p></title>
 <section id="note1">
  <title>
   <p>1</p>
  </title>
  <p>Известный английский архитектор XVIII века, испытавший в
  своем творчестве сильное влияние античной архитектуры. (Здесь и
  далее прим. ред.)</p>
 </section>
 <section id="note2">
  <title>
   <p>2</p>
  </title>
  <p>Американский просветитель, живший в XVIII веке</p>
 </section>
</body>

Смотри также

Комментарии

Все ссылки на текст в <body> с атрибутом name="notes" должны иметь атрибут type="note" - опять же для совместимости с существующим софтом. Отображение текста, недоступного через <a type="note"> не гарантируется.

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

<xs:element name="body" maxOccurs="unbounded">
 <xs:annotation>
  <xs:documentation>Main content of the book, multiple bodies are 
    used for additional information, like footnotes, that do not 
    appear in the main book flow. The first body is presented to 
    the reader by default, and content in the other bodies should 
    be accessible by hyperlinks. Name attribute should describe 
    the meaning of this body, this is optional for the main body.
  </xs:documentation>
 </xs:annotation>
 <xs:complexType>
  <xs:sequence>
   <xs:element name="image" type="imageType" minOccurs="0">
    <xs:annotation>
     <xs:documentation>Image to be displayed at the top of this 
       section</xs:documentation>
    </xs:annotation>
   </xs:element>
   <xs:element name="title" type="titleType" minOccurs="0">
    <xs:annotation>
     <xs:documentation>A fancy title for the entire book, should 
       be used if the simple text version in <description> 
       is not adequate, e.g. the book title has multiple paragraphs
       and/or character styles</xs:documentation>
    </xs:annotation>
   </xs:element>
   <xs:element name="epigraph" type="epigraphType" minOccurs="0" maxOccurs="unbounded">
    <xs:annotation>
     <xs:documentation>Epigraph(s) for the entire book, if any</xs:documentation>
    </xs:annotation>
   </xs:element>
   <xs:element name="section" type="sectionType" maxOccurs="unbounded"/>
  </xs:sequence>
  <xs:attribute name="name" type="xs:string" use="optional"/>
  <xs:attribute ref="xml:lang"/>
 </xs:complexType>
</xs:element>

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

{{{epub3}}}