Элемент id — различия между версиями
м |
|||
(не показана 1 промежуточная версия 1 участника) | |||
Строка 2: | Строка 2: | ||
{{Шаблон:FB Элемент|name=id | {{Шаблон:FB Элемент|name=id | ||
− | |description= | + | |description= |
+ | Уникальный идентификатор документа FB2. | ||
+ | Каждый загружаемый в библиотеку FB2-документ должен иметь собственный [[Элемент id|<id>]], отличающийся | ||
+ | от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, [[Элемент id|<id>]] | ||
+ | нужно сохранить; если же создается новая книга, это поле необходимо заполнить уникальной записью. | ||
− | |version=2.0 и выше | + | Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы |
+ | латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. | ||
+ | Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. | ||
+ | Либо можно использовать разнообразные генераторы GUID и тому подобное. | ||
+ | |||
+ | С '''версии 2.2''' элемент [[Элемент id|<id>]] также используется библиотекой для идентификации авторов, | ||
+ | переводчиков и правообладателей книг. Должен заполняться библиотекой при добавлении книги, и в дальнейшем не меняться. | ||
+ | |||
+ | |version=2.0 и выше, 2.2 | ||
|supported by= | |supported by= | ||
Строка 10: | Строка 22: | ||
|attributes= | |attributes= | ||
− | Нет | + | Нет атрибутов. |
|children= | |children= | ||
− | Нет | + | Нет дочерних элементов, содержит текст - собственно идентификатор. |
|parents= | |parents= | ||
− | * [[Элемент document-info|<document-info>]]; | + | Может содержаться в следующих элементах: |
− | * [[Элемент author|<author>]] ''(опционально, с версии 2.2)''; | + | * [[Элемент document-info|<document-info>]] - ''1 (один, обязателен)''; |
− | * [[Элемент publisher|<publisher>]] ''(опционально, с версии 2.2)''; | + | * [[Элемент author|<author>]] ''0..1 (один, опционально, с версии 2.2)''; |
− | * [[Элемент translator|<translator>]] ''(опционально, с версии 2.2)''. | + | * [[Элемент publisher|<publisher>]] ''0..1 (один, опционально, с версии 2.2)''; |
+ | * [[Элемент translator|<translator>]] ''0..1 (один, опционально, с версии 2.2)''. | ||
|example= | |example= | ||
+ | <pre> | ||
+ | <id>C03EEC10-4053-4913-86D0-F379926F3487</id> | ||
+ | </pre> | ||
|see= | |see= | ||
+ | |||
+ | |comments= | ||
|style= | |style= |
Текущая версия на 12:24, 10 июля 2007
Ошибка создания миниатюры: Не удаётся сохранить эскиз по месту назначения
|
Внимание! Содержимое этой страницы требуется написать или доделать начатое. |
Содержание
Элемент <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}}}