https://github.com/TEIC/TEI
Tip revision: 347c64fac3fa1a64ade0d8d1842813d4b8f7acec authored by Hugh Cayless on 12 May 2017, 16:57:59 UTC
Updates.
Updates.
Tip revision: 347c64f
ref-att.canonical.html
<!DOCTYPE html
SYSTEM "about:legacy-compat">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><!--THIS FILE IS GENERATED FROM AN XML MASTER. DO NOT EDIT (7)--><title>TEI class att.canonical </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI class att.canonical " /><meta property="DC.Language" content="SCHEME=iso639 en" /><meta property="DC.Creator.Address" content="tei@oucs.ox.ac.uk" /><meta charset="utf-8" /><link href="guidelines.css" rel="stylesheet" type="text/css" /><link href="odd.css" rel="stylesheet" type="text/css" /><link rel="stylesheet" media="print" type="text/css" href="guidelines-print.css" /><script type="text/javascript" src="jquery-1.2.6.min.js"></script><script type="text/javascript" src="columnlist.js"></script><script type="text/javascript" src="popupFootnotes.js"></script><script type="text/javascript">
$(function() {
$('ul.attrefs-class').columnizeList({cols:3,width:30,unit:'%'});
$('ul.attrefs-element').columnizeList({cols:3,width:30,unit:'%'});
$(".displayRelaxButton").click(function() {
$(this).parent().find('.RNG_XML').toggle();
$(this).parent().find('.RNG_Compact').toggle();
});
$(".tocTree .showhide").click(function() {
$(this).find(".tocShow,.tocHide").toggle();
$(this).parent().find("ul.continuedtoc").toggle();
});
})
</script><script type="text/javascript"><!--
var displayXML=0;
states=new Array()
states[0]="element-a"
states[1]="element-b"
states[2]="element-c"
states[3]="element-d"
states[4]="element-e"
states[5]="element-f"
states[6]="element-g"
states[7]="element-h"
states[8]="element-i"
states[9]="element-j"
states[10]="element-k"
states[11]="element-l"
states[12]="element-m"
states[13]="element-n"
states[14]="element-o"
states[15]="element-p"
states[16]="element-q"
states[17]="element-r"
states[18]="element-s"
states[19]="element-t"
states[20]="element-u"
states[21]="element-v"
states[22]="element-w"
states[23]="element-x"
states[24]="element-y"
states[25]="element-z"
function startUp() {
}
function hideallExcept(elm) {
for (var i = 0; i < states.length; i++) {
var layer;
if (layer = document.getElementById(states[i]) ) {
if (states[i] != elm) {
layer.style.display = "none";
}
else {
layer.style.display = "block";
}
}
}
var mod;
if ( mod = document.getElementById('byMod') ) {
mod.style.display = "none";
}
}
function showall() {
for (var i = 0; i < states.length; i++) {
var layer;
if (layer = document.getElementById(states[i]) ) {
layer.style.display = "block";
}
}
}
function showByMod() {
hideallExcept('');
var mod;
if (mod = document.getElementById('byMod') ) {
mod.style.display = "block";
}
}
--></script></head><body id="TOP"><div id="container"><div id="banner"><img src="Images/banner.jpg" alt="Text Encoding Initiative logo and banner" /></div></div><div class="mainhead"><h1>P5:
Guidelines for Electronic Text Encoding and Interchange</h1><p>Version 3.1.1a. Last updated on
10th May 2017, revision bd8dda3</p></div><div class="main-content"><div class="miniTOC miniTOC_right"><ul class="subtoc"><li class="subtoc"></li><li class="subtoc"></li><li class="subtoc"><a class="navigation" href="index.html">Home</a></li><li class="subtoc"><a class="navigation" href="REF-CLASSES-ATTS.html">B Attribute Classes</a></li></ul></div><div><h3 class="oddSpec" id="att.canonical">att.canonical</h3><table class="wovenodd"><tr><td colspan="2" class="wovenodd-col2"><span class="label">att.canonical</span> provides attributes which can be used to associate a representation such as a name or title with canonical information about the object being named or referenced. [<a class="link_ptr" href="ND.html#NDATTSnr" title="Linking Names and Their Referents"><span class="headingNumber">13.1.1 </span>Linking Names and Their Referents</a>]</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Module</span></td><td class="wovenodd-col2">tei — The TEI Infrastructure</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Members</span></td><td class="wovenodd-col2"><span class="showmembers1"><a class="link_odd_classSpec" title="provides attributes common to elements which refer to named persons, places, organizations etc." href="ref-att.naming.html">att.naming</a><span class="showmembers2"> [<a class="link_odd_classSpec" title="(attributes for components of names usually, but not necessarily, personal names) common attributes for those elements which form part of a name usually, but not necessarily, a personal name." href="ref-att.personal.html">att.personal</a><span class="showmembers3"> [<a class="link_odd_elementSpec" title="(additional name) contains an additional name component, such as a nickname, epithet, or alias, or any other descriptive phrase used within a personal name." href="ref-addName.html">addName</a> <a class="link_odd_elementSpec" title="contains a forename, given or baptismal name." href="ref-forename.html">forename</a> <a class="link_odd_elementSpec" title="(generational name component) contains a name component used to distinguish otherwise similar names on the basis of the relative ages or generations of the persons named." href="ref-genName.html">genName</a> <a class="link_odd_elementSpec" title="(name, proper noun) contains a proper noun or noun phrase." href="ref-name.html">name</a> <a class="link_odd_elementSpec" title="(organization name) contains an organizational name." href="ref-orgName.html">orgName</a> <a class="link_odd_elementSpec" title="(personal name) contains a proper noun or proper-noun phrase referring to a person, possibly including one or more of the person's forenames, surnames, honorifics, added names, etc." href="ref-persName.html">persName</a> <a class="link_odd_elementSpec" title="contains an absolute or relative place name." href="ref-placeName.html">placeName</a> <a class="link_odd_elementSpec" title="contains a name component which indicates that the referent has a particular role or position in society, such as an official title or rank." href="ref-roleName.html">roleName</a> <a class="link_odd_elementSpec" title="contains a family (inherited) name, as opposed to a given, baptismal, or nick name." href="ref-surname.html">surname</a>] </span> <a class="link_odd_elementSpec" title="contains an informal description of a person's present or past affiliation with some organization, for example an employer or sponsor." href="ref-affiliation.html">affiliation</a> <a class="link_odd_elementSpec" title="in a bibliographic reference, contains the name(s) of an author, personal or corporate, of a work; for example in the same form as that provided by a recognized bibliographic name authority." href="ref-author.html">author</a> <a class="link_odd_elementSpec" title="contains information about a person's birth, such as its date and place." href="ref-birth.html">birth</a> <a class="link_odd_elementSpec" title="contains the name of a geo-political unit consisting of two or more nation states or countries." href="ref-bloc.html">bloc</a> <a class="link_odd_elementSpec" title="contains information about the physical climate of a place." href="ref-climate.html">climate</a> <a class="link_odd_elementSpec" title="contains the name of a collection of manuscripts, not necessarily located within a single repository." href="ref-collection.html">collection</a> <a class="link_odd_elementSpec" title="contains the name of a geo-political unit, such as a nation, country, colony, or commonwealth, larger than or administratively superior to a region and smaller than a bloc." href="ref-country.html">country</a> <a class="link_odd_elementSpec" title="contains information about a person's death, such as its date and place." href="ref-death.html">death</a> <a class="link_odd_elementSpec" title="contains the name of any kind of subdivision of a settlement, such as a parish, ward, or other administrative or geographic unit." href="ref-district.html">district</a> <a class="link_odd_elementSpec" title="contains a secondary statement of responsibility for a bibliographic item, for example the name of an individual, institution or organization, (or of several such) acting as editor, compiler, translator, etc." href="ref-editor.html">editor</a> <a class="link_odd_elementSpec" title="contains a description of the educational experience of a person." href="ref-education.html">education</a> <a class="link_odd_elementSpec" title="contains data relating to any kind of significant event associated with a person, place, or organization." href="ref-event.html">event</a> <a class="link_odd_elementSpec" title="(geographical feature name) contains a common noun identifying some geographical feature contained within a geographic name, such as valley, mount, etc." href="ref-geogFeat.html">geogFeat</a> <a class="link_odd_elementSpec" title="(geographical name) identifies a name associated with some geographical feature such as Windrush Valley or Mount Sinai." href="ref-geogName.html">geogName</a> <a class="link_odd_elementSpec" title="contains the name of an organization such as a university or library, with which a manuscript is identified, generally its holding institution." href="ref-institution.html">institution</a> <a class="link_odd_elementSpec" title="contains an informal description of a person's present or past nationality or citizenship." href="ref-nationality.html">nationality</a> <a class="link_odd_elementSpec" title="contains an informal description of a person's trade, profession or occupation." href="ref-occupation.html">occupation</a> <a class="link_odd_elementSpec" title="marks that part of a relative temporal or spatial expression which indicates the direction of the offset between the two place names, dates, or times involved in the expression." href="ref-offset.html">offset</a> <a class="link_odd_elementSpec" title="(origin place) contains any form of place name, used to identify the place of origin for a manuscript or manuscript part." href="ref-origPlace.html">origPlace</a> <a class="link_odd_elementSpec" title="contains information about the population of a place." href="ref-population.html">population</a> <a class="link_odd_elementSpec" title="(publication place) contains the name of the place where a bibliographic item was published." href="ref-pubPlace.html">pubPlace</a> <a class="link_odd_elementSpec" title="contains the name of an administrative unit such as a state, province, or county, larger than a settlement, but smaller than a country." href="ref-region.html">region</a> <a class="link_odd_elementSpec" title="contains the name of a repository within which manuscripts are stored, possibly forming part of an institution." href="ref-repository.html">repository</a> <a class="link_odd_elementSpec" title="describes a person's present or past places of residence." href="ref-residence.html">residence</a> <a class="link_odd_elementSpec" title="(referencing string) contains a general purpose name or referring string." href="ref-rs.html">rs</a> <a class="link_odd_elementSpec" title="contains the name of a settlement such as a city, town, or village identified as a single geo-political or administrative unit." href="ref-settlement.html">settlement</a> <a class="link_odd_elementSpec" title="(socio-economic status) contains an informal description of a person's perceived social or economic status." href="ref-socecStatus.html">socecStatus</a> <a class="link_odd_elementSpec" title="contains a description of some status or quality attributed to a person, place, or organization often at some specific time or for a specific date range." href="ref-state.html">state</a> <a class="link_odd_elementSpec" title="contains information about the physical terrain of a place." href="ref-terrain.html">terrain</a> <a class="link_odd_elementSpec" title="contains a description of some status or quality attributed to a person, place, or organization typically, but not necessarily, independent of the volition or action of the holder and usually not at some specific time or for a specific date range." href="ref-trait.html">trait</a>] </span> <a class="link_odd_elementSpec" title="contains the name of an actor appearing within a cast list." href="ref-actor.html">actor</a> <a class="link_odd_elementSpec" title="(correspondence description) contains a description of the actions related to one act of correspondence." href="ref-correspDesc.html">correspDesc</a> <a class="link_odd_elementSpec" title="(document author) contains the name of the author of the document, as given on the title page (often but not always contained in a byline)." href="ref-docAuthor.html">docAuthor</a> <a class="link_odd_elementSpec" title="(document title) contains the title of a document, including all its constituents, as given on a title page." href="ref-docTitle.html">docTitle</a> <a class="link_odd_elementSpec" title="specifies the faith, religion, or belief set of a person." href="ref-faith.html">faith</a> <a class="link_odd_elementSpec" title="(funding body) specifies the name of an individual, institution, or organization responsible for the funding of a project or text." href="ref-funder.html">funder</a> <a class="link_odd_elementSpec" title="contains a word or phrase describing the material of which the object being described is composed." href="ref-material.html">material</a> <a class="link_odd_elementSpec" title="contains the formalized descriptive title for a meeting or conference, for use in a bibliographic description for an item derived from such a meeting, or as a heading or preamble to publications emanating from it." href="ref-meeting.html">meeting</a> <a class="link_odd_elementSpec" title="contains a word or phrase describing the type of object being referred to." href="ref-objectType.html">objectType</a> <a class="link_odd_elementSpec" title="(principal researcher) supplies the name of the principal researcher responsible for the creation of an electronic text." href="ref-principal.html">principal</a> <a class="link_odd_elementSpec" title="(relationship) describes any kind of relationship or linkage amongst a specified group of places, events, persons, objects or other items." href="ref-relation.html">relation</a> <a class="link_odd_elementSpec" title="(responsibility) contains a phrase describing the nature of a person's intellectual responsibility, or an organization's role in the production or distribution of a work." href="ref-resp.html">resp</a> <a class="link_odd_elementSpec" title="(statement of responsibility) supplies a statement of responsibility for the intellectual content of a text, edition, recording, or series, where the specialized elements for authors, editors, etc. do not suffice or do not apply. May also be used to encode information about individuals or organizations which have played a role in the production or distribution of a bibliographic work." href="ref-respStmt.html">respStmt</a> <a class="link_odd_elementSpec" title="specifies the name of a sponsoring organization or institution." href="ref-sponsor.html">sponsor</a> <a class="link_odd_elementSpec" title="contains a single-word, multi-word, or symbolic designation which is regarded as a technical term." href="ref-term.html">term</a> <a class="link_odd_elementSpec" title="contains a title for any kind of work." href="ref-title.html">title</a></span></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Attributes</span></td><td class="wovenodd-col2">Attributes<table class="attList"><tr><td class="odd_label">key<span class="bookmarklink"><a class="bookmarklink" id="tei_att.key" href="#tei_att.key" title="link to this attribute "><span class="invisible"> key</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">provides an externally-defined means of identifying the entity (or entities) being named, using a coded value of some kind.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en">Optional</span></td></tr><tr><td class="odd_label"><span lang="en" class="label">Datatype</span> </td><td class="odd_value"><a class="link_element" href="ref-teidata.text.html">teidata.text</a></td></tr><tr><td colspan="2"><div id="index-egXML-d52e4829" class="pre egXML_valid"><span class="element"><author></span><br /> <span class="element"><name <span class="attribute">key</span>="<span class="attributevalue">name 427308</span>"<br /> <span class="attribute">type</span>="<span class="attributevalue">organisation</span>"></span>[New Zealand Parliament, Legislative Council]<span class="element"></name></span><br /><span class="element"></author></span></div></td></tr><tr><td colspan="2"><div id="index-egXML-d52e4834" class="pre egXML_valid"><span class="element"><author></span><br /> <span class="element"><name <span class="attribute">key</span>="<span class="attributevalue">Hugo, Victor (1802-1885)</span>"<br /> <span class="attribute">ref</span>="<span class="attributevalue">http://www.idref.fr/026927608</span>"></span>Victor Hugo<span class="element"></name></span><br /><span class="element"></author></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>The value may be a unique identifier from a database, or any other externally-defined string identifying the referent. </p><p>No particular syntax is proposed for the values of the <span class="att">key</span> attribute, since its form will depend entirely on practice within a given project. For the same reason, this attribute is not recommended in data interchange, since there is no way of ensuring that the values used by one project are distinct from those used by another. In such a situation, a preferable approach for magic tokens which follows standard practice on the Web is to use a <span class="att">ref</span> attribute whose value is a tag URI as defined in <a class="link_ref" href="BIB.html#RFC4151" title="T. Kindberg S. Hawke The tag URI SchemeRFC 41512005IETF">RFC 4151</a>.</p></td></tr></table></td></tr><tr><td class="odd_label">ref<span class="bookmarklink"><a class="bookmarklink" id="tei_att.ref" href="#tei_att.ref" title="link to this attribute "><span class="invisible"> ref</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">(reference) provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en">Optional</span></td></tr><tr><td class="odd_label"><span lang="en" class="label">Datatype</span> </td><td class="odd_value"> 1–∞ <span lang="en">occurrences of</span> <a class="link_element" href="ref-teidata.pointer.html">teidata.pointer</a> <span lang="en">separated by whitespace</span></td></tr><tr><td colspan="2"><div id="index-egXML-d52e4867" class="pre egXML_valid"><span class="element"><name <span class="attribute">ref</span>="<span class="attributevalue">http://viaf.org/viaf/109557338</span>"<br /> <span class="attribute">type</span>="<span class="attributevalue">person</span>"></span>Seamus Heaney<span class="element"></name></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>The value must point directly to one or more XML elements or other resources by means of one or more URIs, separated by whitespace. If more than one is supplied the implication is that the name identifies several distinct entities.</p></td></tr></table></td></tr></table></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
[<a href="../../en/html/ref-att.canonical.html">English</a>]
[<a href="../../de/html/ref-att.canonical.html">Deutsch</a>]
[<a href="../../es/html/ref-att.canonical.html">Español</a>]
[<a href="../../it/html/ref-att.canonical.html">Italiano</a>]
[<a href="../../fr/html/ref-att.canonical.html">Français</a>]
[<a href="../../ja/html/ref-att.canonical.html">日本語</a>]
[<a href="../../ko/html/ref-att.canonical.html">한국어</a>]
[<a href="../../zh-TW/html/ref-att.canonical.html">中文</a>]
</p><hr /><div class="footer"><a class="plain" href="http://www.tei-c.org/About/">TEI Consortium</a> | <a class="plain" href="http://www.tei-c.org/About/contact.xml">Feedback</a></div><hr /><address><br />TEI Guidelines <a class="link_ref" href="AB.html#ABTEI4">Version</a> <a class="link_ref" href="../../readme-3.1.1.html">3.1.1a</a>. Last updated on <span class="date">10th May 2017</span>, revision <a class="link_ref" href="https://github.com/TEIC/TEI/commit/bd8dda3">bd8dda3</a>. This page generated on 2017-05-12T12:30:09Z.</address></div></body></html>