EAD (Encoded Archival Description ; Version 2002 Official Site)

Encoded Archival Description Tag Library, Version 2002

EAD Elements

<ref> Reference

Description:

An internal linking element that provides for movement from one place in a finding aid to another place in the same finding aid. Unlike the internal Pointer <ptr> element, the <ref> element may contain text and subelements that identify or describe the referenced object. The <ref> element may be used in a variety of ways in an encoded finding aid. For example, a <ref> may provide a dynamic link from one Component <c> to another related Component <c> in the same way that See and See also references direct readers of paper-based finding aids. Or, a <ref> might be used to direct the reader from text in a scope and content note to a description of a Component <c> in a contents list.

While XML Linking Language (XLink) Version 1.0, which is the basis for EAD linking elements, is a stable document, examples of EAD usage are hypothetical and have not been tested in real XLink-based applications. Those wishing to use XLink are encouraged to consult the specification available online at <http://www.w3.org/TR/xlink/>.

May contain:

#PCDATA, abbr, address, archref, bibref, blockquote, chronlist, corpname, date, emph, expan, extptr, extref, famname, function, genreform, geogname, lb, list, name, note, num, occupation, origination, persname, ptr, repository, subject, table, title, unitdate, unittitle

May occur within:

abstract, archref, bibliography, bibref, container, creation, descrules, dimensions, emph, entry, event, extent, extref, indexentry, item, label, langmaterial, langusage, materialspec, origination, otherfindaid, p, physdesc, physfacet, physloc, ptrgrp, relatedmaterial, repository, separatedmaterial, unitdate, unitid, unittitle

Attributes:

ACTUATE #IMPLIED, onload, onrequest, actuateother, actuatenone
ALTRENDER #IMPLIED, CDATA
ARCROLE #IMPLIED, CDATA
AUDIENCE #IMPLIED, external, internal
HREF #IMPLIED, CDATA
ID #IMPLIED, ID
LINKTYPE #FIXED, simple, simple
ROLE #IMPLIED, CDATA
SHOW #IMPLIED, new, replace, embed, showother, shownone
TARGET #IMPLIED, IDREF
TITLE #IMPLIED, CDATA
XPOINTER #IMPLIED, CDATA

Example:

    <index>
        <head>Index to Correspondents and Recipients</head>
        <indexentry>
            <corpname>Bach &amp; Bros.</corpname>
            <ref linktype="simple" target="NonC:21-2" show="replace" actuate="onrequest">
            (In non correspondence)</ref>
        </indexentry>
        <indexentry>
            <namegrp>
                <corpname>Bacon and Lewis, Ltd.</corpname>
                <persname>Levering, Alexander M.</persname>
                <persname>Windom, Lucious</persname>
            </namegrp>
            <ref linktype="simple" target="Cres:18610408" show="replace" actuate="onrequest">
            (1861 Apr. 8, ALS, to W.W., re: inquiry into what to do with unsold flour)</ref>
        </indexentry> . . .
    </index>