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-dataRef.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 element dataRef </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI element dataRef " /><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-ELEMENTS.html">C Elements</a></li></ul></div><div><h3 class="oddSpec" id="dataRef"><dataRef></h3><table class="wovenodd"><tr><td colspan="2" class="wovenodd-col2"><span class="label"><dataRef> </span>identifies the datatype of an attribute value, either by referencing an item in an externally defined datatype library, or by pointing to a TEI-defined data specification [<a class="link_ptr" href="TD.html#TD-datatypes" title="Datatypes"><span class="headingNumber">22.5.4.1 </span>Datatypes</a>]</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Module</span></td><td class="wovenodd-col2">tagdocs — Documentation Elements</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Attributes</span></td><td class="wovenodd-col2"><a class="link_odd" title="provides attributes common to all elements in the TEI encoding scheme." href="ref-att.global.html">att.global</a> (<span class="attribute">@xml:id</span>, <span class="attribute">@n</span>, <span class="attribute">@xml:lang</span>, <span class="attribute">@xml:base</span>, <span class="attribute">@xml:space</span>) (<a class="link_odd" title="provides rendering attributes common to all elements in the TEI encoding scheme." href="ref-att.global.rendition.html">att.global.rendition</a> (<span class="attribute">@rend</span>, <span class="attribute">@style</span>, <span class="attribute">@rendition</span>)) (<a class="link_odd" title="provides a set of attributes for hypertextual linking." href="ref-att.global.linking.html">att.global.linking</a> (<span class="attribute">@corresp</span>, <span class="attribute">@synch</span>, <span class="attribute">@sameAs</span>, <span class="attribute">@copyOf</span>, <span class="attribute">@next</span>, <span class="attribute">@prev</span>, <span class="attribute">@exclude</span>, <span class="attribute">@select</span>)) (<a class="link_odd" title="provides additional global attributes for associating specific analyses or interpretations with appropriate portions of a text." href="ref-att.global.analytic.html">att.global.analytic</a> (<span class="attribute">@ana</span>)) (<a class="link_odd" title="provides an attribute used to express correspondence between an element containing transcribed text and all or part of an image representing that text." href="ref-att.global.facs.html">att.global.facs</a> (<span class="attribute">@facs</span>)) (<a class="link_odd" title="supplies the @change attribute, allowing its member elements to specify one or more states or revision campaigns with which they are associated." href="ref-att.global.change.html">att.global.change</a> (<span class="attribute">@change</span>)) (<a class="link_odd" title="provides attributes indicating the agent responsible for some aspect of the text, the markup or something asserted by the markup, and the degree of certainty associated with it." href="ref-att.global.responsibility.html">att.global.responsibility</a> (<span class="attribute">@cert</span>, <span class="attribute">@resp</span>)) (<a class="link_odd" title="provides an attribute used by elements to point to an external source." href="ref-att.global.source.html">att.global.source</a> (<span class="attribute">@source</span>)) <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">the identifier used for this datatype specification<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.xmlName.html">teidata.xmlName</a></td></tr></table></td></tr><tr><td class="odd_label">name<span class="bookmarklink"><a class="bookmarklink" id="tei_att.name" href="#tei_att.name" title="link to this attribute "><span class="invisible"> name</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">the name of a datatype in the list provided by <a class="link_ref" href="BIB.html#XSD2" title="Paul V. Biron Ashok Malhotra XML Schema Part 2 Datatypes Second EditionW3C28 October 2004">XML Schemas: Part 2: Datatypes</a><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.xmlName.html">teidata.xmlName</a></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">a pointer to a datatype defined in some datatype library<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.pointer.html">teidata.pointer</a></td></tr></table></td></tr><tr><td class="odd_label">restriction<span class="bookmarklink"><a class="bookmarklink" id="tei_att.restriction" href="#tei_att.restriction" title="link to this attribute "><span class="invisible"> restriction</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">supplies a string representing a regular expression providing additional constraints on the strings used to represent values of this datatype<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.pattern.html">teidata.pattern</a></td></tr></table></td></tr></table></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Member of</span></td><td class="wovenodd-col2"><div class="parent"><a class="link_odd_classSpec" title="groups elements which may appear as part of the content element." href="ref-model.contentPart.html">model.contentPart</a> <a class="link_odd_classSpec" title="groups elements which reference declarations in some markup language in ODD documents." href="ref-model.oddRef.html">model.oddRef</a></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Contained by</span></td><td class="wovenodd-col2"><div class="parent"><div class="specChildren"><div class="specChild"><span class="specChildModule">tagdocs: </span><span class="specChildElements"><a class="link_odd_elementSpec" title="an alternation of references" href="ref-alternate.html">alternate</a> <a class="link_odd_elementSpec" title="(content model) contains the text of a declaration for the schema documented." href="ref-content.html">content</a> <a class="link_odd_elementSpec" title="specifies the declared value for an attribute, by referring to any datatype defined by the chosen schema language." href="ref-datatype.html">datatype</a> <a class="link_odd_elementSpec" title="(schema specification) generates a TEI-conformant schema and documentation for it." href="ref-schemaSpec.html">schemaSpec</a> <a class="link_odd_elementSpec" title="sequence of references" href="ref-sequence.html">sequence</a> <a class="link_odd_elementSpec" title="(specification group) contains any convenient grouping of specifications for use within the current module." href="ref-specGrp.html">specGrp</a></span></div></div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">May contain</span></td><td class="wovenodd-col2"><div class="specChildren"><div class="specChild"><span class="specChildModule">tagdocs: </span><span class="specChildElements"><a class="link_odd_elementSpec" title="Restricts the value of the strings used to represent values of a datatype, according to XML Schemas: Part 2: Datatypes." href="ref-dataFacet.html">dataFacet</a></span></div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>Only one of the attributes <span class="att">key</span>, <span class="att">name</span>, and <span class="att">ref</span> may be used.</p></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p><a class="gi" title="Restricts the value of the strings used to represent values of a datatype, according to XML Schemas: Part 2: Datatypes." href="ref-dataFacet.html">dataFacet</a> children are only allowed when <a class="gi" title="identifies the datatype of an attribute value, either by referencing an item in an externally defined datatype library, or by pointing to a TEI-defined data specification" href="ref-dataRef.html">dataRef</a>refers with <span class="att">name</span> to a datatype from the specification <a class="link_ref" href="BIB.html#XSD2" title="Paul V. Biron Ashok Malhotra XML Schema Part 2 Datatypes Second EditionW3C28 October 2004">XML Schemas: Part 2: Datatypes</a>.</p></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Example</span></td><td class="wovenodd-col2"><div id="index-egXML-d52e148653" class="pre egXML_valid"><span class="element"><schemaSpec <span class="attribute">ident</span>="<span class="attributevalue">myTEI</span>"<br /> <span class="attribute">source</span>="<span class="attributevalue">http://www.tei-c.org/Vault/P5/current/xml/tei/odd/p5subset.xml</span>"></span><br /><span class="comment"><!-- ... --></span><br /> <span class="element"><dataRef <span class="attribute">key</span>="<span class="attributevalue">teidata.enumerated</span>"/></span><br /><span class="comment"><!-- ... --></span><br /><span class="element"></schemaSpec></span><div style="float: right;"><a href="examples-dataRef.html">Show all</a> </div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Example</span></td><td class="wovenodd-col2"><div id="index-egXML-d52e148659" class="pre egXML_valid"><span class="element"><schemaSpec <span class="attribute">ident</span>="<span class="attributevalue">myTEI</span>"<br /> <span class="attribute">source</span>="<span class="attributevalue">http://www.tei-c.org/Vault/P5/current/xml/tei/odd/p5subset.xml</span>"></span><br /><span class="comment"><!-- ... --></span><br /> <span class="element"><dataRef <span class="attribute">name</span>="<span class="attributevalue">float</span>"/></span><br /><span class="comment"><!-- ... --></span><br /><span class="element"></schemaSpec></span><div style="float: right;"><a href="examples-dataRef.html">Show all</a> </div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Example</span></td><td class="wovenodd-col2"><div id="index-egXML-d52e148665" class="pre egXML_valid"><span class="element"><dataSpec <span class="attribute">ident</span>="<span class="attributevalue">data.percentage</span>"></span><br /> <span class="element"><desc></span>datatype used for attributes taking an integer value between 0 and 99<span class="element"></desc></span><br /> <span class="element"><content></span><br /> <span class="element"><dataRef <span class="attribute">name</span>="<span class="attributevalue">nonNegativeInteger</span>"<br /> <span class="attribute">restriction</span>="<span class="attributevalue">[0-9][0-9]?</span>"/></span><br /> <span class="element"></content></span><br /><span class="element"></dataSpec></span><div style="float: right;"><a href="examples-dataRef.html">Show all</a> </div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Schematron</span></td><td class="wovenodd-col2"><div xml:space="preserve" class="pre"><br /><span class="element"><sch:rule <span class="attribute">context</span>="<span class="attributevalue">tei:dataRef[tei:dataFacet]</span>"></span><br /><span class="element"><sch:assert <span class="attribute">test</span>="<span class="attributevalue">@name</span>" <span class="attribute">role</span>="<span class="attributevalue">nonfatal</span>"></span>Data facets can only be specified for references to datatypes specified by<br /> XML Schemas: Part 2: Datatypes<span class="element"></sch:assert></span><br /><span class="element"></sch:rule></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Schematron</span></td><td class="wovenodd-col2"><div xml:space="preserve" class="pre"><br /><span class="element"><sch:rule <span class="attribute">context</span>="<span class="attributevalue">tei:dataRef[tei:dataFacet]</span>"></span><br /><span class="element"><sch:report <span class="attribute">test</span>="<span class="attributevalue">@restriction</span>"<br /> <span class="attribute">role</span>="<span class="attributevalue">nonfatal</span>"></span>The attribute restriction cannot be used when dataFacet elements are present.<span class="element"></sch:report></span><br /><span class="element"></sch:rule></span></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Content model</span></td><td class="wovenodd-col2"><pre class="eg"><span class="element"><content></span><br /> <span class="element"><elementRef <span class="attribute">minOccurs</span>="<span class="attributevalue">0</span>"<br /> <span class="attribute">maxOccurs</span>="<span class="attributevalue">unbounded</span>" <span class="attribute">key</span>="<span class="attributevalue">dataFacet</span>"/></span><br /><span class="element"></content></span></pre></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Schema Declaration</span></td><td class="wovenodd-col2"><div class="displayRelax"><button class="displayRelaxButton"><span class="RNG_Compact">XML syntax</span><span class="RNG_XML">Compact syntax</span></button><pre class="RNG_XML"><span class="element"><rng:element <span class="attribute">name</span>="<span class="attributevalue">dataRef</span>"></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.attributes</span>"/></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.rendition.attributes</span>"/></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.linking.attributes</span>"/></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.analytic.attributes</span>"/></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.facs.attributes</span>"/></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.change.attributes</span>"/></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.responsibility.attributes</span>"/></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.source.attributes</span>"/></span><br /> <span class="element"><rng:choice></span><br /> <span class="element"><rng:optional></span><br /> <span class="element"><rng:attribute <span class="attribute">name</span>="<span class="attributevalue">key</span>"></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.xmlName</span>"/></span><br /> <span class="element"></rng:attribute></span><br /> <span class="element"></rng:optional></span><br /> <span class="element"><rng:optional></span><br /> <span class="element"><rng:attribute <span class="attribute">name</span>="<span class="attributevalue">name</span>"></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.xmlName</span>"/></span><br /> <span class="element"></rng:attribute></span><br /> <span class="element"></rng:optional></span><br /> <span class="element"><rng:optional></span><br /> <span class="element"><rng:attribute <span class="attribute">name</span>="<span class="attributevalue">ref</span>"></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.pointer</span>"/></span><br /> <span class="element"></rng:attribute></span><br /> <span class="element"></rng:optional></span><br /> <span class="element"></rng:choice></span><br /> <span class="element"><rng:optional></span><br /> <span class="element"><rng:attribute <span class="attribute">name</span>="<span class="attributevalue">restriction</span>"></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.pattern</span>"/></span><br /> <span class="element"></rng:attribute></span><br /> <span class="element"></rng:optional></span><br /> <span class="element"><rng:zeroOrMore></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">dataFacet</span>"/></span><br /> <span class="element"></rng:zeroOrMore></span><br /><span class="element"></rng:element></span></pre><pre class="RNG_Compact">
<span class="rnc_keyword">element</span> <span class="rnc_nc">dataRef</span>
{
<a class="link_odd" title="provides attributes common to all elements in the TEI encoding scheme." href="ref-att.global.html">att.global.attributes</a>,
<a class="link_odd" title="provides rendering attributes common to all elements in the TEI encoding scheme." href="ref-att.global.rendition.html">att.global.rendition.attributes</a>,
<a class="link_odd" title="provides a set of attributes for hypertextual linking." href="ref-att.global.linking.html">att.global.linking.attributes</a>,
<a class="link_odd" title="provides additional global attributes for associating specific analyses or interpretations with appropriate portions of a text." href="ref-att.global.analytic.html">att.global.analytic.attributes</a>,
<a class="link_odd" title="provides an attribute used to express correspondence between an element containing transcribed text and all or part of an image representing that text." href="ref-att.global.facs.html">att.global.facs.attributes</a>,
<a class="link_odd" title="supplies the @change attribute, allowing its member elements to specify one or more states or revision campaigns with which they are associated." href="ref-att.global.change.html">att.global.change.attributes</a>,
<a class="link_odd" title="provides attributes indicating the agent responsible for some aspect of the text, the markup or something asserted by the markup, and the degree of certainty associated with it." href="ref-att.global.responsibility.html">att.global.responsibility.attributes</a>,
<a class="link_odd" title="provides an attribute used by elements to point to an external source." href="ref-att.global.source.html">att.global.source.attributes</a>,
(
attribute key { <a class="link_odd" title="" href="ref-teidata.xmlName.html">teidata.xmlName</a> }?
| attribute name { <a class="link_odd" title="" href="ref-teidata.xmlName.html">teidata.xmlName</a> }?
| attribute ref { <a class="link_odd" title="" href="ref-teidata.pointer.html">teidata.pointer</a> }?
),
attribute restriction { <a class="link_odd" title="" href="ref-teidata.pattern.html">teidata.pattern</a> }?,
<a class="link_odd" title="Restricts the value of the strings used to represent values of a datatype, according to XML Schemas: Part 2: Datatypes." href="ref-dataFacet.html">dataFacet</a>*
}</pre></div></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
[<a href="../../en/html/ref-dataRef.html">English</a>]
[<a href="../../de/html/ref-dataRef.html">Deutsch</a>]
[<a href="../../es/html/ref-dataRef.html">Español</a>]
[<a href="../../it/html/ref-dataRef.html">Italiano</a>]
[<a href="../../fr/html/ref-dataRef.html">Français</a>]
[<a href="../../ja/html/ref-dataRef.html">日本語</a>]
[<a href="../../ko/html/ref-dataRef.html">한국어</a>]
[<a href="../../zh-TW/html/ref-dataRef.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>