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-when.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 when </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI element when " /><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="when"><when></h3><table class="wovenodd"><tr><td colspan="2" class="wovenodd-col2"><span class="label"><when> </span>indicates a point in time either relative to other elements in the same timeline tag, or absolutely. [<a class="link_ptr" href="SA.html#SASYMP" title="Placing Synchronous Events in Time"><span class="headingNumber">16.4.2 </span>Placing Synchronous Events in Time</a>]</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Module</span></td><td class="wovenodd-col2">linking — Linking, Segmentation, and Alignment</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">absolute<span class="bookmarklink"><a class="bookmarklink" id="tei_att.absolute" href="#tei_att.absolute" title="link to this attribute "><span class="invisible"> absolute</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">supplies an absolute value for the time.<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.temporal.w3c.html">teidata.temporal.w3c</a></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>This attribute should always be specified on a <a class="gi" title="indicates a point in time either relative to other elements in the same timeline tag, or absolutely." href="ref-when.html">when</a> element which serves as the target for the <span class="att">origin</span> attribute of a <span class="gi"><timeLine></span>.</p></td></tr></table></td></tr><tr><td class="odd_label">unit<span class="bookmarklink"><a class="bookmarklink" id="tei_att.unit" href="#tei_att.unit" title="link to this attribute "><span class="invisible"> unit</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">specifies the unit of time in which the <span class="att">interval</span> value is expressed, if this is not inherited from the parent <a class="gi" title="provides a set of ordered points in time which can be linked to elements of a spoken text to create a temporal alignment of that text." href="ref-timeline.html">timeline</a>.
Suggested values include: 1] d(days) ; 2] h(hours) ; 3] min(minutes) ; 4] s(seconds) ; 5] ms(milliseconds) <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.enumerated.html">teidata.enumerated</a></td></tr><tr><td class="odd_label"><span class="label" lang="en">Suggested values include:</span></td><td class="odd_value"><dl class="valList"><dt class="odd_label">d</dt><dd class="odd_value">(days) </dd><dt class="odd_label">h</dt><dd class="odd_value">(hours) </dd><dt class="odd_label">min</dt><dd class="odd_value">(minutes) </dd><dt class="odd_label">s</dt><dd class="odd_value">(seconds) </dd><dt class="odd_label">ms</dt><dd class="odd_value">(milliseconds) </dd></dl></td></tr></table></td></tr><tr><td class="odd_label">interval<span class="bookmarklink"><a class="bookmarklink" id="tei_att.interval" href="#tei_att.interval" title="link to this attribute "><span class="invisible"> interval</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">specifies a time interval either as a number or as one of the keywords defined by the datatype data.interval<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.interval.html">teidata.interval</a></td></tr></table></td></tr><tr><td class="odd_label">since<span class="bookmarklink"><a class="bookmarklink" id="tei_att.since" href="#tei_att.since" title="link to this attribute "><span class="invisible"> since</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">identifies the reference point for determining the time of the current <a class="gi" title="indicates a point in time either relative to other elements in the same timeline tag, or absolutely." href="ref-when.html">when</a> element, which is obtained by adding the interval to the time of the reference point.<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><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>This attribute should point to another <a class="gi" title="indicates a point in time either relative to other elements in the same timeline tag, or absolutely." href="ref-when.html">when</a> element in the same <a class="gi" title="provides a set of ordered points in time which can be linked to elements of a spoken text to create a temporal alignment of that text." href="ref-timeline.html">timeline</a>. If no value is supplied, and the <span class="att">absolute</span> attribute is also unspecified, then the reference point is understood to be the origin of the enclosing <a class="gi" title="provides a set of ordered points in time which can be linked to elements of a spoken text to create a temporal alignment of that text." href="ref-timeline.html">timeline</a> tag.</p></td></tr></table></td></tr></table></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">linking: </span><span class="specChildElements"><a class="link_odd_elementSpec" title="provides a set of ordered points in time which can be linked to elements of a spoken text to create a temporal alignment of that text." href="ref-timeline.html">timeline</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"><span lang="en">Empty element</span></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>On this element, the global <span class="att">xml:id</span> attribute must be supplied to specify an identifier for this point in time. The value used may be chosen freely provided that it is unique within the document and is a syntactically valid name. There is no requirement for values containing numbers to be in sequence.</p></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Example</span></td><td class="wovenodd-col2"><div id="index-egXML-d52e121612" class="pre egXML_valid"><span class="element"><when <span class="attribute">xml:id</span>="<span class="attributevalue">TW3</span>" <span class="attribute">interval</span>="<span class="attributevalue">20</span>" <span class="attribute">since</span>="<span class="attributevalue">#w2</span>"/></span><div style="float: right;"><a href="examples-when.html">Show all</a> </div></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"></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">when</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:optional></span><br /> <span class="element"><rng:attribute <span class="attribute">name</span>="<span class="attributevalue">absolute</span>"></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.temporal.w3c</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">unit</span>"></span><br /> <span class="element"><rng:choice></span><br /> <span class="element"><rng:value></span>d<span class="element"></rng:value></span><br /> <span class="element"><rng:value></span>h<span class="element"></rng:value></span><br /> <span class="element"><rng:value></span>min<span class="element"></rng:value></span><br /> <span class="element"><rng:value></span>s<span class="element"></rng:value></span><br /> <span class="element"><rng:value></span>ms<span class="element"></rng:value></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.enumerated</span>"/></span><br /> <span class="element"></rng:choice></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">interval</span>"></span><br /> <span class="element"><rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.interval</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">since</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:empty/></span><br /><span class="element"></rng:element></span></pre><pre class="RNG_Compact">
<span class="rnc_keyword">element</span> <span class="rnc_nc">when</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 absolute { <a class="link_odd" title="" href="ref-teidata.temporal.w3c.html">teidata.temporal.w3c</a> }?,
attribute unit { "d" | "h" | "min" | "s" | "ms" | <a class="link_odd" title="" href="ref-teidata.enumerated.html">teidata.enumerated</a> }?,
attribute interval { <a class="link_odd" title="" href="ref-teidata.interval.html">teidata.interval</a> }?,
attribute since { <a class="link_odd" title="" href="ref-teidata.pointer.html">teidata.pointer</a> }?,
empty
}</pre></div></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
[<a href="../../en/html/ref-when.html">English</a>]
[<a href="../../de/html/ref-when.html">Deutsch</a>]
[<a href="../../es/html/ref-when.html">Español</a>]
[<a href="../../it/html/ref-when.html">Italiano</a>]
[<a href="../../fr/html/ref-when.html">Français</a>]
[<a href="../../ja/html/ref-when.html">日本語</a>]
[<a href="../../ko/html/ref-when.html">한국어</a>]
[<a href="../../zh-TW/html/ref-when.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>