<ref>

(reference) – Defines a traversible reference to another location. May contain text and sub-elements that describe the destination.
13.2.1 Pointers and References, 13.2.2 Specifying Link Elements
Module
MEI.ptrref
Attributes
class, copyof, corresp, decls, evaluate, follows, label, mimetype, n, next, precedes, prev, resp, sameas, synch, target, targettype, translit, type, xlink:actuate, xlink:role, xlink:show, xml:base, xml:id, xml:lang
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.typedatt.classed@class
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
<ref>att.commonatt.linking@copyof
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.linking@corresp
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
<ref>att.metadataPointing@decls
evaluate(optional)Specifies the intended meaning when a participant in a relationship is itself a pointer. Allowed values are: "all" (If an element pointed to is itself a pointer, then the target of that pointer will be taken, and so on, until an element is found which is not a pointer.), "one" (If an element pointed to is itself a pointer, then its target (whether a pointer or not) is taken as the target of this pointer.), "none" (No further evaluation of targets is carried out beyond that needed to find the element(s) specified in plist or target attribute.)
<ref>att.targetEval@evaluate
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.linking@follows
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
<ref>att.commonatt.labelled@label
mimetype(optional)Specifies the applicable MIME (multimedia internet mail extension) type. The value should be a valid MIME media type defined by the Internet Engineering Task Force in RFC 2046. Value is plain text.
<ref>att.internetMedia@mimetype
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
<ref>att.commonatt.nNumberLike@n
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.linking@next
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.linking@precedes
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.linking@prev
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.responsibility@resp
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.linking@sameas
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
<ref>att.commonatt.linking@synch
target(optional)Identifies passive participants in a relationship; that is, the entities pointed "to". One or more values from data.URI, separated by spaces.
<ref>att.pointing@target
targettype(optional)Characterization of target resource(s) using any convenient classification scheme or typology. Value is a NMTOKEN.
<ref>att.pointing@targettype
translit(optional)Specifies the transliteration technique used. Value is a NMTOKEN.
<ref>att.lang@translit
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
<ref>att.commonatt.typed@type
xlink:actuate(optional)Defines whether a link occurs automatically or must be requested by the user. Allowed values are: "onLoad" (Load the target resource(s) immediately.), "onRequest" (Load the target resource(s) upon user request.), "none" (Do not permit loading of the target resource(s).), "other" (Behavior other than allowed by the other values of this attribute.)
<ref>att.pointing@xlink:actuate
xlink:role(optional)Characterization of the relationship between resources. The value of the role attribute must be a URI. Value conforms to data.URI.
<ref>att.pointing@xlink:role
xlink:show(optional)Defines how a remote resource is rendered. Allowed values are: "new" (Open in a new window.), "replace" (Load the referenced resource in the same window.), "embed" (Embed the referenced resource at the point of the link.), "none" (Do not permit traversal to the referenced resource.), "other" (Behavior other than permitted by the other values of this attribute.)
<ref>att.pointing@xlink:show
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
<ref>att.commonatt.basic@xml:base
xml:id(optional)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. Value is a valid xml:id.
<ref>att.commonatt.basicatt.id@xml:id
xml:lang(optional)Identifies the language of the element’s content. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use sub-tags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag’s value. Value is a language.
<ref>att.lang@xml:lang
(MEI.shared) Attributes common to many elements.
(MEI.shared) Attributes that form the basis of the att.common class.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
(MEI.shared) Attributes that uniquely identify an element.
xml:id(optional)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. Value is a valid xml:id.
(MEI.shared)
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
(MEI.shared) Attributes that specify element-to-element relationships.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes used to supply a number-like designation for an element.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
(MEI.shared) Attributes capturing information regarding responsibility for some aspect of the text's creation, transcription, editing, or encoding.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which record the type of an electronic resource.
mimetype(optional)Specifies the applicable MIME (multimedia internet mail extension) type. The value should be a valid MIME media type defined by the Internet Engineering Task Force in RFC 2046. Value is plain text.
(MEI.shared) Language attributes common to text elements.
xml:lang(optional)Identifies the language of the element’s content. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use sub-tags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag’s value. Value is a language.
translit(optional)Specifies the transliteration technique used. Value is a NMTOKEN.
(MEI.shared) Provides attributes for elements which may be associated with particular contextual elements within the header.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes common to all pointing/linking elements.
xlink:actuate(optional)Defines whether a link occurs automatically or must be requested by the user. Allowed values are: "onLoad" (Load the target resource(s) immediately.), "onRequest" (Load the target resource(s) upon user request.), "none" (Do not permit loading of the target resource(s).), "other" (Behavior other than allowed by the other values of this attribute.)
xlink:role(optional)Characterization of the relationship between resources. The value of the role attribute must be a URI. Value conforms to data.URI.
xlink:show(optional)Defines how a remote resource is rendered. Allowed values are: "new" (Open in a new window.), "replace" (Load the referenced resource in the same window.), "embed" (Embed the referenced resource at the point of the link.), "none" (Do not permit traversal to the referenced resource.), "other" (Behavior other than permitted by the other values of this attribute.)
target(optional)Identifies passive participants in a relationship; that is, the entities pointed "to". One or more values from data.URI, separated by spaces.
targettype(optional)Characterization of target resource(s) using any convenient classification scheme or typology. Value is a NMTOKEN.
(MEI.shared) Attributes that deal with resolution of values in plist or target attributes.
evaluate(optional)Specifies the intended meaning when a participant in a relationship is itself a pointer. Allowed values are: "all" (If an element pointed to is itself a pointer, then the target of that pointer will be taken, and so on, until an element is found which is not a pointer.), "one" (If an element pointed to is itself a pointer, then its target (whether a pointer or not) is taken as the target of this pointer.), "none" (No further evaluation of targets is carried out beyond that needed to find the element(s) specified in plist or target attribute.)
Component declarations that are shared between two or more modules.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
evaluate(optional)Specifies the intended meaning when a participant in a relationship is itself a pointer. Allowed values are: "all" (If an element pointed to is itself a pointer, then the target of that pointer will be taken, and so on, until an element is found which is not a pointer.), "one" (If an element pointed to is itself a pointer, then its target (whether a pointer or not) is taken as the target of this pointer.), "none" (No further evaluation of targets is carried out beyond that needed to find the element(s) specified in plist or target attribute.)
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
mimetype(optional)Specifies the applicable MIME (multimedia internet mail extension) type. The value should be a valid MIME media type defined by the Internet Engineering Task Force in RFC 2046. Value is plain text.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
target(optional)Identifies passive participants in a relationship; that is, the entities pointed "to". One or more values from data.URI, separated by spaces.
targettype(optional)Characterization of target resource(s) using any convenient classification scheme or typology. Value is a NMTOKEN.
translit(optional)Specifies the transliteration technique used. Value is a NMTOKEN.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
xlink:actuate(optional)Defines whether a link occurs automatically or must be requested by the user. Allowed values are: "onLoad" (Load the target resource(s) immediately.), "onRequest" (Load the target resource(s) upon user request.), "none" (Do not permit loading of the target resource(s).), "other" (Behavior other than allowed by the other values of this attribute.)
xlink:role(optional)Characterization of the relationship between resources. The value of the role attribute must be a URI. Value conforms to data.URI.
xlink:show(optional)Defines how a remote resource is rendered. Allowed values are: "new" (Open in a new window.), "replace" (Load the referenced resource in the same window.), "embed" (Embed the referenced resource at the point of the link.), "none" (Do not permit traversal to the referenced resource.), "other" (Behavior other than permitted by the other values of this attribute.)
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
xml:id(optional)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. Value is a valid xml:id.
xml:lang(optional)Identifies the language of the element’s content. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use sub-tags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag’s value. Value is a language.
Member of
model.locrefLikeGroups elements used for purposes of location and reference.
Contained By
(MEI.ptrref) Groups elements used for purposes of location and reference.
applicationProvides information about an application which has acted upon the current document.
pgDescContains a brief prose description of the appearance or description of the content of a physical page.
seriesContains information about the serial publication in which a bibliographic item has appeared.
(MEI.shared) Groups textual elements that occur at the level of individual words or phrases. This class is equivalent to the model.textPhraseLike class without the pb element.
acquisitionRecords information concerning the process by which an item was acquired by the holding institution.
actorName of an actor appearing within a cast list.
anchoredTextContainer for text that is fixed to a particular page location, regardless of changes made to the layout of the measures around it.
arrangerA person or organization who transcribes a musical composition, usually for a different medium from that of the original; in an arrangement the musical substance remains essentially unchanged.
attaccaAn instruction to begin the next section or movement of a composition without pause.
authorThe name of the creator of the intellectual content of a non-musical, literary work.
biblScopeDefines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work.
bindingDescDescribes the present and former bindings of an item.
bracketSpanMarks a sequence of notational events grouped by a bracket.
bylineContains the primary statement of responsibility given for a work on its title page.
composerThe name of the creator of the intellectual content of a musical work.
contributorNames of individuals, institutions, or organizations responsible for contributions to the intellectual content of a work, where the specialized elements for authors, editors, etc. do not suffice or do not apply.
cpMarkA verbal or graphical indication to copy musical material written elsewhere.
creationNon-bibliographic details of the creation of an intellectual entity, in narrative form, such as the date, place, and circumstances of its composition. More detailed information may be captured within the history element.
decoDescContains a description of the decoration of an item.
decoNoteContains a description of one or more decorative features of an item.
dedicateeEntity to whom a creative work is formally offered.
dedicationContains a dedicatory statement.
depthDescription of a measurement taken through a three-dimensional object.
descContainer for text that briefly describes the feature to which it is attached, including its intended usage, purpose, or application as appropriate.
dimAny single dimensional specification.
dirAn instruction expressed as a combination of text and symbols, typically above, below, or between staves, but not on the staff — that is not encoded elsewhere in more specific elements, like tempo, dynam or repeatMark.
distributorPerson or agency, other than a publisher, from which access (including electronic access) to a bibliographic entity may be obtained.
dynamIndication of the volume of a note, phrase, or section of music.
editionA word or text phrase that indicates a difference in either content or form between the item being described and a related item previously issued by the same publisher/distributor (e.g., 2nd edition, version 2.0, etc.), or simultaneously issued by either the same publisher/distributor or another publisher/distributor (e.g., large print edition, British edition, etc.).
editorThe name of the individual(s), institution(s) or organization(s) acting in an editorial capacity.
exhibHistA record of public exhibitions, including dates, venues, etc.
extentUsed to express size in terms other than physical dimensions, such as number of pages, records, bytes, physical components, etc.
fSingle element of a figured bass indication.
figDescContains a brief prose description of the appearance or content of a graphic figure, for use when documenting an image without displaying it.
fingAn individual finger in a fingering indication.
funderNames of individuals, institutions, or organizations responsible for funding. Funders provide financial support for a project; they are distinct from sponsors, who provide intellectual support and authority.
genreTerm or terms that designate a category characterizing a particular style, form, or content.
glissA continuous or sliding movement from one pitch to another, usually indicated by a straight or wavy line.
handDefines a distinct scribe or handwriting style.
harmAn indication of harmony, e.g., chord names, tablature grids, harmonic analysis, figured bass.
heightDescription of the vertical size of an object.
labelA container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the label attribute.
labelAbbrA label on the pages following the first.
languageDescription of a language used in the document.
layoutDescCollects layout descriptions.
librettistPerson or organization who is a writer of the text of an opera, oratorio, etc.
lineA visual line that cannot be represented by a more specific; i.e., semantic, element.
lyricistPerson or organization who is a writer of the text of a song.
metaMarkA graphical or textual statement with additional / explanatory information about the musical text. The textual consequences of this intervention are encoded independently via other means; that is, with elements such as add, del, etc.
octaveAn indication that a passage should be performed one or more octaves above or below its written pitch.
ornamAn element indicating an ornament that is not a mordent, turn, or trill.
perfResName of an instrument on which a performer plays, a performer's voice range, or a standard performing ensemble designation.
pgFootA running footer.
pgHeadA running header.
priceThe cost of access to a bibliographic item.
provenanceThe record of ownership or custodianship of an item.
pubPlaceName of the place where a bibliographic item was published.
publisherName of the organization responsible for the publication of a bibliographic item.
recipientThe name of the individual(s), institution(s) or organization(s) receiving correspondence.
repeatMark An instruction expressed as a combination of text and symbols – segno and coda – typically above, below, or between staves, but not on the staff.
repositoryInstitution, agency, or individual which holds a bibliographic item.
respA phrase describing the nature of intellectual responsibility.
roleName of a dramatic role, as given in a cast list.
roleDescDescribes a character’s role in a drama.
scriptDescContains a description of the letters or characters used in an autographic item.
sealA single seal or similar attachment.
sealDescDescribes the seals or similar external attachments applied to an item.
signifLetSignificantive letter(s).
soundChanReflects the number of apparent sound channels in the playback of a recording (monaural, stereophonic, quadraphonic, etc.).
speakerContains a specialized form of heading or label, giving the name of one or more speakers in a dramatic text or fragment.
sponsorNames of sponsoring individuals, organizations or institutions. Sponsors give their intellectual authority to a project; they are to be distinguished from funders, who provide the funding but do not necessarily take intellectual responsibility.
stackAn inline table with a single column.
stageDirContains any kind of stage direction within a dramatic text or fragment.
supportDescGroups elements describing the physical support material of an item.
sylIndividual lyric syllable.
tempoText and symbols descriptive of tempo, mood, or style, e.g., "allarg.", "a tempo", "cantabile", "Moderato", "♩=60", "Moderato ♩ =60").
termKeyword or phrase which describes a resource.
textLangIdentifies the languages and writing systems within the work described by a bibliographic description, not the language of the description.
treatHistA record of the treatment the item has undergone (e.g., de-acidification, restoration, etc.).
treatSchedScheduled treatment, e.g., de-acidification, restoration, etc., for an item.
typeDescContains a description of the typefaces or other aspects of the printing of a printed source.
widthDescription of the horizontal size of an object.
(MEI.critapp) Groups elements that may appear as part of a textual variant.
(MEI.critapp) Groups elements that may appear as part of a textual or musical variant.
lemContains the lemma, or base text, of a textual variation.
rdgContains a single reading within a textual variation.
(MEI.edittrans) Groups elements that may appear as part of editorial and transcription elements in prose.
(MEI.edittrans) Groups elements that may appear as part of editorial and transcription elements.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
(MEI.shared) Groups textual elements that occur at the level of individual words or phrases.
addNameContains an additional name component, such as a nickname, epithet, or alias, or any other descriptive phrase used within a personal name.
addrLineSingle line of a postal address.
annotProvides a statement explaining the text or indicating the basis for an assertion.
biblProvides a loosely-structured bibliographic citation in which the sub-components may or may not be explicitly marked.
blocContains the name of a geopolitical unit consisting of two or more nation states or countries.
captionA label which accompanies an illustration or a table.
contentItemContains a single entry within a content description element.
corpNameIdentifies an organization or group of people that acts as a single entity.
countryContains the name of a geopolitical unit, such as a nation, country, colony, or commonwealth, larger than or administratively superior to a region and smaller than a bloc.
dateA string identifying a point in time or the time period between two such points.
districtContains the name of any kind of subdivision of a settlement, such as a parish, ward, or other administrative or geographic unit.
famNameContains a family (inherited) name, as opposed to a given, baptismal, or nick name.
foreNameContains a forename, given or baptismal name.
genNameContains a name component used to distinguish otherwise similar names on the basis of the relative ages or generations of the persons named.
geogFeatContains a common noun identifying a geographical feature.
geogNameThe proper noun designation for a place, natural feature, or political jurisdiction.
headContains any heading, for example, the title of a section of text, or the heading of a list.
identifierAn alpha-numeric string that establishes the identity of the described material.
imprintInformation relating to the publication or distribution of a bibliographic item.
lContains a single line of text within a line group.
liSingle item in a list.
nameProper noun or noun phrase.
nameLinkContains a connecting phrase or link used within a name but not regarded as part of it, such as "van der" or "of", "from", etc.
numNumeric information in any form.
periodNameA label that describes a period of time, such as 'Baroque' or '3rd Style period'.
persNameDesignation for an individual, including any or all of that individual's forenames, surnames, honorific titles, and added names.
qContains material which is distinguished from the surrounding phrase-level text using quotation marks or a similar method. Use quote for block-level quotations.
refDefines a traversible reference to another location. May contain text and sub-elements that describe the destination.
regionContains the name of an administrative unit such as a state, province, or county, larger than a settlement, but smaller than a country.
rendA formatting element indicating special visual rendering, e.g., bold or italicized, of a text word or phrase.
roleNameContains a name component which indicates that the referent has a particular role or position in society, such as an official title or rank.
segrepresents any segmentation of text below the "text component" level.
settlementContains the name of a settlement such as a city, town, or village identified as a single geopolitical or administrative unit.
streetfull street address including any name or number identifying a building as well as the name of the street or route on which it is located.
styleNameA label for a characteristic style of writing or performance, such as 'bebop' or 'rock-n-roll'.
tdDesignates a table cell that contains data as opposed to a cell that contains column or row heading information.
thDesignates a table cell containing column or row heading information as opposed to one containing data.
(MEI.shared) Groups elements which may appear as part of the paragraph content model. A paragraph may contain inline elements and all other block-level elements except itself.
epigraphContains a quotation, anonymous or attributed, appearing on a title page.
imprimaturContains a formal statement authorizing the publication of a work, sometimes required to appear on a title page or its verso.
pOne or more text phrases that form a logical prose passage.
quoteContains a paragraph-like block of text attributed to an external source, normally set off from the surrounding text by spacing or other typographic distinction.
Common Music Notation (CMN) repertoire component declarations.
attaccaAn instruction to begin the next section or movement of a composition without pause.
bracketSpanMarks a sequence of notational events grouped by a bracket.
glissA continuous or sliding movement from one pitch to another, usually indicated by a straight or wavy line.
octaveAn indication that a passage should be performed one or more octaves above or below its written pitch.
repeatMark An instruction expressed as a combination of text and symbols – segno and coda – typically above, below, or between staves, but not on the staff.
Critical apparatus component declarations.
lemContains the lemma, or base text, of a textual variation.
rdgContains a single reading within a textual variation.
Dramatic text component declarations.
stageDirContains any kind of stage direction within a dramatic text or fragment.
Editorial and transcriptional component declarations.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
cpMarkA verbal or graphical indication to copy musical material written elsewhere.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
metaMarkA graphical or textual statement with additional / explanatory information about the musical text. The textual consequences of this intervention are encoded independently via other means; that is, with elements such as add, del, etc.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Figures and tables component declarations.
figDescContains a brief prose description of the appearance or content of a graphic figure, for use when documenting an image without displaying it.
tdDesignates a table cell that contains data as opposed to a cell that contains column or row heading information.
thDesignates a table cell containing column or row heading information as opposed to one containing data.
Fingering component declarations.
fingAn individual finger in a fingering indication.
Harmony component declarations.
fSingle element of a figured bass indication.
harmAn indication of harmony, e.g., chord names, tablature grids, harmonic analysis, figured bass.
Metadata header component declarations.
acquisitionRecords information concerning the process by which an item was acquired by the holding institution.
applicationProvides information about an application which has acted upon the current document.
bylineContains the primary statement of responsibility given for a work on its title page.
contentItemContains a single entry within a content description element.
dedicationContains a dedicatory statement.
exhibHistA record of public exhibitions, including dates, venues, etc.
handDefines a distinct scribe or handwriting style.
languageDescription of a language used in the document.
perfResName of an instrument on which a performer plays, a performer's voice range, or a standard performing ensemble designation.
priceThe cost of access to a bibliographic item.
provenanceThe record of ownership or custodianship of an item.
soundChanReflects the number of apparent sound channels in the playback of a recording (monaural, stereophonic, quadraphonic, etc.).
treatHistA record of the treatment the item has undergone (e.g., de-acidification, restoration, etc.).
treatSchedScheduled treatment, e.g., de-acidification, restoration, etc., for an item.
Manuscript description component declarations.
bindingDescDescribes the present and former bindings of an item.
decoDescContains a description of the decoration of an item.
decoNoteContains a description of one or more decorative features of an item.
layoutDescCollects layout descriptions.
scriptDescContains a description of the letters or characters used in an autographic item.
sealA single seal or similar attachment.
sealDescDescribes the seals or similar external attachments applied to an item.
supportDescGroups elements describing the physical support material of an item.
typeDescContains a description of the typefaces or other aspects of the printing of a printed source.
Names and dates component declarations.
addNameContains an additional name component, such as a nickname, epithet, or alias, or any other descriptive phrase used within a personal name.
blocContains the name of a geopolitical unit consisting of two or more nation states or countries.
corpNameIdentifies an organization or group of people that acts as a single entity.
countryContains the name of a geopolitical unit, such as a nation, country, colony, or commonwealth, larger than or administratively superior to a region and smaller than a bloc.
districtContains the name of any kind of subdivision of a settlement, such as a parish, ward, or other administrative or geographic unit.
famNameContains a family (inherited) name, as opposed to a given, baptismal, or nick name.
foreNameContains a forename, given or baptismal name.
genNameContains a name component used to distinguish otherwise similar names on the basis of the relative ages or generations of the persons named.
geogFeatContains a common noun identifying a geographical feature.
geogNameThe proper noun designation for a place, natural feature, or political jurisdiction.
nameLinkContains a connecting phrase or link used within a name but not regarded as part of it, such as "van der" or "of", "from", etc.
periodNameA label that describes a period of time, such as 'Baroque' or '3rd Style period'.
persNameDesignation for an individual, including any or all of that individual's forenames, surnames, honorific titles, and added names.
regionContains the name of an administrative unit such as a state, province, or county, larger than a settlement, but smaller than a country.
roleNameContains a name component which indicates that the referent has a particular role or position in society, such as an official title or rank.
settlementContains the name of a settlement such as a city, town, or village identified as a single geopolitical or administrative unit.
streetfull street address including any name or number identifying a building as well as the name of the street or route on which it is located.
styleNameA label for a characteristic style of writing or performance, such as 'bebop' or 'rock-n-roll'.
Neume repertoire component declarations.
signifLetSignificantive letter(s).
Pointer and reference component declarations.
refDefines a traversible reference to another location. May contain text and sub-elements that describe the destination.
Component declarations that are shared between two or more modules.
actorName of an actor appearing within a cast list.
addrLineSingle line of a postal address.
annotProvides a statement explaining the text or indicating the basis for an assertion.
arrangerA person or organization who transcribes a musical composition, usually for a different medium from that of the original; in an arrangement the musical substance remains essentially unchanged.
authorThe name of the creator of the intellectual content of a non-musical, literary work.
biblProvides a loosely-structured bibliographic citation in which the sub-components may or may not be explicitly marked.
biblScopeDefines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work.
captionA label which accompanies an illustration or a table.
composerThe name of the creator of the intellectual content of a musical work.
contributorNames of individuals, institutions, or organizations responsible for contributions to the intellectual content of a work, where the specialized elements for authors, editors, etc. do not suffice or do not apply.
creationNon-bibliographic details of the creation of an intellectual entity, in narrative form, such as the date, place, and circumstances of its composition. More detailed information may be captured within the history element.
dateA string identifying a point in time or the time period between two such points.
dedicateeEntity to whom a creative work is formally offered.
depthDescription of a measurement taken through a three-dimensional object.
descContainer for text that briefly describes the feature to which it is attached, including its intended usage, purpose, or application as appropriate.
dimAny single dimensional specification.
dirAn instruction expressed as a combination of text and symbols, typically above, below, or between staves, but not on the staff — that is not encoded elsewhere in more specific elements, like tempo, dynam or repeatMark.
distributorPerson or agency, other than a publisher, from which access (including electronic access) to a bibliographic entity may be obtained.
dynamIndication of the volume of a note, phrase, or section of music.
editionA word or text phrase that indicates a difference in either content or form between the item being described and a related item previously issued by the same publisher/distributor (e.g., 2nd edition, version 2.0, etc.), or simultaneously issued by either the same publisher/distributor or another publisher/distributor (e.g., large print edition, British edition, etc.).
editorThe name of the individual(s), institution(s) or organization(s) acting in an editorial capacity.
extentUsed to express size in terms other than physical dimensions, such as number of pages, records, bytes, physical components, etc.
funderNames of individuals, institutions, or organizations responsible for funding. Funders provide financial support for a project; they are distinct from sponsors, who provide intellectual support and authority.
genreTerm or terms that designate a category characterizing a particular style, form, or content.
headContains any heading, for example, the title of a section of text, or the heading of a list.
heightDescription of the vertical size of an object.
identifierAn alpha-numeric string that establishes the identity of the described material.
imprintInformation relating to the publication or distribution of a bibliographic item.
labelA container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the label attribute.
labelAbbrA label on the pages following the first.
librettistPerson or organization who is a writer of the text of an opera, oratorio, etc.
lyricistPerson or organization who is a writer of the text of a song.
nameProper noun or noun phrase.
numNumeric information in any form.
ornamAn element indicating an ornament that is not a mordent, turn, or trill.
pOne or more text phrases that form a logical prose passage.
pgDescContains a brief prose description of the appearance or description of the content of a physical page.
pgFootA running footer.
pgHeadA running header.
pubPlaceName of the place where a bibliographic item was published.
publisherName of the organization responsible for the publication of a bibliographic item.
recipientThe name of the individual(s), institution(s) or organization(s) receiving correspondence.
rendA formatting element indicating special visual rendering, e.g., bold or italicized, of a text word or phrase.
repositoryInstitution, agency, or individual which holds a bibliographic item.
respA phrase describing the nature of intellectual responsibility.
roleName of a dramatic role, as given in a cast list.
roleDescDescribes a character’s role in a drama.
seriesContains information about the serial publication in which a bibliographic item has appeared.
speakerContains a specialized form of heading or label, giving the name of one or more speakers in a dramatic text or fragment.
sponsorNames of sponsoring individuals, organizations or institutions. Sponsors give their intellectual authority to a project; they are to be distinguished from funders, who provide the funding but do not necessarily take intellectual responsibility.
stackAn inline table with a single column.
sylIndividual lyric syllable.
tempoText and symbols descriptive of tempo, mood, or style, e.g., "allarg.", "a tempo", "cantabile", "Moderato", "♩=60", "Moderato ♩ =60").
termKeyword or phrase which describes a resource.
textLangIdentifies the languages and writing systems within the work described by a bibliographic description, not the language of the description.
widthDescription of the horizontal size of an object.
Text component declarations.
epigraphContains a quotation, anonymous or attributed, appearing on a title page.
imprimaturContains a formal statement authorizing the publication of a work, sometimes required to appear on a title page or its verso.
lContains a single line of text within a line group.
liSingle item in a list.
qContains material which is distinguished from the surrounding phrase-level text using quotation marks or a similar method. Use quote for block-level quotations.
quoteContains a paragraph-like block of text attributed to an external source, normally set off from the surrounding text by spacing or other typographic distinction.
segrepresents any segmentation of text below the "text component" level.
User-defined symbols component declarations.
anchoredTextContainer for text that is fixed to a particular page location, regardless of changes made to the layout of the measures around it.
lineA visual line that cannot be represented by a more specific; i.e., semantic, element.
May Contain
textual content
(MEI.shared) Groups textual elements that occur at the level of individual words or phrases.
(MEI.shared) Groups page beginning-like elements.
pbAn empty formatting element that forces text to begin on a new page.
(MEI.shared) Groups textual elements that occur at the level of individual words or phrases. This class is equivalent to the model.textPhraseLike class without the pb element.
dedicateeEntity to whom a creative work is formally offered.
dimensionsInformation about the physical size of an entity; usually includes numerical data.
extentUsed to express size in terms other than physical dimensions, such as number of pages, records, bytes, physical components, etc.
segrepresents any segmentation of text below the "text component" level.
symbolA reference to a previously defined symbol.
termKeyword or phrase which describes a resource.
(MEI.figtable) Groups elements representing or containing graphic information such as an illustration or figure.
figGroups elements representing or containing graphic information such as an illustration or figure.
(MEI.msDesc) Groups elements that may appear inline when the msdesc module is active.
catchwordsDescribes the system used to ensure correct ordering of the quires making up an item, typically by means of annotations at the foot of the page.
heraldryContains a heraldic formula or phrase, typically found as part of a blazon, coat of arms, etc.
locusDefines a location within a manuscript or manuscript component, usually as a (possibly discontinuous) sequence of folio references.
locusGrpGroups locations which together form a distinct but discontinuous item within a manuscript or manuscript part, according to a specific foliation.
secFolioMarks the word or words taken from a fixed point in a codex (typically the beginning of the second leaf) in order to provide a unique identifier for the item.
signaturesProvides a description of the leaf or quire signatures found within a codex.
stampContains a word or phrase describing an official mark indicating ownership, genuineness, validity, etc.
watermarkContains a description of a watermark or similar device.
(MEI.namesdates) Groups elements used as part of a physical address.
postBoxContains a number or other identifier for some postal delivery point other than a street address.
postCodeContains a numerical or alphanumeric code used as part of a postal address to simplify sorting or delivery of mail.
streetfull street address including any name or number identifying a building as well as the name of the street or route on which it is located.
(MEI.namesdates) Groups elements which form part of a geographic name.
blocContains the name of a geopolitical unit consisting of two or more nation states or countries.
countryContains the name of a geopolitical unit, such as a nation, country, colony, or commonwealth, larger than or administratively superior to a region and smaller than a bloc.
districtContains the name of any kind of subdivision of a settlement, such as a parish, ward, or other administrative or geographic unit.
geogFeatContains a common noun identifying a geographical feature.
regionContains the name of an administrative unit such as a state, province, or county, larger than a settlement, but smaller than a country.
settlementContains the name of a settlement such as a city, town, or village identified as a single geopolitical or administrative unit.
(MEI.namesdates) Groups elements that serve as stylistic labels.
periodNameA label that describes a period of time, such as 'Baroque' or '3rd Style period'.
styleNameA label for a characteristic style of writing or performance, such as 'bebop' or 'rock-n-roll'.
(MEI.ptrref) Groups elements used for purposes of location and reference.
ptrDefines a traversible pointer to another location, using only attributes to describe the destination.
refDefines a traversible reference to another location. May contain text and sub-elements that describe the destination.
(MEI.shared) Groups elements used to represent a postal address.
addressContains a postal address, for example of a publisher, an organization, or an individual.
(MEI.shared) Groups annotation-like elements.
annotProvides a statement explaining the text or indicating the basis for an assertion.
(MEI.shared) Groups elements containing a bibliographic description.
biblProvides a loosely-structured bibliographic citation in which the sub-components may or may not be explicitly marked.
biblStructContains a bibliographic citation in which bibliographic sub-elements must appear in a specified order.
(MEI.shared) Groups elements containing date expressions.
dateA string identifying a point in time or the time period between two such points.
(MEI.shared) Groups elements which describe a measurement forming part of the physical dimensions of an object.
depthDescription of a measurement taken through a three-dimensional object.
dimAny single dimensional specification.
heightDescription of the vertical size of an object.
widthDescription of the horizontal size of an object.
(MEI.shared) Groups editorial intervention elements.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
expanContains the expansion of an abbreviation.
(MEI.shared) Groups identifier-like elements.
identifierAn alpha-numeric string that establishes the identity of the described material.
(MEI.shared) Groups elements that function like line beginnings.
lbAn empty formatting element that forces text to begin on a new line.
(MEI.shared) Groups elements that represent a measurement.
(MEI.shared) Groups elements that denote a number or a quantity.
numNumeric information in any form.
(MEI.shared) Groups elements that contain names.
nameProper noun or noun phrase.
(MEI.namesdates) Groups elements which contain names of individuals or corporate bodies.
corpNameIdentifies an organization or group of people that acts as a single entity.
persNameDesignation for an individual, including any or all of that individual's forenames, surnames, honorific titles, and added names.
(MEI.namesdates) Groups place name elements.
(MEI.namesdates) Groups geographic name elements.
geogNameThe proper noun designation for a place, natural feature, or political jurisdiction.
(MEI.shared) Groups elements that denote a corporate entity that holds a bibliographic item.
repositoryInstitution, agency, or individual which holds a bibliographic item.
(MEI.shared) Collects elements that express a relationship.
relationDescribes a relationship or linkage amongst entities.
relationListGathers relation elements.
(MEI.shared) Groups elements that mark typographical features.
rendA formatting element indicating special visual rendering, e.g., bold or italicized, of a text word or phrase.
stackAn inline table with a single column.
(MEI.shared) Groups elements that denote the name of a bibliographic item.
titleTitle of a bibliographic entity.
(MEI.text) Groups elements related to highlighting which can appear at the phrase-level.
qContains material which is distinguished from the surrounding phrase-level text using quotation marks or a similar method. Use quote for block-level quotations.
textual content
Editorial and transcriptional component declarations.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
expanContains the expansion of an abbreviation.
Figures and tables component declarations.
figGroups elements representing or containing graphic information such as an illustration or figure.
Metadata header component declarations.
watermarkContains a description of a watermark or similar device.
Manuscript description component declarations.
catchwordsDescribes the system used to ensure correct ordering of the quires making up an item, typically by means of annotations at the foot of the page.
heraldryContains a heraldic formula or phrase, typically found as part of a blazon, coat of arms, etc.
locusDefines a location within a manuscript or manuscript component, usually as a (possibly discontinuous) sequence of folio references.
locusGrpGroups locations which together form a distinct but discontinuous item within a manuscript or manuscript part, according to a specific foliation.
secFolioMarks the word or words taken from a fixed point in a codex (typically the beginning of the second leaf) in order to provide a unique identifier for the item.
signaturesProvides a description of the leaf or quire signatures found within a codex.
stampContains a word or phrase describing an official mark indicating ownership, genuineness, validity, etc.
Names and dates component declarations.
blocContains the name of a geopolitical unit consisting of two or more nation states or countries.
corpNameIdentifies an organization or group of people that acts as a single entity.
countryContains the name of a geopolitical unit, such as a nation, country, colony, or commonwealth, larger than or administratively superior to a region and smaller than a bloc.
districtContains the name of any kind of subdivision of a settlement, such as a parish, ward, or other administrative or geographic unit.
geogFeatContains a common noun identifying a geographical feature.
geogNameThe proper noun designation for a place, natural feature, or political jurisdiction.
periodNameA label that describes a period of time, such as 'Baroque' or '3rd Style period'.
persNameDesignation for an individual, including any or all of that individual's forenames, surnames, honorific titles, and added names.
postBoxContains a number or other identifier for some postal delivery point other than a street address.
postCodeContains a numerical or alphanumeric code used as part of a postal address to simplify sorting or delivery of mail.
regionContains the name of an administrative unit such as a state, province, or county, larger than a settlement, but smaller than a country.
settlementContains the name of a settlement such as a city, town, or village identified as a single geopolitical or administrative unit.
streetfull street address including any name or number identifying a building as well as the name of the street or route on which it is located.
styleNameA label for a characteristic style of writing or performance, such as 'bebop' or 'rock-n-roll'.
Pointer and reference component declarations.
ptrDefines a traversible pointer to another location, using only attributes to describe the destination.
refDefines a traversible reference to another location. May contain text and sub-elements that describe the destination.
Component declarations that are shared between two or more modules.
addressContains a postal address, for example of a publisher, an organization, or an individual.
annotProvides a statement explaining the text or indicating the basis for an assertion.
biblProvides a loosely-structured bibliographic citation in which the sub-components may or may not be explicitly marked.
biblStructContains a bibliographic citation in which bibliographic sub-elements must appear in a specified order.
dateA string identifying a point in time or the time period between two such points.
dedicateeEntity to whom a creative work is formally offered.
depthDescription of a measurement taken through a three-dimensional object.
dimAny single dimensional specification.
dimensionsInformation about the physical size of an entity; usually includes numerical data.
extentUsed to express size in terms other than physical dimensions, such as number of pages, records, bytes, physical components, etc.
heightDescription of the vertical size of an object.
identifierAn alpha-numeric string that establishes the identity of the described material.
lbAn empty formatting element that forces text to begin on a new line.
nameProper noun or noun phrase.
numNumeric information in any form.
pbAn empty formatting element that forces text to begin on a new page.
relationDescribes a relationship or linkage amongst entities.
relationListGathers relation elements.
rendA formatting element indicating special visual rendering, e.g., bold or italicized, of a text word or phrase.
repositoryInstitution, agency, or individual which holds a bibliographic item.
stackAn inline table with a single column.
symbolA reference to a previously defined symbol.
termKeyword or phrase which describes a resource.
titleTitle of a bibliographic entity.
widthDescription of the horizontal size of an object.
Text component declarations.
qContains material which is distinguished from the surrounding phrase-level text using quotation marks or a similar method. Use quote for block-level quotations.
segrepresents any segmentation of text below the "text component" level.
Remarks

Unlike the ptr element, ref may contain text and sub-elements to describe the destination.

The model of this element is based on the ref element of the Encoded Archival Description (EAD) and the ref element of the Text Encoding Initiative (TEI).

Declaration
<elementSpec ident="ref" module="MEI.ptrref">
<gloss versionDate="2022-05-18" xml:lang="en">reference</gloss>
<desc xml:lang="en">Defines a traversible reference to another location. May contain text and sub-elements that describe the destination.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.internetMedia"/>
<memberOf key="att.lang"/>
<memberOf key="att.metadataPointing"/>
<memberOf key="att.pointing"/>
<memberOf key="att.targetEval"/>
<memberOf key="model.locrefLike"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:choice>
<rng:text/>
<rng:ref name="model.textPhraseLike"/>
</rng:choice>
</rng:zeroOrMore>
</content>
<remarks xml:lang="en">
<p>Unlike the <gi scheme="MEI">ptr</gi> element, <gi scheme="MEI">ref</gi> may contain text and sub-elements to describe the destination.</p>
</remarks>
<remarks xml:lang="en">
<p>The model of this element is based on the <ref target="https://www.loc.gov/ead/EAD3taglib/EAD3-TL-eng.html#elem-ref">ref</ref> element of the Encoded Archival Description (EAD) and the <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/ref-ref.html">ref</ref> element of the Text Encoding Initiative (TEI).</p>
</remarks>
</elementSpec>
MEI Version: 5.0(#eb14650)