◇◆
document-id Document Component Identifier
Identifier of a major document component within a publication that is (or contains)
the target of the <related-object> element.
Usage/Remarks
The
@document-id
attribute holds an external
identifier assigned to a publication that is part of the description of a related
object (<related-object>). The contents of this
attribute should not be confused with the @id attribute, which holds an internal document identifier that can be used by software to perform a simple link inside
the document.
Best Practice
For each source, document, and object, an identifier should be specified on the corresponding
attribute.
For any related-object link, the @source-id attribute points to the largest publishable unit, for example, an entire book. The
@document-id attribute points to a major component of the source, for example, a chapter, front
matter section (Preface), or back matter section (Appendix) of a book. Use the @object-id attribute to point to any item within the specified major document component, for
example, a section, figure, table, or reference within the chapter of the book.
Where the more specific attributes are populated, the less specific attributes should
also be populated. For example, if @object-id is specified, then both @document-id and @source-id should also be populated. If @source-id points to the intended target (an entire book), then neither @document-id nor @object-id should be specified.
The <related-object> element can also provide a name for the type of each identifier used, for example,
ISBN, ISSN, DOI, XMLID, URI, and so on. These go on @source-id-type, @document-id-type, and @object-id-type as appropriate.
OPTIONAL on element: <related-object>
Value | Meaning |
---|---|
Text, numbers, or special characters | An identifier for the document that contains the related object (<related-object>). |
Restriction | @document-id is an optional attribute; there is no default. |