<archref> Archival Reference

<archref> is a reference element that provides a citation and/or an electronic link to separately described archival materials of special interest. Examples of such materials include a record group and one of its large series (which might have separate EAD-encoded finding aids) and a general reference to a collection with similar content.

It can be used, with the HREF or ENTITYREF attribute, for linking to another EAD instance. It can also be used to cite archival materials within a <bibliography>, <relatedmaterial>, or <separatedmaterial> element. It may contain just text or some of the content-specific elements such as <origination>, <repository>, and <unittitle> to identify the different kinds of information in a citation.

It should not be confused with <bibref> element, which is used to cite works that are published entities or individual items that are not usefully designated as archival materials.

<archref> may be used within abstract>, <bibliography>, <bibref>, <container>, <creation>, <descrules>, <dimensions>, <emph>, <entry>, <event>, <extent>, <extref>, <item>, <label>, <langmaterial>, <langusage>, <materialspec>, <origination>, <otherfindaid>, <p>, <physdesc>, <physfacet>, <physloc>, <ref>, <relatedmaterial>, <repository>, <separatedmaterial>, <unitdate>, <unitid>, and <unittitle>.

Attributes

  • ALTRENDER – not required. Use if the content of the element should be displayed or printed differently than the rendering established in a style sheet for other occurrences of the element.
  • AUDIENCE – not required. Use to set whether the element’s contents will be visible to external users or to internal ones. Possible values are: “internal” and “external.”
  • ID – not required. Creates an ID for element. Can be used for linking.
  • ACTUATE – not required. Controls whether the link occurs automatically or requires user request. Values are: “onload” (automatically), “onrequest” (if user requests), “actuateother” (some other action occurs), and “actuatenone” (no action occurs).
  • ARCROLE – not required. URI preference that identifies a resource that describes some property of an arc-type or simple-type linking element.
  • ENCODINGANALOG – not required. May contain information to map this tag to a particular element in another schema.
  • ENTITYREF – not required. The name of a nonparsed entity declared in the declaration subset of the document that points to a machine-readable version of the cited reference.
  • HREF – not required. The locator for a remote resource in a simple or extended link. An HREF takes the form of a Uniform Resource Identifier (URI). If no URI is specified, the locator is assumed to be within the document that contains the linking element.
  • LINKTYPE – fixed. Value must be “simple.”
  • ROLE – not required. Information that explains to application software the part that a remote resource plays in a link.
  • SHOW – not required. Used in conjunction with ACTUATE to define whether a remote resource that is the target of a link appears at the point of the link, replaces the existing link, or appears in a new window. Possible values are: “embed” (target displays at point of link), “new” (target appears in new window), “replace” (target resource replaces currently-displayed resource), “showother” (take some other action), and “shownone” (no target resource displays).
  • TITLE – not required. A viewable caption.
  • XPOINTER – not required. The locator for a remote resource in a simple or locator link. The XPOINTER attribute takes the form of a Uniform Resource Identifier plus a reference, formulated in XPOINTER syntax, to a sub-resource of the remote resource. XPOINTER enables linking to specific sections of a document that are relative, i.e., based on their position in the document or their content, rather than by reference to a specific identifier such as an ID.

Subelements

<archref> may contain PCDATA as well as abbr>, <abstract>, <bibref>, <container>, <dao>, <daogrp>, <emph>, <expan>, <extptr>, <extref>, <langmaterial>, <lb />, <materialspec>, <note>, <origination>, <physdesc>, <physloc>, <ptr>, <ref>, <repository>, <title>, <unitdate>, <unitid>, and <unittitle>.

Examples

<relatedmaterial>
	<head>Related Collections</head>
	<archref>
		<unitid>BANC PIC 19xx.055--ffALB</unitid>,
		<unittitle><title>Photographs Taken During the U.S. Geological Surveys West
		of the 100th Meridian, 1871-1873</title>, by Timothy H. O'Sullivan and William Bell</unittitle>
	</archref>
	<archref>
		<unitid>BANC PIC 19xx.089--STER</unitid>,
		<unittitle><title>Stereoviews of the U.S. Geographical Survey Expedition West
		of the 100th Meridian of 1871</title>, by Timothy H. O'Sullivan</unittitle>
	</archref>
	<archref>
		<unitid>BANC PIC 19xx.273--PIC</unitid>,
		<unittitle>Geographical Surveys West of the 100th Meridian (U.S.). <title>New
		Mexico Photographs from the 1873 Geographical Survey West of the 100th Meridian</title></unittitle>
	</archref>
	<archref>
		<unitid>BANC PIC 1905.17116-.17119--STER</unitid>,
		<unittitle><title>Western Survey Expeditions of 1871, 1872, 1873, and 1874
		</title>, by Timothy H. O'Sullivan and William Bell</unittitle>
	</archref>
</relatedmaterial>

EAD tag library entry for <archref>.