<ref> Reference

<ref> is a linking element which may be used to create both internal and external links. Unlike the internal pointer <ptr/> element, <ref> may contain text and child elements that identify or describe the referenced object. It may be used in a variety of ways in an encoded finding aid. For example, it may provide a dynamic link from one <c> to another related <c> in the same way that “See” and “See also” references direct readers of paper-based finding aids. Or, it might be used to direct readers to another repository’s finding aid with related materials.

It may be used within: <abstract>, <addressline>, <archref>, <author>, <bibref>, <citation>, <container>, <date>, <datesingle>, <didnote>, <dimensions>, <edition>, <emph>, <entry>, <event>, <fromdate>, <head>, <head01>, <head02>, <head03>, <indexentry>, <item>, <label>, <materialspec>, <num>, <p>, <part>, <physdesc>, <physfacet>, <physloc>, <ptrgrp>, <publisher>, <quote>, <sponsor>, <subtitle>, <titleproper>, <todate>, <unitdate>, <unitid>, and <unittitle>.

Attributes

  • @actuate – not required. Determines whether a link occurs automatically or must be requested by a user. Possible values: onload, onrequest, other, none.
  • @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.
  • @arcrole – not required. Specifies the role that a remote resource plays in the link.
  • @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.”
  • @href –not required. May be used to designate a URI/URL for the material cited.
  • @id – not required. Creates an ID for element. Can be used for linking.
  • @lang – not required. Three-letter code that indicates the language in which the element’s contents were written. It should come from ISO 639-2b.
  • @linkrole – not required. Specifies the role that a remote resource plays in the link.
  • @linktitle – not required. Designates a title for the link.
  • @script – not required. Four-letter code that indicates the script in which the element’s contents were written. It should come from ISO 15924.
  • @show – not required. Specifies when a link will be shown. Possible values are: new, replace, embed, other, none.
  • @target – not required. Designates an @id reference to the referenced object.
  • @xpointer – not required. The locator for a remote resource in a simple or locator link. The @xpointer attribute takes the form of a URI 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.

Child Elements

<ref> may contain text as well as <abbr>, <corpname>, <date>, <emph>, <expan>, <famname>, <footnote>, <function>, <genreform>, <geogname>, <lb/>, <name>, <num>, <occupation>, <persname>, <ptr/>, <quote>, <subject>, and <title>.

Examples

<ref href="http://catalog.hogwarts.ac.uk/record=b11725882" show="new" actuate="onrequest">Catalog record for <title><part>Hogwarts: a History</part></title></ref>
<ptrgrp>
	<ref show="new" actuate="onrequest" href="http://eadiva.com/hogwarts-cpf/G.001.xml">Biographical and Relational Information</ref>
	<ptr target="ggry" show="replace" actuate="onrequest" linktitle="Relationship to Salazar Slytherin"/>
</ptrgrp>

Changes from EAD 2002

<ref> had minor changes from EAD 2002. @role changed to @linkrole, @title changed to @linktitle. It lost attribute @linktype, and child elements <chronlist>, <extptr>, <extref>, and <list>.

EAD3 Tag Library Entry

View the official tag library entry for <ref>