<ref> reference

Description:

An internal linking element that provides for movement from one place in a MEI document to another point in the same document. Unlike the <ptr> element, <ref> may contain text and sub-elements to describe the destination. Don't confuse this element with <extref> which provides for linking to an electronic object that is external to the MEI document. This element is modelled on an element in Encoded Archival Description (EAD).

May contain:

PCDATA, abbr, address, annot, bibl, corpname, date, expan, extptr, extref, fig, geogname, identifier, lb, name, num, pb, periodname, persname, ptr, ref, rend, repository, stack, stylename, title

May occur within:

abbr, accessdesc, acqsource, add, addressline, altmeiid, anchoredtext, annot, bibl, caption, condition, corpname, corr, damage, date, del, dimensions, dir, dynam, edition, event, exhibithist, expan, extent, extref, fw, geogname, hand, harm, head, identifier, inscription, item, l, label, language, lem, line, name, num, orig, p, periodname, persname, pgdesc, pgfoot1, pgfoot2, pghead1, pghead2, physloc, physmedium, price, provenance, rdg, ref, reg, rend, repository, restore, sic, stack, stylename, supplied, syl, sysreq, td, tempo, term, th, title, treatmenthist, treatmentsched, unclear, userestrict

Attributes:

• n, optional, xs:NMTOKEN provides a label (name or number) for an element. While its value need not be unique, it is required to be a single token.

• plist, optional, xs:IDREFS contains a space separated list of ID references that identify logical events that participate in a collection, such as notes under a phrase mark.

• targettype, optional, xs:NMTOKEN in contrast with the role attribute, allows the target resource to be characterized using any convenient classification scheme or typology.

• xlink:actuate, optional, xs:token, onLoad, onRequest, other, none defines whether a link occurs automatically or must be requested by the user. It is used in conjunction with the show attribute to determine link behavior.

• xlink:role, optional, xs:anyURI indicates a property of the entire link. The value of the role attribute must be a URI reference as defined in [IETF RFC 2396], except that if the URI scheme used is allowed to have absolute and relative forms, the URI portion must be absolute. The URI reference identifies some resource that describes the intended property. When no value is supplied, no particular role value is to be inferred.

• xlink:show, optional, xs:token, new, replace, other, none defines 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.

• xlink:title, optional, CDATA contains a human-readable description of the entire link. A value is optional; if a value is supplied, it should contain a string that describes the resource. The use of this information is highly dependent on the type of processing being done. It may be used, for example, to make titles available to applications used by visually impaired users, or to create a table of links, or to present help text that appears when a user lets a mouse pointer hover over a starting resource.

• xml:id, optional, xs:ID regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value.

• xml:lang, optional, xs:language identifies the language of the word or text phrase marked. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use subtags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag's value.

Module:

ptrref