diff options
author | Ben McGinnes <ben@adversary.org> | 2018-02-16 05:56:36 +1100 |
---|---|---|
committer | Ben McGinnes <ben@adversary.org> | 2018-02-16 05:56:36 +1100 |
commit | 56cdc358ea5390ea23cf852caf5d274e624708c3 (patch) | |
tree | 672a6e31a0fafa1b67a70275fa4e7c33fc56877c /nov.el | |
parent | 4ef20ebb587ffb0ab73c85ad5748d41af1071596 (diff) |
Not a UUID
* Changed the help strings referring to the unique identifier to
remove references to UUIDs as that may lead to confusion.
* While the identifier must be unique and while UUIDs are often
utlised for that purpose due to being easy to generate
programmarically, it is not a requirement of the OPF standard that
this identifier must be a UUID.
* The OPF standard only specifies that the package element use the
unique-identifire attribute to reference the identifier in the
metadata element. In turn the metadata element utilises the
dc:identifier attribute with the ID matching the previous reference
and the unique string of whatever format is specified. Additional
information can be supplied in subsequent meta tags.
* Common identifier types used include, but are not limited to: ISBNs,
ISSNs, domain name based strings, URL based strings, MD5 hash
digests, SHA hash digests, UUIDs and assorted other codes, including
arbitrary ones set by the creator (including those hard coded in by
creation software).
* See also:
http://www.idpf.org/epub/30/spec/epub30-publications.html#sec-opf-metadata-identifiers-uid
http://dublincore.org/documents/dcmi-terms/#terms-identifier
Diffstat (limited to 'nov.el')
-rw-r--r-- | nov.el | 6 |
1 files changed, 3 insertions, 3 deletions
@@ -225,9 +225,9 @@ If PARSE-XML-P is t, return the contents as parsed by libxml." version)) (defun nov-content-unique-identifier-name (content) - "Return the UUID name for CONTENT. + "Return the unique identifier name referenced in CONTENT. This is used in `nov-content-unique-identifier' to retrieve the -UUID." +the specific type of unique identifier." (let* ((node (esxml-query "package[unique-identifier]" content)) (name (esxml-node-attribute 'unique-identifier node))) (when (not name) @@ -235,7 +235,7 @@ UUID." name)) (defun nov-content-unique-identifier (content) - "Return the UUID for CONTENT." + "Return the the unique identifier for CONTENT." (let* ((name (nov-content-unique-identifier-name content)) (selector (format "package>metadata>identifier[id='%s']" (regexp-quote name))) |