Элемент id — различия между версиями
| Строка 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>]]; | * [[Элемент document-info|<document-info>]]; | ||
* [[Элемент author|<author>]] ''(опционально, с версии 2.2)''; | * [[Элемент author|<author>]] ''(опционально, с версии 2.2)''; | ||
| Строка 22: | Строка 35: | ||
|example= | |example= | ||
| + | <pre> | ||
| + | <id>C03EEC10-4053-4913-86D0-F379926F3487</id> | ||
| + | </pre> | ||
|see= | |see= | ||
| + | |||
| + | |comments= | ||
|style= | |style= | ||
Версия 16:08, 4 апреля 2007
| Ошибка создания миниатюры: Не удаётся сохранить эскиз по месту назначения
|
Внимание! Содержимое этой страницы требуется написать или доделать начатое. |
Содержание
Элемент <id>
Описание
Уникальный идентификатор документа FB2. Каждый загружаемый в библиотеку FB2-документ должен иметь собственный <id>, отличающийся от ID других документов. Это значит, что при изменении книги, которая есть в библиотеке, <id> нужно сохранить; если же создается новая книга, это поле необходимо заполнить уникальной записью.
Формально разрешено использовать внутри тэга ID любые символы в любом количестве, но рекомендуется употреблять символы латиницы, цифры, и знаки подчеркивание и минус ("_", "-"). Других требований к идентификатору нет. Как вариант, можно заполнить поле согласно времени создания документа по формату YYYYMMDDhhmmss, например 20060728182041. Либо можно использовать разнообразные генераторы GUID и тому подобное.
С версии 2.2 элемент <id> также используется библиотекой для идентификации авторов, переводчиков и правообладателей книг. Должен заполняться библиотекой при добавлении книги, и в дальнейшем не меняться.
Версия FB
2.0 и выше, 2.2
Поддерживается
TODO: где поддерживается?
Атрибуты
Нет атрибутов.
Подчиненные элементы
Нет дочерних элементов, содержит текст - собственно идентификатор.
Подчинен
Может содержаться в следующих элементах:
- <document-info>;
- <author> (опционально, с версии 2.2);
- <publisher> (опционально, с версии 2.2);
- <translator> (опционально, с версии 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}}}
