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-data.language.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 macro data.language </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI macro data.language " /><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-MACROS.html">E Datatypes and Other Macros</a></li></ul></div><div><h3 class="oddSpec" id="data.language">data.language</h3><table class="wovenodd"><tr><td colspan="2"><span class="label">data.language</span> defines the range of attribute values used to identify a particular combination of human language and writing system. [<a class="link_ptr" href="CH.html#CHSH" title="Language Identification"><span class="headingNumber">vi.1. </span>Language Identification</a>]</td></tr><tr><td class="wovenodd-col1"><span lang="en" class="deprecated"><a class="link_" href="http://www.tei-c.org/Activities/Council/Working/tcw27.xml"><span>Deprecated</span></a></span></td><td colspan="2" class="wovenodd-col2"><span lang="en" class="deprecated">This feature will be withdrawn after 2018-10-01</span></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">Used by</span></td><td class="wovenodd-col2"><div class="parent"></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">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:define <span class="attribute">name</span>="<span class="attributevalue">data.language</span>"></span><br /> <span class="element"><rng:choice></span><br /> <span class="element"><rng:data <span class="attribute">type</span>="<span class="attributevalue">language</span>"/></span><br /> <span class="element"><rng:value/></span><br /> <span class="element"></rng:choice></span><br /><span class="element"></rng:define></span></pre><pre class="RNG_Compact">
data.language = xsd:language | ""</pre></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>The values for this attribute are language ‘tags’ as defined in <a class="link_ref" href="https://tools.ietf.org/html/bcp47">BCP 47</a>. Currently BCP 47 comprises RFC 5646 and RFC 4647; over time, other IETF documents may succeed these as the best current practice.</p><p>A ‘language tag’, per BCP 47, is assembled from a sequence of components or <span class="term">subtags</span> separated by the hyphen character (<span class="mentioned">-</span>, U+002D). The tag is made of the following subtags, in the following order. Every subtag except the first is optional. If present, each occurs only once, except the fourth and fifth components (variant and extension), which are repeatable. </p><dl><dt><span>language</span></dt><dd>The IANA-registered code for the language. This is almost always the same as the ISO 639 2-letter language code if there is one. The list of available registered language subtags can be found at <a class="link_ptr" href="http://www.iana.org/assignments/language-subtag-registry"><span>http://www.iana.org/assignments/language-subtag-registry</span></a>. It is recommended that this code be written in lower case.</dd><dt><span>script</span></dt><dd>The ISO 15924 code for the script. These codes consist of 4 letters, and it is recommended they be written with an initial capital, the other three letters in lower case. The canonical list of codes is maintained by the Unicode Consortium, and is available at <a class="link_ptr" href="http://unicode.org/iso15924/iso15924-codes.html"><span>http://unicode.org/iso15924/iso15924-codes.html</span></a>. The IETF recommends this code be omitted unless it is necessary to make a distinction you need.</dd><dt><span>region</span></dt><dd>Either an ISO 3166 country code or a UN M.49 region code that is registered with IANA (not all such codes are registered, e.g. UN codes for economic groupings or codes for countries for which there is already an ISO 3166 2-letter code are not registered). The former consist of 2 letters, and it is recommended they be written in upper case; the list of codes can be searched or browsed at <a class="link_ptr" href="https://www.iso.org/obp/ui/#search/code/"><span>https://www.iso.org/obp/ui/#search/code/</span></a>. The latter consist of 3 digits; the list of codes can be found at <a class="link_ptr" href="http://unstats.un.org/unsd/methods/m49/m49.htm"><span>http://unstats.un.org/unsd/methods/m49/m49.htm</span></a>.</dd><dt><span>variant</span></dt><dd>An IANA-registered variation. These codes <span class="quoted">are used to indicate additional, well-recognized variations that define a language or its dialects that are not covered by other available subtags</span>.</dd><dt><span>extension</span></dt><dd>An extension has the format of a single letter followed by a hyphen followed by additional subtags. These exist to allow for future extension to BCP 47, but as of this writing no such extensions are in use.</dd><dt><span>private use</span></dt><dd>An extension that uses the initial subtag of the single letter <span class="mentioned">x</span> (i.e., starts with <code>x-</code>) has no meaning except as negotiated among the parties involved. These should be used with great care, since they interfere with the interoperability that use of RFC 4646 is intended to promote. In order for a document that makes use of these subtags to be TEI-conformant, a corresponding <a class="gi" title="characterizes a single language or sublanguage used within a text." href="ref-language.html">language</a> element must be present in the TEI header.</dd></dl><p>There are two exceptions to the above format. First, there are language tags in the <a class="link_ref" href="http://www.iana.org/assignments/language-subtag-registry">IANA registry</a> that do not match the above syntax, but are present because they have been ‘grandfathered’ from previous specifications.</p><p>Second, an entire language tag can consist of only a private use subtag. These tags start with <code>x-</code>, and do not need to follow any further rules established by the IETF and endorsed by these Guidelines. Like all language tags that make use of private use subtags, the language in question must be documented in a corresponding <a class="gi" title="characterizes a single language or sublanguage used within a text." href="ref-language.html">language</a> element in the TEI header.</p><p>Examples include </p><dl><dt><span><span class="val">sn</span></span></dt><dd>Shona</dd><dt><span><span class="val">zh-TW</span></span></dt><dd>Taiwanese</dd><dt><span><span class="val">zh-Hant-HK</span></span></dt><dd>Chinese written in traditional script as used in Hong Kong</dd><dt><span><span class="val">en-SL</span></span></dt><dd>English as spoken in Sierra Leone</dd><dt><span><span class="val">pl</span></span></dt><dd>Polish</dd><dt><span><span class="val">es-MX</span></span></dt><dd>Spanish as spoken in Mexico</dd><dt><span><span class="val">es-419</span></span></dt><dd>Spanish as spoken in Latin America</dd></dl><p>The W3C Internationalization Activity has published a useful introduction to BCP 47, <a class="link_ref" href="http://www.w3.org/International/articles/language-tags/Overview.en.php">Language tags in HTML and XML</a>.</p></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
[<a href="../../en/html/ref-data.language.html">English</a>]
[<a href="../../de/html/ref-data.language.html">Deutsch</a>]
[<a href="../../es/html/ref-data.language.html">Español</a>]
[<a href="../../it/html/ref-data.language.html">Italiano</a>]
[<a href="../../fr/html/ref-data.language.html">Français</a>]
[<a href="../../ja/html/ref-data.language.html">日本語</a>]
[<a href="../../ko/html/ref-data.language.html">한국어</a>]
[<a href="../../zh-TW/html/ref-data.language.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>