https://github.com/TEIC/TEI
Raw File
Tip revision: 347c64fac3fa1a64ade0d8d1842813d4b8f7acec authored by Hugh Cayless on 12 May 2017, 16:57:59 UTC
Updates.
Tip revision: 347c64f
ref-classRef.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 classRef </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI element classRef " /><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="classRef">&lt;classRef&gt;</h3><table class="wovenodd"><tr><td colspan="2" class="wovenodd-col2"><span class="label">&lt;classRef&gt; </span>points to the specification for an attribute or model class which is to be included in a schema [<a class="link_ptr" href="TD.html#TDCLA" title="Class Specifications"><span class="headingNumber">22.6 </span>Class Specifications</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>)) <a class="link_odd" title="supplies attributes for the elements which define component parts of a content model." href="ref-att.repeatable.html">att.repeatable</a> (<span class="attribute">@minOccurs</span>, <span class="attribute">@maxOccurs</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 the required class within the source indicated.<table class="attDef"><tr><td class="odd_label"><span class="label" lang="en">Status</span> </td><td class="odd_value"><span lang="en"><span class="required">Required</span></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">expand<span class="bookmarklink"><a class="bookmarklink" id="tei_att.expand" href="#tei_att.expand" title="link to this attribute "><span class="invisible"> expand</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">indicates how references to this class within a content model should be interpreted.<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 class="label" lang="en">Legal values are:</span></td><td class="odd_value"><dl class="valList"><dt class="odd_label">alternate</dt><dd class="odd_value">any one member of the class may appear</dd><dt class="odd_label">sequence</dt><dd class="odd_value">a single occurrence of all members of the class may appear in sequence</dd><dt class="odd_label">sequenceOptional</dt><dd class="odd_value">a single occurrence of one or more members of the class may appear in sequence </dd><dt class="odd_label">sequenceOptionalRepeatable</dt><dd class="odd_value">one or more occurrences of one or more members of the class may appear in sequence. </dd><dt class="odd_label">sequenceRepeatable</dt><dd class="odd_value">one or more occurrences of all members of the class may appear in sequence</dd></dl></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>If the members of the class are <span class="val">a</span>, <span class="val">b</span> and <span class="val">c</span>, then a reference to the class within a content model is understood as being a reference to <span class="val">a|b|c</span> when <span class="att">expand</span> has the value <span class="val">alternation</span>; to <span class="val">a,b,c</span> when it has the value <span class="val">sequence</span>; to <span class="val">(a?,b?,c?)</span> when it has the value <span class="val">sequenceOptional</span>; to (a*,b*, c*) when it has the value <span class="val">sequenceOptionalRepeatable</span>; or to (a+,b+,c+) when it has the value <span class="val">sequenceRepeatable</span>.</p></td></tr></table></td></tr><tr><td class="odd_label">include<span class="bookmarklink"><a class="bookmarklink" id="tei_att.include" href="#tei_att.include" title="link to this attribute "><span class="invisible"> include</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">supplies a list of class members which are to be included in the schema being defined.<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"> 0–∞ <span lang="en">occurrences of</span> <a class="link_element" href="ref-teidata.xmlName.html">teidata.xmlName</a> <span lang="en">separated by whitespace</span></td></tr></table></td></tr><tr><td class="odd_label">except<span class="bookmarklink"><a class="bookmarklink" id="tei_att.except" href="#tei_att.except" title="link to this attribute "><span class="invisible"> except</span><span class="pilcrow">¶</span></a></span></td><td class="odd_value">supplies a list of class members which are to be excluded from the schema being defined.<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"> 0–∞ <span lang="en">occurrences of</span> <a class="link_element" href="ref-teidata.xmlName.html">teidata.xmlName</a> <span lang="en">separated by whitespace</span></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="(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"><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>Attribute and model classes are identified by the name supplied as value for the <span class="att">ident</span> attribute on the <a class="gi" title="(class specification) contains reference information for a TEI element class; that is a group of elements which appear together in content models, or which share some common attribute, or both." href="ref-classSpec.html">classSpec</a> element in which they are declared. All TEI names are unique; attribute class names conventionally begin with the latters <code>att.</code>.</p></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Example</span></td><td class="wovenodd-col2"><div id="index-egXML-d52e142074" class="pre egXML_valid"><span class="element">&lt;schemaSpec <span class="attribute">ident</span>="<span class="attributevalue">myTEIe</span>" <span class="attribute">start</span>="<span class="attributevalue">TEI</span>"&gt;</span><br /> <span class="element">&lt;moduleRef <span class="attribute">key</span>="<span class="attributevalue">tei</span>"/&gt;</span><br /> <span class="element">&lt;moduleRef <span class="attribute">key</span>="<span class="attributevalue">core</span>"<br />  <span class="attribute">include</span>="<span class="attributevalue">abbr add core addrLine address author bibl biblScope choice cit corr 
 date del desc divGen editor emph expan foreign gap gloss graphic head 
 hi index item l label lb lg list listBibl mentioned milestone name 
 note num orig p pb ptr pubPlace publisher q ref reg relatedItem resp 
 respStmt rs sic soCalled sp speaker stage teiCorpus term time title 
 unclear</span>"/&gt;</span><br /> <span class="element">&lt;moduleRef <span class="attribute">key</span>="<span class="attributevalue">header</span>"<br />  <span class="attribute">include</span>="<span class="attributevalue">authority availability catRef category change classCode classDecl 
 creation distributor edition editionStmt editorialDecl encodingDesc 
 extent fileDesc funder idno keywords langUsage language licence notesStmt 
 principal profileDesc projectDesc publicationStmt refsDecl revisionDesc 
 samplingDecl seriesStmt sourceDesc sponsor taxonomy teiHeader textClass 
 titleStmt</span>"/&gt;</span><br /> <span class="element">&lt;moduleRef <span class="attribute">key</span>="<span class="attributevalue">textstructure</span>"<br />  <span class="attribute">include</span>="<span class="attributevalue">TEI argument back body byline closer dateline div docAuthor docDate 
 docEdition docImprint docTitle epigraph front group opener postscript 
 salute signed text titlePage titlePart trailer</span>"/&gt;</span><br /> <span class="element">&lt;classRef <span class="attribute">key</span>="<span class="attributevalue">att.global.facs</span>"/&gt;</span><br /><span class="element">&lt;/schemaSpec&gt;</span><div style="float: right;"><a href="examples-classRef.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">&lt;content/&gt;</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">&lt;rng:element <span class="attribute">name</span>="<span class="attributevalue">classRef</span>"&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.rendition.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.linking.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.analytic.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.facs.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.change.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.responsibility.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.source.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.repeatable.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:attribute <span class="attribute">name</span>="<span class="attributevalue">key</span>"&gt;</span><br />  <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.xmlName</span>"/&gt;</span><br /> <span class="element">&lt;/rng:attribute&gt;</span><br /> <span class="element">&lt;rng:optional&gt;</span><br />  <span class="element">&lt;rng:attribute <span class="attribute">name</span>="<span class="attributevalue">expand</span>"&gt;</span><br />   <span class="element">&lt;rng:choice&gt;</span><br />    <span class="element">&lt;rng:value&gt;</span>alternate<span class="element">&lt;/rng:value&gt;</span><br />    <span class="element">&lt;rng:value&gt;</span>sequence<span class="element">&lt;/rng:value&gt;</span><br />    <span class="element">&lt;rng:value&gt;</span>sequenceOptional<span class="element">&lt;/rng:value&gt;</span><br />    <span class="element">&lt;rng:value&gt;</span>sequenceOptionalRepeatable<span class="element">&lt;/rng:value&gt;</span><br />    <span class="element">&lt;rng:value&gt;</span>sequenceRepeatable<span class="element">&lt;/rng:value&gt;</span><br />   <span class="element">&lt;/rng:choice&gt;</span><br />  <span class="element">&lt;/rng:attribute&gt;</span><br /> <span class="element">&lt;/rng:optional&gt;</span><br /> <span class="element">&lt;rng:choice&gt;</span><br />  <span class="element">&lt;rng:optional&gt;</span><br />   <span class="element">&lt;rng:attribute <span class="attribute">name</span>="<span class="attributevalue">include</span>"&gt;</span><br />    <span class="element">&lt;rng:list&gt;</span><br />     <span class="element">&lt;rng:zeroOrMore&gt;</span><br />      <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.xmlName</span>"/&gt;</span><br />     <span class="element">&lt;/rng:zeroOrMore&gt;</span><br />    <span class="element">&lt;/rng:list&gt;</span><br />   <span class="element">&lt;/rng:attribute&gt;</span><br />  <span class="element">&lt;/rng:optional&gt;</span><br />  <span class="element">&lt;rng:optional&gt;</span><br />   <span class="element">&lt;rng:attribute <span class="attribute">name</span>="<span class="attributevalue">except</span>"&gt;</span><br />    <span class="element">&lt;rng:list&gt;</span><br />     <span class="element">&lt;rng:zeroOrMore&gt;</span><br />      <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">teidata.xmlName</span>"/&gt;</span><br />     <span class="element">&lt;/rng:zeroOrMore&gt;</span><br />    <span class="element">&lt;/rng:list&gt;</span><br />   <span class="element">&lt;/rng:attribute&gt;</span><br />  <span class="element">&lt;/rng:optional&gt;</span><br /> <span class="element">&lt;/rng:choice&gt;</span><br /> <span class="element">&lt;rng:empty/&gt;</span><br /><span class="element">&lt;/rng:element&gt;</span></pre><pre class="RNG_Compact">
<span class="rnc_keyword">element</span> <span class="rnc_nc">classRef</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>,
   <a class="link_odd" title="supplies attributes for the elements which define component parts of a content model." href="ref-att.repeatable.html">att.repeatable.attributes</a>,
   attribute key { <a class="link_odd" title="" href="ref-teidata.xmlName.html">teidata.xmlName</a> },
   <span class="rnc_keyword">attribute</span> <span class="rnc_nc">expand</span>
   {
      "alternate"
    | "sequence"
    | "sequenceOptional"
    | "sequenceOptionalRepeatable"
    | "sequenceRepeatable"
   }?,
   (
      attribute include { list { <a class="link_odd" title="" href="ref-teidata.xmlName.html">teidata.xmlName</a>* } }?
    | attribute except { list { <a class="link_odd" title="" href="ref-teidata.xmlName.html">teidata.xmlName</a>* } }?
   ),
   empty
}</pre></div></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
    [<a href="../../en/html/ref-classRef.html">English</a>]
    [<a href="../../de/html/ref-classRef.html">Deutsch</a>]
    [<a href="../../es/html/ref-classRef.html">Español</a>]
    [<a href="../../it/html/ref-classRef.html">Italiano</a>]
    [<a href="../../fr/html/ref-classRef.html">Français</a>]
    [<a href="../../ja/html/ref-classRef.html">日本語</a>]
    [<a href="../../ko/html/ref-classRef.html">한국어</a>]
    [<a href="../../zh-TW/html/ref-classRef.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>
back to top