MODS Schema - Common AttributesThis paper describes certain attributes defined in the MODS schema. Specifically, it described attributes used by multiple (but not necessarily all) elements. The main purpose of this document is to provide links (anchors) that can be used by the MODS Guidelines when describing elements that use these attributes.
Language-Related Attributeslang@lang indicates the language of the content of an element, using a code from ISO 639-2/b.
xml:lang@xml:lang serves the same purpose as @lang, using codes from RFC 3066, two-character ISO 639-1) codes, along with three-character ISO 639-2 codes for languages not listed in 639-1.
scriptIndicates the script used for an element, using codes from ISO 15924 (Code for the representation of names of scripts).
transliterationIndicates the transliteration technique used for an element. See https://www.loc.gov/catdir/cpso/roman.html for suggested values.
Date AttributesThese attributes are used with date elements: <dateIssued>, <dateCreated), <dateCaptured>, etc. encoding@encoding indicates how the date is encoded and is one of the following values:
pointWhen @point is included, that means that the activity (creation, etc.) occurred over a date interval rather than on a single date. @point has the following values:
If @point is not included, the activity assumed to have occurred on a single date.
If an activity of a given type (e.g. "capture") occurs more than once, each should be represented within separate instances of <originInfo>. If an activity has a start and end, the pair is to be represented within the same instance of <originInfo>.
keyDateThe only value for @keyDate is "yes" to indicate that a particular date is distinguished among several dates. The sense in which the date is a "key" date depends on the application.
The following values are defined for @qualifier:
@calendar may be used to supply an alternative calendar (the default is "gregorian").
Linking attributesExternal Linking @ID which is of type xs:ID (in the xs: namespace, http://www.w3.org/2001/XMLSchema), is used to attach an identifier to an element; the identifier acts as an anchor so that the element may be linked to from outside the MODS instance.
xlink:hrefUsed to link to external content. In the following example, the<abstract> element is empty, the content of the abstract is in an external file, and a link is provided.
Internal LinkingaltRepGroupused to link alternative representations of the same element content, for different languages, scripts, transliterations, and translations. The same attribute value is applied to each of the element instances to be linked.
nameTitleGroup@nameTitleGroup can be used with <name> and <titleInfo> to link a name and a title. (The same value is assigned for the name and the title.) It can be used to link names to uniform titles when the name-uniform title combination is an authority-controlled heading. In the following example, there are multiple names and multiple titles, and @nameTitleGroup is used to link together one name/title pair.
Authority AttributesauthorityThe name of an authoritative list of terms for an element whose values are controlled. In the following example "marcrelator" is the name of the controlled list at https://www.loc.gov/marc/relators/relaterm.html
@authority for <languageTerm>, <placeTerm>, and "geographicCode> (and only for these three elements) are defined with controlled lists: Controlled list of values for @authority for <languageTerm>
Controlled list of values for @authority for <placeTerm> and <geographicCode>
authorityURIThe URI for the authoritative list. In the following example, https://www.loc.gov/marc/relators/relaterm.html is the URI for the controlled list whose name is"marcrelator". When @authorityURI is known, it should be supplied rather than @authority.
valueURIWhen the authoritative list is a linked data vocabulary (not so in the above examples) @valueURI can point directly to the term, and the element value is optional (it may be omitted).
It is recommended that when using one of these authority attributes -- @authority, @authorityURI, and @valueURI -- at most one of these should be included. @valueURI should be included (and the other two omitted) if known. If @valueURI is not known, @authorityURI should be supplied (and @authority omitted) if known. @authority should be supplied only if neither @valueURI and @authorityURI is known.
Miscellaneous AttributesdisplayLabelThe value of @displayLabel is text, for display purposes only. It should not be used to supply structured or machine processible information.
altFormat and contentTypeAn element might express its content in plain text, and there may be equivalent content elsewhere using a different encoding, for example HTML. @altFormat is a URI pointing to that content. It applies to elements not easily expressed inside a MODS XML record and are best expressed via HTML or some other format. Optionally, the @contentType attribute may be included with a media-type as its value (e.g. text/html) to indicate the content type of the resource. Where there are multiple alternatives, use @altRepGroup attribute to bind together the related instances.
usage@usage values are "primary" and "primaryDisplay" ("primary' is preferred; "primaryDisplay" will be deprecated in the future.) It is used for a repeated element to declare that a particular instance of the element is most important. For example, when several names are included in a MODS record, @usage may be used to declare a "primary" name.
shareable@shareable indicates whether the content of the element (e.g. an abstract or table of contents) may be shared. This attribute should be included only if the content may not be shared, in which case the value should be "no". If the content may be shared, the attribute should be omitted.
supplied@supplied indicates whether the content of the element (e.g. a title) has been supplied (as opposed to having been constructed by the cataloger). This attribute should be included only if the content was supplied, in which case the value should be "yes". If not, the attribute should be omitted.
codeOrTextValues for @codeOrText are "code" and "text". It applies to elements whose value is normally taken from a controlled vocabulary where terms are expressed as both codes and as text.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||