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.