Элемент id

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

Элемент <id>

Описание

Уникальный идентификатор документа FB2. Каждый загружаемый в библиотеку FB2-документ должен иметь собственный <id>, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, <id> нужно сохранить; если же создается новая книга, это поле необходимо заполнить уникальной записью.

Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. Либо можно использовать разнообразные генераторы GUID и тому подобное.

С версии 2.2 элемент <id> также используется библиотекой для идентификации авторов, переводчиков и правообладателей книг. Должен заполняться библиотекой при добавлении книги, и в дальнейшем не меняться.

Версия FB

2.0 и выше, 2.2

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

TODO: где поддерживается?

Атрибуты

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

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

Нет дочерних элементов, содержит текст - собственно идентификатор.

Подчинен

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

  • <document-info> - 1 (один, обязателен);
  • <author> 0..1 (один, опционально, с версии 2.2);
  • <publisher> 0..1 (один, опционально, с версии 2.2);
  • <translator> 0..1 (один, опционально, с версии 2.2).

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

<id>C03EEC10-4053-4913-86D0-F379926F3487</id>

Смотри также

Комментарии

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

<xs:element name="id" type="xs:token">
 <xs:annotation>
  <xs:documentation>this is a unique identifier for a document. this must not change</xs:documentation>
 </xs:annotation>
</xs:element>
...
<xs:element name="id" type="xs:token" minOccurs="0"/>

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

{{{epub3}}}