<extref> Extended Reference

<extref> is a linking element that can include text and subelements as a part of its reference to an electronic object that is external to the EAD document. Either ENTITYREF or HREF should be used to identify the external object. To point to another location within the EAD document, use <ref>.

It may be used within: <abstract>, <archref>, <bibliography>, <bibref>, <container>, <creation>, <descrules>, <dimensions>, <emph>, <entry>, <event>, <extent>, <indexentry>, <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.
  • 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

<extref> may contain PCDATA as well as <abbr>, <address>, <archref>, <bibref>, <blockquote>, <chronlist>, <corpname>, <date>, <emph>, <expan>, <extptr>, <famname>, <function>, <genreform>, <geogname>, <lb />, <list>, <name>, <note>, <num>, <occupation>, <origination>, <persname>, <ptr>, <ref>, <repository>, <subject>, <table>, <title>, <unitdate>, and <unittitle>.

Examples

<bioghist>
	<head>Chronology</head>
	<chronlist> . . .
		<chronitem>
			<date normal="199510">October 1995</date>
			<event>
				<extref linktype="simple" entityref="nobelsite" title="Nobel Prize eMuseum"
					actuate="onrequest" show="new">Awarded Nobel Prize in Physics by the
					Royal Swedish Academy of Sciences.</extref>
			</event>
		</chronitem> . . .
	</chronlist>
</bioghist>

EAD tag library entry for <extref>.