- From: Shaun McCance via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 18 Aug 2012 23:07:34 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory hutz:/tmp/cvs-serv12892
Modified Files:
its20.html its20.odd
Log Message:
Adding Disambiguation info from Tadej + markup declaration
Index: its20.odd
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd,v
retrieving revision 1.114
retrieving revision 1.115
diff -u -d -r1.114 -r1.115
--- its20.odd 18 Aug 2012 20:28:27 -0000 1.114
+++ its20.odd 18 Aug 2012 23:07:31 -0000 1.115
@@ -194,7 +194,7 @@
<p>As of the time of this writing, the new data categories included in ITS 2.0 are:</p>
<list type="unorderd">
<item><ref target="#domain">Domain</ref></item>
- <item><ref target="#Disambiugation">Disambiguation</ref></item>
+ <item><ref target="#Disambiguation">Disambiguation</ref></item>
<item><ref target="#LocaleFilter">Locale Filter</ref></item>
<item><ref target="#Provenance">Provenance</ref></item>
<item><ref target="#TextAnalyisAnnotation">Text Analysis Annotation</ref></item>
@@ -3413,12 +3413,378 @@
</div>
</div>
- <div xml:id="Disambiugation">
+ <div xml:id="Disambiguation">
<head>Disambiguation</head>
- <p>The Disambiguation category will be defined in an updated version of this document. For details
- of the proposed data category, see the <ref
- target="http://www.w3.org/TR/2012/WD-its2req-20120524/#disambiguation">ITS 2.0 Requirements
- document</ref>.</p>
+ <div xml:id="Disambiguation-definition">
+ <head>Definition</head>
+ <p>The <ref target="#Disambiguation">Disambiguation</ref> data category
+ is used to communicate the mentions of specific concepts that may require
+ special handling in the localization of the document.</p>
+ <p>This data category can be used for several purposes, including, but
+ not limited to:</p>
+ <list type="unordered">
+ <item>Informing translation systems that this fragment of text may
+ not be literally translated, but subject to specific proper-name
+ translation rules or official translations, as well as a very
+ specific meaning of the phrases.</item>
+ <item>Informing content management and translation systems about
+ the type of the underlying entity in order to enable processing
+ based on a specific type of the entity, for example, when handling
+ personal names, product names or geographic names, chemical compounds,
+ protein names and similar.</item>
+ </list>
+ <p>We introduce the following concepts:</p>
+ <list type="unordered">
+ <item>Entity Type Source: a domain of valid values, an identifier
+ collection for entity types. Unless specified, it will be derived
+ by default de-referencing mechanisms for the URI.</item>
+ <item>Entity Type: the type of the entity, being one of values within
+ the entity type source identifier collection.</item>
+ <item>Disambiguation type: the level of disambiguation (lexical concept,
+ ontology concept, entity). The disambiguation can happen at multiple
+ levels. For instance, the level of lexical concepts disambiguates
+ individual word surface forms, the level of ontology concepts
+ disambiguates into deeper semantics, and the entity disambiguation
+ works on the level of concrete instances. For instance, the word
+ <quote>City</quote> in <quote>I am going to the City</quote> may
+ be disambiguated in one of the WordNet synsets that can be represented
+ by <quote>city</quote>, an RDF ontology concept of a City that could
+ represent a subclass of a PopulatedPlace, or the center area of a
+ particular city, e.g. London City.</item>
+ <item>Disambiguation Source: the identifier collection source used
+ for locating the correct underlying identifier. It can be anything
+ that can representing a collection of identifiers for words, concepts
+ or entities, for instance, a knowledge base, an ontology or semantic
+ network. Unless specified, it will be derived by default de-referencing
+ mechanisms for the URI.</item>
+ <item>Disambiguation Identifier: an identifier, unique within the current
+ disambiguation identifier collection, specifying the actual identifier
+ (meaning, concept or entity) behind the selected content.</item>
+ </list>
+ <p>Two types of Disambiguation data categories are needed to identify:</p>
+ <list type="unordered">
+ <item>Entity type, which describes the type of the underlying entity
+ within a particular domain of types, as specified by the type source
+ identifier collection.</item>
+ <item>Disambiguation, which describes the actual underlying identifier
+ or meaning that the mention refers to, either in a knowledge base,
+ ontology or in a semantic network.</item>
+ </list>
+ <p>Text analysis engines, such as named entity recognizers, named entity,
+ concept and word sense disambiguators can offer an easy way to create this
+ information. Content management tools can present and visualize this
+ information or use it to index their content. Machine translations systems
+ may use it for training and translation when dealing with proper names and
+ edge cases.</p>
+ </div>
+ <div xml:id="Disambiguation-implementation">
+ <head>Implementation</head>
+ <p>The <ref target="#Disambiguation">Disambiguation</ref> data category can
+ be expressed with global rules, or locally on an individual element. The
+ information applies to the textual content of the element. There is no
+ inheritance. The entity type follows inheritance rules.</p>
+ <p>GLOBAL: The <gi>disambiguationRule</gi> element contains the following:</p>
+ <list type="unordered">
+ <item>A required <att>selector</att> attribute. It contains an
+ <ref target="#selectors">absolute selector</ref> which selects
+ the nodes to which this rule applies.</item>
+ <item>An optional <att>entityTypeSourceRef</att> attribute that
+ contains a URI specifying the concrete identifier data source
+ (knowledge base, semantic network), used to determine the entity
+ type.</item>
+ <item>An optional <att>entityTypeSourcePointer</att> attribute
+ that contains a relative XPath expression pointing to a node that
+ represents the identifier data source (knowledge base, semantic
+ network), used to determine the entity type.</item>
+ <item>An optional <att>entityTypeSourceRefPointer</att> attribute
+ that contains a relative XPath expression pointing to a node that
+ holds the URI that represents the identifier data source (knowledge
+ base, semantic network), used to determine the entity type.</item>
+ <item>An optional <att>entityTypeRef</att> attribute that contains
+ a URI, specifying the entity type behind the selector.</item>
+ <item>An optional <att>entityTypePointer</att> attribute that contains
+ a relative XPath expression pointing to a node specifying the entity
+ type behind the selector.</item>
+ <item>An optional <att>entityTypeRefPointer</att> attribute that
+ contains a relative XPath expression pointing to a node that holds
+ the URI that specifies the entity type behind the selector.</item>
+ <item>An optional <att>disambigType</att> attribute that contains
+ a string, specifying the specific semantics of the disambiguation.
+ It can be one of "lexicalConcept", "ontologyConcept", or "entity".</item>
+ <item>An optional <att>disambigSourceRef</att> attribute. It contains
+ a URI representing the disambiguation identifier collection source.</item>
+ <item>An optional <att>disambigSourcePointer</att> attribute. It
+ contains a relative XPath expression pointing to a node that
+ represents the disambiguation identifier collection source.</item>
+ <item>An optional <att>disambigSourceRefPointer</att> attribute.
+ It contains a relative XPath expression pointing to a node that
+ holds the URI that represents the disambiguation identifier
+ collection source.</item>
+ <item>An optional <att>disambigIdentRef</att> attribute. It contains
+ a URI that represents a unique identifier within the identifier
+ collection.</item>
+ <item>An optional <att>disambigIdentPointer</att> attribute. It
+ contains a relative XPath expression pointing to a node that
+ represents a unique identifier within the identifier collection.</item>
+ <item>An optional <att>disambigIdentRefPointer</att> attribute.
+ It contains a relative XPath expression pointing to a node that
+ represents a unique identifier within the identifier collection.</item>
+ </list>
+ <exemplum xml:id="EX-disambiguation-global-1">
+ <head>Usage of <att>entityTypeSourceRef</att>, <att>enttiyTypeRef</att>,
+ <att>disambigSourceRef</att>, <att>disambigIdentRef</att> for both
+ entity and word sense disambiguation.</head>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples"
+ target="examples/xml/EX-disambiguation-global-1.xml"/>
+ </exemplum>
+
+ <p>LOCAL: The following local markup is available for the
+ <ref target="#Disambiguation">Disambiguation</ref> data category:</p>
+ <list type="unordered">
+ <item>An optional <att>entityTypeSourceRef</att> attribute that
+ contains an URI specifying the concrete identifier data source
+ (knowledge base, semantic network), used to determine the entity
+ type.</item>
+ <item>An optional <att>entityTypeRef</att> attribute that contains
+ a URI specifying the entity type behind the selector.</item>
+ <item>An optional <att>disambigType</att> attribute that contains
+ a string, specifying the specific semantics of the disambiguation.
+ It can be one of "lexicalConcept", "ontologyConcept", or
+ "entity".</item>
+ <item>An optional <att>disambigSourceRef</att> attribute. It contains
+ a URI representing the disambiguation identifier collection source.</item>
+ <item>An optional <att>disambigIdentRef</att> attribute. It contains
+ a URI that represents a unique identifier within the identifier
+ collection.</item>
+ </list>
+ <exemplum xml:id="EX-disambiguation-html5-local-1">
+ <head>Local mixed usage of <att>entityTypeSourceRef</att>,
+ <att>enttiyTypeRef</att>, <att>disambigSourceRef</att>,
+ <att>disambigIdentRef</att> in HTML.</head>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples" type="html5"
+ target="examples/html5/EX-disambiguation-html5-local-1.html"/>
+ </exemplum>
+ <note>
+ <p>While the <att>entityTypeSourceRef</att> attribute allows for
+ an arbitrary domain of entity types, the implementors are encouraged
+ to use an existing repository of entity types as long as they satisfy
+ their requirements. For example, the Named Entity Recognition and
+ Disambiguation ontology (NERD): http://nerd.eurecom.fr/ontology</p>
+ <p>The distinction between disambiguating word sense and entities is
+ mainly in the different semantics: whereas word sense disambiguation
+ targets literal words and their senses on the lexical level, entity
+ disambiguation targets real-world concepts that are behind the
+ selected phrases on the conceptual level.</p>
+ <p>When serializing the ITS markup in HTML5, the preferred way is
+ to serialize in RDFa Lite or Microdata due to the existing search
+ and crawling infrastructure that is able to consume this kind of
+ data.</p>
+ </note>
+ <exemplum xml:id="EX-disambiguation-html5-rdfa">
+ <head>Local mixed usage of <att>entityTypeSourceRef</att>,
+ <att>entityTypeRef</att>, <att>disambigSourceRef</att>,
+ <att>disambigIdentRef</att> in HTML+RDFa Lite</head>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples" type="html5"
+ target="examples/html5/EX-disambiguation-html5-rdfa.html"/>
+ <p>Companion document, having the mapping data:</p>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples"
+ target="examples/html5/EX-disambiguation-html5-rdfa.xml"/>
+ </exemplum>
+ </div>
+
+ <div xml:id="Disambiguation-markup">
+ <head>Markup Declarations for Disambiguation</head>
+ <specGrp xml:id="spec-its-disambiguationRule">
+ <elementSpec ident="disambiguationRule" ns="http://www.w3.org/2005/11/its">
+ <desc>Rule about the <ref target="#Disambiguation">Disambiguation</ref> data category.</desc>
+ <classes>
+ <memberOf key="att.selector" />
+ </classes>
+ <content>
+ <rng:empty />
+ </content>
+ <attList>
+ <attDef ident="entityTypeSourceRef" usage="opt">
+ <desc>URI specifying the data source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="entityTypeSourcePointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node specifying the data source.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="entityTypeSourceRefPointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node containing a URI specifying the
+ data source.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="entityTypeRef" usage="opt">
+ <desc>URI specifying the entity type.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="entityTypePointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node specifying the entity type.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="entityTypeRefPointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node containing a URI specifying the
+ entity type.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigType" usage="opt">
+ <desc>String specifying the disambiguation
+ semantics.</desc>
+ <datatype>
+ <rng:choice>
+ <rng:value>lexicalConcept</rng:value>
+ <rng:value>ontologyConcept</rng:value>
+ <rng:value>entity</rng:value>
+ </rng:choice>
+ </datatype>
+ </attDef>
+ <attDef ident="disambigSourceRef" usage="opt">
+ <desc>URI specifying the disambiguation identifier
+ collection source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigSourcePointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node specifying the disambiguation
+ identifier collection source.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigSourceRefPointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node containing a URI specifying the
+ disambiguation identifier collection source.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigIdentRef" usage="opt">
+ <desc>URI specifying a unique identifier in the
+ collection source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigIdentPointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node specifying a unique identifier
+ in the collection source.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigIdentRefPointer" usage="opt">
+ <desc><ref target="#selectors">Relative selector</ref>
+ pointing to a node containing a URI specifying a
+ unique identifier in the collection source.</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ </attList>
+ </elementSpec>
+ <classSpec ident="att.disambiguation" type="atts">
+ <attList>
+ <attDef ident="entityTypeSourceRef" usage="opt"
+ ns="http://www.w3.org/2005/11/its">
+ <desc>URI specifying the data source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigType" usage="opt"
+ ns="http://www.w3.org/2005/11/its">
+ <desc>String specifying the disambiguation
+ semantics.</desc>
+ <datatype>
+ <rng:choice>
+ <rng:value>lexicalConcept</rng:value>
+ <rng:value>ontologyConcept</rng:value>
+ <rng:value>entity</rng:value>
+ </rng:choice>
+ </datatype>
+ </attDef>
+ <attDef ident="disambigSourceRef" usage="opt"
+ ns="http://www.w3.org/2005/11/its">
+ <desc>URI specifying the disambiguation identifier
+ collection source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="disambigIdentRef" usage="opt"
+ ns="http://www.w3.org/2005/11/its">
+ <desc>URI specifying a unique identifier in the
+ collection source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ </attList>
+ </classSpec>
+ <classSpec ident="att.disambiguation.html5" type="atts">
+ <attList>
+ <attDef ident="its-entity-type-source-ref" usage="opt"
+ ns="http://www.w3.org/1999/xhtml">
+ <desc>URI specifying the data source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="its-disambig-type" usage="opt"
+ ns="http://www.w3.org/1999/xhtml">
+ <desc>String specifying the disambiguation
+ semantics.</desc>
+ <datatype>
+ <rng:choice>
+ <rng:value>lexicalConcept</rng:value>
+ <rng:value>ontologyConcept</rng:value>
+ <rng:value>entity</rng:value>
+ </rng:choice>
+ </datatype>
+ </attDef>
+ <attDef ident="its-disambig-source-ref" usage="opt"
+ ns="http://www.w3.org/1999/xhtml">
+ <desc>URI specifying the disambiguation identifier
+ collection source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="its-disambig-ident-ref" usage="opt"
+ ns="http://www.w3.org/1999/xhtml">
+ <desc>URI specifying a unique identifier in the
+ collection source.</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ </attList>
+ </classSpec>
+ </specGrp>
+ </div>
</div>
<div xml:id="LocaleFilter">
Index: its20.html
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html,v
retrieving revision 1.114
retrieving revision 1.115
diff -u -d -r1.114 -r1.115
--- its20.html 17 Aug 2012 09:30:46 -0000 1.114
+++ its20.html 18 Aug 2012 23:07:31 -0000 1.115
@@ -91,7 +91,10 @@
<div class="toc3">6.9.2 <a href="#domain-implementation" shape="rect">Implementation</a></div>
<div class="toc3">6.9.3 <a href="#domain-markup" shape="rect">Markup Declarations for Domain</a></div>
</div>
-<div class="toc2">6.10 <a href="#Disambiugation" shape="rect">Disambiguation</a></div>
+<div class="toc2">6.10 <a href="#Disambiguation" shape="rect">Disambiguation</a><div class="toc3">6.10.1 <a href="#Disambiguation-definition" shape="rect">Definition</a></div>
+<div class="toc3">6.10.2 <a href="#Disambiguation-implementation" shape="rect">Implementation</a></div>
+<div class="toc3">6.10.3 <a href="#Disambiguation-markup" shape="rect">Markup Declarations for Disambiguation</a></div>
+</div>
<div class="toc2">6.11 <a href="#LocaleFilter" shape="rect">Locale Filter</a><div class="toc3">6.11.1 <a href="#LocaleFilter-definition" shape="rect">Definition</a></div>
<div class="toc3">6.11.2 <a href="#LocaleFilter-implementation" shape="rect">Implementation</a></div>
<div class="toc3">6.11.3 <a href="#LocaleFilter-markup" shape="rect">Markup Declarations for Locale Filter</a></div>
@@ -152,7 +155,7 @@
content format mapping in order to support a claim of ITS 2.0 conformance.</p></li><li><p>ITS 2.0 provides algorithms to generate RDFa and NIF out of HTML5 or XML with ITS 2.0
metadata.</p></li><li><p>A global implementation of ITS 2.0 requires at least the XPath version 1.0. Other
versions of XPath or other query languages (e.g., CSS selectors) can be expressed via a
- dedicated <a href="#queryLanguage" shape="rect">queryLanguage</a> attribute.</p></li></ul><p>As of the time of this writing, the new data categories included in ITS 2.0 are:</p><ul><li><p><a href="#domain" shape="rect">Domain</a></p></li><li><p><a href="#Disambiugation" shape="rect">Disambiguation</a></p></li><li><p><a href="#LocaleFilter" shape="rect">Locale Filter</a></p></li><li><p><a href="#Provenance" shape="rect">Provenance</a></p></li><li><p><a href="#TextAnalyisAnnotation" shape="rect">Text Analysis Annotation</a></p></li></ul></div></div><div class="div2">
+ dedicated <a href="#queryLanguage" shape="rect">queryLanguage</a> attribute.</p></li></ul><p>As of the time of this writing, the new data categories included in ITS 2.0 are:</p><ul><li><p><a href="#domain" shape="rect">Domain</a></p></li><li><p><a href="#Disambiguation" shape="rect">Disambiguation</a></p></li><li><p><a href="#LocaleFilter" shape="rect">Locale Filter</a></p></li><li><p><a href="#Provenance" shape="rect">Provenance</a></p></li><li><p><a href="#TextAnalyisAnnotation" shape="rect">Text Analysis Annotation</a></p></li></ul></div></div><div class="div2">
<h3><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="motivation-its" id="motivation-its" shape="rect"/>1.2 Motivation for ITS</h3><p>Content or software that is authored in one language (the <span class="new-term">source language</span>) is often
made available in additional languages or adapted with regard to other cultural aspects. This is
done through a process called <span class="new-term">localization</span>, where the original material is
@@ -1770,12 +1773,211 @@
<a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
attribute domainPointer { string },
attribute domainMapping { string }?</code></td></tr></tbody></table></dd></dl></div></div><div class="div2">
-<h3><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="Disambiugation" id="Disambiugation" shape="rect"/>6.10 Disambiguation</h3><p>The Disambiguation category will be defined in an updated version of this document. For details
- of the proposed data category, see the <a href="http://www.w3.org/TR/2012/WD-its2req-20120524/#disambiguation" shape="rect">ITS 2.0 Requirements
- document</a>.</p></div><div class="div2">
+<h3><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="Disambiguation" id="Disambiguation" shape="rect"/>6.10 Disambiguation</h3><div class="div3">
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="Disambiguation-definition" id="Disambiguation-definition" shape="rect"/>6.10.1 Definition</h4><p>The <a href="#Disambiguation" shape="rect">Disambiguation</a> data category
+ is used to communicate the mentions of specific concepts that may require
+ special handling in the localization of the document.</p><p>This data category can be used for several purposes, including, but
+ not limited to:</p><ul><li><p>Informing translation systems that this fragment of text may
+ not be literally translated, but subject to specific proper-name
+ translation rules or official translations, as well as a very
+ specific meaning of the phrases.</p></li><li><p>Informing content management and translation systems about
+ the type of the underlying entity in order to enable processing
+ based on a specific type of the entity, for example, when handling
+ personal names, product names or geographic names, chemical compounds,
+ protein names and similar.</p></li></ul><p>We introduce the following concepts:</p><ul><li><p>Entity Type Source: a domain of valid values, an identifier
+ collection for entity types. Unless specified, it will be derived
+ by default de-referencing mechanisms for the URI.</p></li><li><p>Entity Type: the type of the entity, being one of values within
+ the entity type source identifier collection.</p></li><li><p>Disambiguation type: the level of disambiguation (lexical concept,
+ ontology concept, entity). The disambiguation can happen at multiple
+ levels. For instance, the level of lexical concepts disambiguates
+ individual word surface forms, the level of ontology concepts
+ disambiguates into deeper semantics, and the entity disambiguation
+ works on the level of concrete instances. For instance, the word"<span class="quote">City</span>" in "<span class="quote">I am going to the City</span>" may
+ be disambiguated in one of the WordNet synsets that can be represented
+ by "<span class="quote">city</span>", an RDF ontology concept of a City that could
+ represent a subclass of a PopulatedPlace, or the center area of a
+ particular city, e.g. London City.</p></li><li><p>Disambiguation Source: the identifier collection source used
+ for locating the correct underlying identifier. It can be anything
+ that can representing a collection of identifiers for words, concepts
+ or entities, for instance, a knowledge base, an ontology or semantic
+ network. Unless specified, it will be derived by default de-referencing
+ mechanisms for the URI.</p></li><li><p>Disambiguation Identifier: an identifier, unique within the current
+ disambiguation identifier collection, specifying the actual identifier
+ (meaning, concept or entity) behind the selected content.</p></li></ul><p>Two types of Disambiguation data categories are needed to identify:</p><ul><li><p>Entity type, which describes the type of the underlying entity
+ within a particular domain of types, as specified by the type source
+ identifier collection.</p></li><li><p>Disambiguation, which describes the actual underlying identifier
+ or meaning that the mention refers to, either in a knowledge base,
+ ontology or in a semantic network.</p></li></ul><p>Text analysis engines, such as named entity recognizers, named entity,
+ concept and word sense disambiguators can offer an easy way to create this
+ information. Content management tools can present and visualize this
+ information or use it to index their content. Machine translations systems
+ may use it for training and translation when dealing with proper names and
+ edge cases.</p></div><div class="div3">
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="Disambiguation-implementation" id="Disambiguation-implementation" shape="rect"/>6.10.2 Implementation</h4><p>The <a href="#Disambiguation" shape="rect">Disambiguation</a> data category can
+ be expressed with global rules, or locally on an individual element. The
+ information applies to the textual content of the element. There is no
+ inheritance. The entity type follows inheritance rules.</p><p>GLOBAL: The <a class="itsmarkup" href="#disambiguationRule" shape="rect">disambiguationRule</a> element contains the following:</p><ul><li><p>A required <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute. It contains an
+ <a href="#selectors" shape="rect">absolute selector</a> which selects
+ the nodes to which this rule applies.</p></li><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.entityTypeSourceRef" shape="rect">entityTypeSourceRef</a> attribute that
+ contains a URI specifying the concrete identifier data source
+ (knowledge base, semantic network), used to determine the entity
+ type.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">entityTypeSourcePointer</a> attribute
+ that contains a relative XPath expression pointing to a node that
+ represents the identifier data source (knowledge base, semantic
+ network), used to determine the entity type.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">entityTypeSourceRefPointer</a> attribute
+ that contains a relative XPath expression pointing to a node that
+ holds the URI that represents the identifier data source (knowledge
+ base, semantic network), used to determine the entity type.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">entityTypeRef</a> attribute that contains
+ a URI, specifying the entity type behind the selector.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">entityTypePointer</a> attribute that contains
+ a relative XPath expression pointing to a node specifying the entity
+ type behind the selector.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">entityTypeRefPointer</a> attribute that
+ contains a relative XPath expression pointing to a node that holds
+ the URI that specifies the entity type behind the selector.</p></li><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.disambigType" shape="rect">disambigType</a> attribute that contains
+ a string, specifying the specific semantics of the disambiguation.
+ It can be one of "lexicalConcept", "ontologyConcept", or "entity".</p></li><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.disambigSourceRef" shape="rect">disambigSourceRef</a> attribute. It contains
+ a URI representing the disambiguation identifier collection source.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">disambigSourcePointer</a> attribute. It
+ contains a relative XPath expression pointing to a node that
+ represents the disambiguation identifier collection source.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">disambigSourceRefPointer</a> attribute.
+ It contains a relative XPath expression pointing to a node that
+ holds the URI that represents the disambiguation identifier
+ collection source.</p></li><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.disambigIdentRef" shape="rect">disambigIdentRef</a> attribute. It contains
+ a URI that represents a unique identifier within the identifier
+ collection.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">disambigIdentPointer</a> attribute. It
+ contains a relative XPath expression pointing to a node that
+ represents a unique identifier within the identifier collection.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">disambigIdentRefPointer</a> attribute.
+ It contains a relative XPath expression pointing to a node that
+ represents a unique identifier within the identifier collection.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-global-1" id="EX-disambiguation-global-1" shape="rect"/>Example 51: Usage of <a class="itsmarkup" href="#att.disambiguation.attribute.entityTypeSourceRef" shape="rect">entityTypeSourceRef</a>, <code>enttiyTypeRef</code>,
+ <a class="itsmarkup" href="#att.disambiguation.attribute.disambigSourceRef" shape="rect">disambigSourceRef</a>, <a class="itsmarkup" href="#att.disambiguation.attribute.disambigIdentRef" shape="rect">disambigIdentRef</a> for both
+ entity and word sense disambiguation.</div><div class="exampleInner"><pre xml:space="preserve">
+<text
+ xmlns:its="http://www.w3.org/2005/11/its" >
+ <its:rules version="2.0">
+ <its:disambiguationRule
+ selector="/text/body/p/*[@id=’dublin’]"
+ entityTypeSourceRef="http:/nerd.eurecom.fr/ontology"
+ entityTypeRef="http:/nerd.eurecom.fr/ontology#Place"
+ disambigType="entity"
+ disambigSourceRef="http://dbpedia.org/"
+ disambigIdentRef="http://dbpedia.org/resource/Dublin"/>
+ <its:disambiguationRule
+ selector="/text/body/p/*[@id=’capital’]"
+ disambigType="lexicalConcept"
+ disambigSourceRef="http://www.w3.org/2006/03/wn/wn20/rdf/wordnet-synset.rdf"
+ disambigIdentRef="http://www.w3.org/2006/03/wn/wn20/instances/worsense-capital-noun-3"/>
+ </its:rules>
+ <body>
+ <p>
+ <span id="dublin">Dublin</span> is the <span id="capital">capital of Ireland</span>.</p>
+ </body>
+</text></pre></div><p>[Source file: <a href="examples/xml/EX-disambiguation-global-1.xml" shape="rect">examples/xml/EX-disambiguation-global-1.xml</a>]</p></div><p>LOCAL: The following local markup is available for the
+ <a href="#Disambiguation" shape="rect">Disambiguation</a> data category:</p><ul><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.entityTypeSourceRef" shape="rect">entityTypeSourceRef</a> attribute that
+ contains an URI specifying the concrete identifier data source
+ (knowledge base, semantic network), used to determine the entity
+ type.</p></li><li><p>An optional <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">entityTypeRef</a> attribute that contains
+ a URI specifying the entity type behind the selector.</p></li><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.disambigType" shape="rect">disambigType</a> attribute that contains
+ a string, specifying the specific semantics of the disambiguation.
+ It can be one of "lexicalConcept", "ontologyConcept", or
+ "entity".</p></li><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.disambigSourceRef" shape="rect">disambigSourceRef</a> attribute. It contains
+ a URI representing the disambiguation identifier collection source.</p></li><li><p>An optional <a class="itsmarkup" href="#att.disambiguation.attribute.disambigIdentRef" shape="rect">disambigIdentRef</a> attribute. It contains
+ a URI that represents a unique identifier within the identifier
+ collection.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-local-1" id="EX-disambiguation-html5-local-1" shape="rect"/>Example 52: Local mixed usage of <a class="itsmarkup" href="#att.disambiguation.attribute.entityTypeSourceRef" shape="rect">entityTypeSourceRef</a>,
+ <code>enttiyTypeRef</code>, <a class="itsmarkup" href="#att.disambiguation.attribute.disambigSourceRef" shape="rect">disambigSourceRef</a>,
+ <a class="itsmarkup" href="#att.disambiguation.attribute.disambigIdentRef" shape="rect">disambigIdentRef</a> in HTML.</div><div class="exampleInner"><pre xml:space="preserve"><!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8"/>
+ <title>Entity: Local Test</title>
+ </head>
+ <body>
+ <p>
+ <span
+ its-entity-type-source-ref="http://nerd.eurecom.fr/ontology"
+ its-entity-type-ident-ref="http:/nerd.eurecom.fr/ontology#Place"
+ its-disambig-source-ref="http://dbpedia.org/"
+ its-disambig-ident-ref="http://dbpedia.org/resource/Dublin"
+ its-disambig-type="entity">Dublin</span> is the <span its-disambig-source-ref="http://www.w3.org/2006/03/wn/wn20/rdf/wordnet-synset.rdf"
+ its-disambig-ident-ref="http://www.w3.org/2006/03/wn/wn20/instances/worsense-capital-noun-3" its-disambig-type="lexicalConcept">capital</span> of Ireland.</p>
+ </body>
+</html></pre></div><p>[Source file: <a href="examples/html5/EX-disambiguation-html5-local-1.html" shape="rect">examples/html5/EX-disambiguation-html5-local-1.html</a>]</p></div><div class="note"><p class="prefix"><b>Note:</b></p><p>While the <a class="itsmarkup" href="#att.disambiguation.attribute.entityTypeSourceRef" shape="rect">entityTypeSourceRef</a> attribute allows for
+ an arbitrary domain of entity types, the implementors are encouraged
+ to use an existing repository of entity types as long as they satisfy
+ their requirements. For example, the Named Entity Recognition and
+ Disambiguation ontology (NERD): http://nerd.eurecom.fr/ontology</p><p>The distinction between disambiguating word sense and entities is
+ mainly in the different semantics: whereas word sense disambiguation
+ targets literal words and their senses on the lexical level, entity
+ disambiguation targets real-world concepts that are behind the
+ selected phrases on the conceptual level.</p><p>When serializing the ITS markup in HTML5, the preferred way is
+ to serialize in RDFa Lite or Microdata due to the existing search
+ and crawling infrastructure that is able to consume this kind of
+ data.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-rdfa" id="EX-disambiguation-html5-rdfa" shape="rect"/>Example 53: Local mixed usage of <a class="itsmarkup" href="#att.disambiguation.attribute.entityTypeSourceRef" shape="rect">entityTypeSourceRef</a>,
+ <a class="itsmarkup" href="#disambiguationRule.attributes" shape="rect">entityTypeRef</a>, <a class="itsmarkup" href="#att.disambiguation.attribute.disambigSourceRef" shape="rect">disambigSourceRef</a>,
+ <a class="itsmarkup" href="#att.disambiguation.attribute.disambigIdentRef" shape="rect">disambigIdentRef</a> in HTML+RDFa Lite</div><div class="exampleInner"><pre xml:space="preserve"><!DOCTYPE html>
+<html
+ xmlns:its="http://www.w3.org/2005/11/its" lang="en">
+ <head>
+ <meta charset="utf-8"/>
+ <title>Entity: Local Test</title>
+ </head>
+ <body prefix="its: http://www.w3.org/20XX/XX/its2.0">
+ <p>
+ <span resource="http://dbpedia.org/resource/Dublin" typeof="http:/nerd.eurecom.fr/ontology#Place" property="name">Dublin</span> is the capital of Ireland.</p>
+ </body>
+</html></pre></div><p>[Source file: <a href="examples/html5/EX-disambiguation-html5-rdfa.html" shape="rect">examples/html5/EX-disambiguation-html5-rdfa.html</a>]</p><p>Companion document, having the mapping data:</p><div class="exampleInner"><pre xml:space="preserve">
+<its:rules
+ xmlns:its="http://www.w3.org/2005/11/its" version="2.0">
+ <its:disambiguationRule selector="//*[@typeof]" entityTypeRefPointer="@typeof"/>
+ <its:disambiguationRule selector="//*[@resource]" disambigIdentRefPointer="@resource"/>
+</its:rules></pre></div><p>[Source file: <a href="examples/html5/EX-disambiguation-html5-rdfa.xml" shape="rect">examples/html5/EX-disambiguation-html5-rdfa.xml</a>]</p></div></div><div class="div3">
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="Disambiguation-markup" id="Disambiguation-markup" shape="rect"/>6.10.3 Markup Declarations for Disambiguation</h4><dl><dt class="label">disambiguationRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="disambiguationRule" id="disambiguationRule" shape="rect"/>[107] </td><td rowspan="1" colspan="1"><code>disambiguationRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ element its:disambiguationRule
+ {
+ disambiguationRule.content,
+ <a href="#disambiguationRule.attributes" shape="rect">disambiguationRule.attributes</a>
+ }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="disambiguationRule.content" id="disambiguationRule.content" shape="rect"/>[108] </td><td rowspan="1" colspan="1"><code>disambiguationRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="disambiguationRule.attributes" id="disambiguationRule.attributes" shape="rect"/>[109] </td><td rowspan="1" colspan="1"><code>disambiguationRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+
+ <a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
+ attribute entityTypeSourceRef { xsd:anyURI }?,
+ attribute entityTypeSourcePointer { string }?,
+ attribute entityTypeSourceRefPointer { string }?,
+ attribute entityTypeRef { xsd:anyURI }?,
+ attribute entityTypePointer { string }?,
+ attribute entityTypeRefPointer { string }?,
+ attribute disambigType { "lexicalConcept" | "ontologyConcept" | "entity" }?,
+ attribute disambigSourceRef { xsd:anyURI }?,
+ attribute disambigSourcePointer { string }?,
+ attribute disambigSourceRefPointer { string }?,
+ attribute disambigIdentRef { xsd:anyURI }?,
+ attribute disambigIdentPointer { string }?,
+ attribute disambigIdentRefPointer { string }?</code></td></tr></tbody></table></dd><dt class="label"><a name="att.disambiguation" id="att.disambiguation" shape="rect"/>att.disambiguation</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.attributes" id="att.disambiguation.attributes" shape="rect"/>[110] </td><td rowspan="1" colspan="1"><code>att.disambiguation.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+
+ <a href="#att.disambiguation.attribute.entityTypeSourceRef" shape="rect">att.disambiguation.attribute.entityTypeSourceRef</a>,
+ <a href="#att.disambiguation.attribute.disambigType" shape="rect">att.disambiguation.attribute.disambigType</a>,
+ <a href="#att.disambiguation.attribute.disambigSourceRef" shape="rect">att.disambiguation.attribute.disambigSourceRef</a>,
+ <a href="#att.disambiguation.attribute.disambigIdentRef" shape="rect">att.disambiguation.attribute.disambigIdentRef</a>
+ </code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.attribute.entityTypeSourceRef" id="att.disambiguation.attribute.entityTypeSourceRef" shape="rect"/>[111] </td><td rowspan="1" colspan="1"><code>att.disambiguation.attribute.entityTypeSourceRef</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its:entityTypeSourceRef { xsd:anyURI }?</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.attribute.disambigType" id="att.disambiguation.attribute.disambigType" shape="rect"/>[112] </td><td rowspan="1" colspan="1"><code>att.disambiguation.attribute.disambigType</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its:disambigType
+ {
+ "lexicalConcept" | "ontologyConcept" | "entity"
+ }?</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.attribute.disambigSourceRef" id="att.disambiguation.attribute.disambigSourceRef" shape="rect"/>[113] </td><td rowspan="1" colspan="1"><code>att.disambiguation.attribute.disambigSourceRef</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its:disambigSourceRef { xsd:anyURI }?</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.attribute.disambigIdentRef" id="att.disambiguation.attribute.disambigIdentRef" shape="rect"/>[114] </td><td rowspan="1" colspan="1"><code>att.disambiguation.attribute.disambigIdentRef</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its:disambigIdentRef { xsd:anyURI }?</code></td></tr></tbody></table></dd><dt class="label"><a name="att.disambiguation.html5" id="att.disambiguation.html5" shape="rect"/>att.disambiguation.html5</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.html5.attributes" id="att.disambiguation.html5.attributes" shape="rect"/>[115] </td><td rowspan="1" colspan="1"><code>att.disambiguation.html5.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+
+ <a href="#att.disambiguation.html5.attribute.its-entity-type-source-ref" shape="rect">att.disambiguation.html5.attribute.its-entity-type-source-ref</a>,
+ <a href="#att.disambiguation.html5.attribute.its-disambig-type" shape="rect">att.disambiguation.html5.attribute.its-disambig-type</a>,
+ <a href="#att.disambiguation.html5.attribute.its-disambig-source-ref" shape="rect">att.disambiguation.html5.attribute.its-disambig-source-ref</a>,
+ <a href="#att.disambiguation.html5.attribute.its-disambig-ident-ref" shape="rect">att.disambiguation.html5.attribute.its-disambig-ident-ref</a>
+ </code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.html5.attribute.its-entity-type-source-ref" id="att.disambiguation.html5.attribute.its-entity-type-source-ref" shape="rect"/>[116] </td><td rowspan="1" colspan="1"><code>att.disambiguation.html5.attribute.its-entity-type-source-ref</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its-entity-type-source-ref { xsd:anyURI }?</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.html5.attribute.its-disambig-type" id="att.disambiguation.html5.attribute.its-disambig-type" shape="rect"/>[117] </td><td rowspan="1" colspan="1"><code>att.disambiguation.html5.attribute.its-disambig-type</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its-disambig-type
+ {
+ "lexicalConcept" | "ontologyConcept" | "entity"
+ }?</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.html5.attribute.its-disambig-source-ref" id="att.disambiguation.html5.attribute.its-disambig-source-ref" shape="rect"/>[118] </td><td rowspan="1" colspan="1"><code>att.disambiguation.html5.attribute.its-disambig-source-ref</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its-disambig-source-ref { xsd:anyURI }?</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.disambiguation.html5.attribute.its-disambig-ident-ref" id="att.disambiguation.html5.attribute.its-disambig-ident-ref" shape="rect"/>[119] </td><td rowspan="1" colspan="1"><code>att.disambiguation.html5.attribute.its-disambig-ident-ref</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its-disambig-ident-ref { xsd:anyURI }?</code></td></tr></tbody></table></dd></dl></div></div><div class="div2">
<h3><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="LocaleFilter" id="LocaleFilter" shape="rect"/>6.11 Locale Filter</h3><div class="div3">
<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="LocaleFilter-definition" id="LocaleFilter-definition" shape="rect"/>6.11.1 Definition</h4><p>The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category specifies that a node is
- only applicable to certain locales, or that it is not applicable to certain locales.</p><p>This data category can be used for several purposes, including, but not limited to:</p><ul><li><p>Include a legal notice only in locales for certain regions.</p></li><li><p>Drop editorial notes from all localized output.</p></li></ul><p>The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category associates with each
+ only applicable to certain locales.</p><p>This data category can be used for several purposes, including, but not limited to:</p><ul><li><p>Include a legal notice only in locales for certain regions.</p></li><li><p>Drop editorial notes from all localized output.</p></li></ul><p>The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category associates with each
selected node a list of extended language ranges conforming to <a title="Tags for Identifying
								Languages" href="#bcp47" shape="rect">[BCP47]</a>. The list is comma-separated and can include the wildcard extended
language range "*". The list can also be empty. Whitespace surrounding language
ranges is ignored.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>To express that all locales should be included, one can use the wildcard "*"
@@ -1786,7 +1988,7 @@
content of the element, <em>including</em> child elements and attributes. The default is
that the language range is "*".</p><p>Implementations <a href="#rfc2119" shape="rect">MUST NOT</a> combine lists of language ranges from
multiple rules or local attributes.</p><p>GLOBAL: The <a class="itsmarkup" href="#localeFilterRule" shape="rect">localeFilterRule</a> element contains the following:</p><ul><li><p>A required <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <a class="itsmarkup" href="#att.local.no-ns.attribute.localeFilterList" shape="rect">localeFilterList</a> attribute with a comma-separated list of
- extended language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-1" id="EX-locale-filter-selector-1" shape="rect"/>Example 51: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
+ extended language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-1" id="EX-locale-filter-selector-1" shape="rect"/>Example 54: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
globally</div><p>The <a class="itsmarkup" href="#localeFilterRule" shape="rect">localeFilterRule</a> element specifies that certain legal notice elements should
only be shown in the specified locales. Note that using the extended language range
"*-CA" in the <a class="itsmarkup" href="#att.local.no-ns.attribute.localeFilterList" shape="rect">localeFilterList</a> attribute would cover all
@@ -1802,7 +2004,7 @@
<para>This legal notice is only for Canadian locales.</para>
</legalnotice>
</info>
-</book></pre></div><p>[Source file: <a href="examples/xml/EX-locale-filter-selector-1.xml" shape="rect">examples/xml/EX-locale-filter-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-2" id="EX-locale-filter-selector-2" shape="rect"/>Example 52: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
+</book></pre></div><p>[Source file: <a href="examples/xml/EX-locale-filter-selector-1.xml" shape="rect">examples/xml/EX-locale-filter-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-2" id="EX-locale-filter-selector-2" shape="rect"/>Example 55: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
globally</div><p>The <a class="itsmarkup" href="#localeFilterRule" shape="rect">localeFilterRule</a> element specifies that editorial remarks should be removed
from all translations.</p><div class="exampleInner"><pre xml:space="preserve">
<section
@@ -1815,7 +2017,7 @@
<remark>Note: This section will be written later.</remark>
</section></pre></div><p>[Source file: <a href="examples/xml/EX-locale-filter-selector-2.xml" shape="rect">examples/xml/EX-locale-filter-selector-2.xml</a>]</p></div><p>LOCAL: The following local markup is available for the <a href="#LocaleFilter" shape="rect">Locale
Filter</a> data category:</p><ul><li><p>A <a class="itsmarkup" href="#att.local.no-ns.attribute.localeFilterList" shape="rect">localeFilterList</a> attribute with a comma-separated list of extended
- language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-attribute-1" id="EX-locale-filter-attribute-1" shape="rect"/>Example 53: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
+ language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-attribute-1" id="EX-locale-filter-attribute-1" shape="rect"/>Example 56: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
locally</div><div class="exampleInner"><pre xml:space="preserve">
<book
xmlns:its="http://www.w3.org/2005/11/its" >
@@ -1826,21 +2028,21 @@
</legalnotice>
</info>
</book></pre></div><p>[Source file: <a href="examples/xml/EX-locale-filter-attribute-1.xml" shape="rect">examples/xml/EX-locale-filter-attribute-1.xml</a>]</p></div></div><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="LocaleFilter-markup" id="LocaleFilter-markup" shape="rect"/>6.11.3 Markup Declarations for Locale Filter</h4><dl><dt class="label">localeFilterRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="localeFilterRule" id="localeFilterRule" shape="rect"/>[107] </td><td rowspan="1" colspan="1"><code>localeFilterRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="LocaleFilter-markup" id="LocaleFilter-markup" shape="rect"/>6.11.3 Markup Declarations for Locale Filter</h4><dl><dt class="label">localeFilterRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="localeFilterRule" id="localeFilterRule" shape="rect"/>[120] </td><td rowspan="1" colspan="1"><code>localeFilterRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
element its:localeFilterRule
{
localeFilterRule.content,
<a href="#localeFilterRule.attributes" shape="rect">localeFilterRule.attributes</a>
- }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="localeFilterRule.content" id="localeFilterRule.content" shape="rect"/>[108] </td><td rowspan="1" colspan="1"><code>localeFilterRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="localeFilterRule.attributes" id="localeFilterRule.attributes" shape="rect"/>[109] </td><td rowspan="1" colspan="1"><code>localeFilterRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="localeFilterRule.content" id="localeFilterRule.content" shape="rect"/>[121] </td><td rowspan="1" colspan="1"><code>localeFilterRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="localeFilterRule.attributes" id="localeFilterRule.attributes" shape="rect"/>[122] </td><td rowspan="1" colspan="1"><code>localeFilterRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
- attribute localeFilterList { string }</code></td></tr></tbody></table></dd><dt class="label"><a name="att.localeFilter" id="att.localeFilter" shape="rect"/>att.localeFilter</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.attributes" id="att.localeFilter.attributes" shape="rect"/>[110] </td><td rowspan="1" colspan="1"><code>att.localeFilter.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute localeFilterList { string }</code></td></tr></tbody></table></dd><dt class="label"><a name="att.localeFilter" id="att.localeFilter" shape="rect"/>att.localeFilter</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.attributes" id="att.localeFilter.attributes" shape="rect"/>[123] </td><td rowspan="1" colspan="1"><code>att.localeFilter.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.localeFilter.attribute.localeFilterList" shape="rect">att.localeFilter.attribute.localeFilterList</a>
- </code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.attribute.localeFilterList" id="att.localeFilter.attribute.localeFilterList" shape="rect"/>[111] </td><td rowspan="1" colspan="1"><code>att.localeFilter.attribute.localeFilterList</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
- attribute its:localeFilterList { string }?</code></td></tr></tbody></table></dd><dt class="label"><a name="att.localeFilter.html5" id="att.localeFilter.html5" shape="rect"/>att.localeFilter.html5</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.html5.attributes" id="att.localeFilter.html5.attributes" shape="rect"/>[112] </td><td rowspan="1" colspan="1"><code>att.localeFilter.html5.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ </code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.attribute.localeFilterList" id="att.localeFilter.attribute.localeFilterList" shape="rect"/>[124] </td><td rowspan="1" colspan="1"><code>att.localeFilter.attribute.localeFilterList</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute its:localeFilterList { string }?</code></td></tr></tbody></table></dd><dt class="label"><a name="att.localeFilter.html5" id="att.localeFilter.html5" shape="rect"/>att.localeFilter.html5</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.html5.attributes" id="att.localeFilter.html5.attributes" shape="rect"/>[125] </td><td rowspan="1" colspan="1"><code>att.localeFilter.html5.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.localeFilter.html5.attribute.its-locale-filter-list" shape="rect">att.localeFilter.html5.attribute.its-locale-filter-list</a>
- </code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.html5.attribute.its-locale-filter-list" id="att.localeFilter.html5.attribute.its-locale-filter-list" shape="rect"/>[113] </td><td rowspan="1" colspan="1"><code>att.localeFilter.html5.attribute.its-locale-filter-list</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ </code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="att.localeFilter.html5.attribute.its-locale-filter-list" id="att.localeFilter.html5.attribute.its-locale-filter-list" shape="rect"/>[126] </td><td rowspan="1" colspan="1"><code>att.localeFilter.html5.attribute.its-locale-filter-list</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
attribute its-locale-filter-list { string }?</code></td></tr></tbody></table></dd></dl></div></div><div class="div2">
<h3><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="Provenance" id="Provenance" shape="rect"/>6.12 Provenance</h3><p>The Provenance data category will be defined in an updated version of this document. For details
of the proposed data category, see the <a href="http://www.w3.org/TR/2012/WD-its2req-20120524/#Provenance" shape="rect">ITS 2.0 Requirements
@@ -1854,7 +2056,7 @@
document. Examples of such resources are external images and audio or video files.</p></div><div class="div3">
<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="externalresource-implementation" id="externalresource-implementation" shape="rect"/>6.14.2 Implementation</h4><p>The <a href="#externalresource" shape="rect">External Resource</a> data category can be expressed
only with global rules. There is no inheritance. There is no default.</p><p>GLOBAL: The <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> element contains the following:</p><ul><li><p>A required <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <a class="itsmarkup" href="#externalResourceRefRule.attributes" shape="rect">externalResourceRefPointer</a> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that provides the URI
- of the external resource.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-externalresource-1" id="EX-externalresource-1" shape="rect"/>Example 54: The <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> element</div><p>The <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> element expresses that the <code>imagedata</code>,
+ of the external resource.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-externalresource-1" id="EX-externalresource-1" shape="rect"/>Example 57: The <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> element</div><p>The <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> element expresses that the <code>imagedata</code>,
<code>audiodata</code> and <code>videodata</code> elements contain references to
external resources. These references are expressed via a <code>fileref</code> attribute.
The <a class="itsmarkup" href="#externalResourceRefRule.attributes" shape="rect">externalResourceRefPointer</a> attribute points to that attribute.</p><div class="exampleInner"><pre xml:space="preserve">
@@ -1881,19 +2083,19 @@
</warning>
</textobject>
</mediaobject>
-</doc></pre></div><p>[Source file: <a href="examples/xml/EX-externalresource-1.xml" shape="rect">examples/xml/EX-externalresource-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-externalresource-2" id="EX-externalresource-2" shape="rect"/>Example 55: Two <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> elements used for external resources associated
+</doc></pre></div><p>[Source file: <a href="examples/xml/EX-externalresource-1.xml" shape="rect">examples/xml/EX-externalresource-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-externalresource-2" id="EX-externalresource-2" shape="rect"/>Example 58: Two <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> elements used for external resources associated
with HTML5 <code>video</code> elements</div><p>The two <a class="itsmarkup" href="#externalResourceRefRule" shape="rect">externalResourceRefRule</a> elements select the <code>src</code> and the
<code>poster</code> attributes at HTML5 <code>video</code> elements. These
attributes identify different external resources, and at the same time contain the
references to these resources. For this reason, the
<a class="itsmarkup" href="#externalResourceRefRule.attributes" shape="rect">externalResourceRefPointer</a> attributes point to the value of
<code>src</code> and <code>poster</code> respectively. The underlying HTML5 document
- is given in <a href="#EX-externalresource-html5-1" shape="rect">Example 56</a>.</p><div class="exampleInner"><pre xml:space="preserve">
+ is given in <a href="#EX-externalresource-html5-1" shape="rect">Example 59</a>.</p><div class="exampleInner"><pre xml:space="preserve">
<its:rules
xmlns:its="http://www.w3.org/2005/11/its" version="2.0">
<its:externalResourceRefRule selector="//html:video/@src" externalResourceRefPointer="."/>
<its:externalResourceRefRule selector="//html:video/@poster" externalResourceRefPointer="."/>
-</its:rules></pre></div><p>[Source file: <a href="examples/xml/EX-externalresource-2.xml" shape="rect">examples/xml/EX-externalresource-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-externalresource-html5-1" id="EX-externalresource-html5-1" shape="rect"/>Example 56: An HTML5 document that can be used for <a href="#EX-externalresource-2" shape="rect">Example 55</a>.</div><div class="exampleInner"><pre xml:space="preserve"><!DOCTYPE html>
+</its:rules></pre></div><p>[Source file: <a href="examples/xml/EX-externalresource-2.xml" shape="rect">examples/xml/EX-externalresource-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-externalresource-html5-1" id="EX-externalresource-html5-1" shape="rect"/>Example 59: An HTML5 document that can be used for <a href="#EX-externalresource-2" shape="rect">Example 58</a>.</div><div class="exampleInner"><pre xml:space="preserve"><!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8"/>
@@ -1909,12 +2111,12 @@
</video>
</body>
</html></pre></div><p>[Source file: <a href="examples/html5/EX-externalresource-html5-1.html" shape="rect">examples/html5/EX-externalresource-html5-1.html</a>]</p></div></div><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="externalresource-markup" id="externalresource-markup" shape="rect"/>6.14.3 Markup Declarations for External Resource</h4><dl><dt class="label">externalResourceRefRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="externalResourceRefRule" id="externalResourceRefRule" shape="rect"/>[114] </td><td rowspan="1" colspan="1"><code>externalResourceRefRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="externalresource-markup" id="externalresource-markup" shape="rect"/>6.14.3 Markup Declarations for External Resource</h4><dl><dt class="label">externalResourceRefRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="externalResourceRefRule" id="externalResourceRefRule" shape="rect"/>[127] </td><td rowspan="1" colspan="1"><code>externalResourceRefRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
element its:externalResourceRefRule
{
externalResourceRefRule.content,
<a href="#externalResourceRefRule.attributes" shape="rect">externalResourceRefRule.attributes</a>
- }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="externalResourceRefRule.content" id="externalResourceRefRule.content" shape="rect"/>[115] </td><td rowspan="1" colspan="1"><code>externalResourceRefRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="externalResourceRefRule.attributes" id="externalResourceRefRule.attributes" shape="rect"/>[116] </td><td rowspan="1" colspan="1"><code>externalResourceRefRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="externalResourceRefRule.content" id="externalResourceRefRule.content" shape="rect"/>[128] </td><td rowspan="1" colspan="1"><code>externalResourceRefRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="externalResourceRefRule.attributes" id="externalResourceRefRule.attributes" shape="rect"/>[129] </td><td rowspan="1" colspan="1"><code>externalResourceRefRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
attribute externalResourceRefPointer { string }</code></td></tr></tbody></table></dd></dl></div></div><div class="div2">
@@ -1936,7 +2138,7 @@
no inheritance. There is no default.</p><p>GLOBAL: The <a class="itsmarkup" href="#targetPointerRule" shape="rect">targetPointerRule</a> element contains the following:</p><ul><li><p>A required <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <a class="itsmarkup" href="#targetPointerRule.attributes" shape="rect">targetPointer</a> attribute. It contains a <a href="#selectors" shape="rect">relative selector</a> that points to the node for the target content
corresponding to the selected source node.</p></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><p>The source node and the target node may be of different types, but the target node must
be able to contain the same content of the source node (e.g. an attribute node cannot be
- the target node of a source node that is an element with children).</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-target-pointer-global-1" id="EX-target-pointer-global-1" shape="rect"/>Example 57: Defining the target location of a source content with the <a class="itsmarkup" href="#targetPointerRule" shape="rect">targetPointerRule</a>
+ the target node of a source node that is an element with children).</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-target-pointer-global-1" id="EX-target-pointer-global-1" shape="rect"/>Example 60: Defining the target location of a source content with the <a class="itsmarkup" href="#targetPointerRule" shape="rect">targetPointerRule</a>
element</div><div class="exampleInner"><pre xml:space="preserve">
<file
xmlns:its="http://www.w3.org/2005/11/its" >
@@ -1954,12 +2156,12 @@
<target/>
</entry>
</file></pre></div><p>[Source file: <a href="examples/xml/EX-target-pointer-global-1.xml" shape="rect">examples/xml/EX-target-pointer-global-1.xml</a>]</p></div></div><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="target-pointer-markup" id="target-pointer-markup" shape="rect"/>6.15.3 Markup Declarations for Target Pointer</h4><dl><dt class="label">targetPointerRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="targetPointerRule" id="targetPointerRule" shape="rect"/>[117] </td><td rowspan="1" colspan="1"><code>targetPointerRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="target-pointer-markup" id="target-pointer-markup" shape="rect"/>6.15.3 Markup Declarations for Target Pointer</h4><dl><dt class="label">targetPointerRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="targetPointerRule" id="targetPointerRule" shape="rect"/>[130] </td><td rowspan="1" colspan="1"><code>targetPointerRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
element its:targetPointerRule
{
targetPointerRule.content,
<a href="#targetPointerRule.attributes" shape="rect">targetPointerRule.attributes</a>
- }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="targetPointerRule.content" id="targetPointerRule.content" shape="rect"/>[118] </td><td rowspan="1" colspan="1"><code>targetPointerRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="targetPointerRule.attributes" id="targetPointerRule.attributes" shape="rect"/>[119] </td><td rowspan="1" colspan="1"><code>targetPointerRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="targetPointerRule.content" id="targetPointerRule.content" shape="rect"/>[131] </td><td rowspan="1" colspan="1"><code>targetPointerRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="targetPointerRule.attributes" id="targetPointerRule.attributes" shape="rect"/>[132] </td><td rowspan="1" colspan="1"><code>targetPointerRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
attribute targetPointer { string }</code></td></tr></tbody></table></dd></dl></div></div><div class="div2">
@@ -1973,7 +2175,7 @@
testing or debugging.</p></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><ul><li><p>The <a href="#idvalue" shape="rect">Id Value</a> data category only provides for rules
to be expressed at a global level. Locally, users are able to use
<code>xml:id</code> (which is defined by XML) or an attribute specific to the
- format in question (as in <a href="#EX-idvalue-attribute-1" shape="rect">Example 60</a>).</p></li><li><p>Applying the <a href="#idvalue" shape="rect">Id Value</a> data category to
+ format in question (as in <a href="#EX-idvalue-attribute-1" shape="rect">Example 63</a>).</p></li><li><p>Applying the <a href="#idvalue" shape="rect">Id Value</a> data category to
<code>xml:id</code> attributes using global rules is not necessary, since
<code>xml:id</code> is the recommended way to specify an identifier in
XML.</p></li></ul></div></div><div class="div3">
@@ -1982,7 +2184,7 @@
constructs a string corresponding to the identifier of the node to which this rule
applies should be located. The identifier <a href="#rfc-keywords" shape="rect">MUST</a> be
unique at least within the document. If the attribute <code>xml:id</code> is present for
- the selected node, the value of the <code>xml:id</code> attribute <a href="#rfc2119" shape="rect">MUST</a> take precedence over the <a class="itsmarkup" href="#idValueRule.attributes" shape="rect">idValue</a> value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-element-1" id="EX-idvalue-element-1" shape="rect"/>Example 58: Pointing to an ID value with the <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element</div><p>The <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element indicates that the unique identifier for each
+ the selected node, the value of the <code>xml:id</code> attribute <a href="#rfc2119" shape="rect">MUST</a> take precedence over the <a class="itsmarkup" href="#idValueRule.attributes" shape="rect">idValue</a> value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-element-1" id="EX-idvalue-element-1" shape="rect"/>Example 61: Pointing to an ID value with the <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element</div><p>The <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element indicates that the unique identifier for each
<code><text></code> element is the value of the attribute <code>name</code> of
its parent element.</p><div class="exampleInner"><pre xml:space="preserve">
<resources
@@ -2002,7 +2204,7 @@
<pos>2, 1</pos>
<trig>cancelAll</trig>
</entry>
-</resources></pre></div><p>[Source file: <a href="examples/xml/EX-idvalue-element-1.xml" shape="rect">examples/xml/EX-idvalue-element-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-element-2" id="EX-idvalue-element-2" shape="rect"/>Example 59: Constructing ID values using the <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element.</div><p>The <a class="itsmarkup" href="#idValueRule.attributes" shape="rect">idValue</a> attribute allows to build composite values based on different
+</resources></pre></div><p>[Source file: <a href="examples/xml/EX-idvalue-element-1.xml" shape="rect">examples/xml/EX-idvalue-element-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-element-2" id="EX-idvalue-element-2" shape="rect"/>Example 62: Constructing ID values using the <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element.</div><p>The <a class="itsmarkup" href="#idValueRule.attributes" shape="rect">idValue</a> attribute allows to build composite values based on different
attributes, element or event hard-coded text. Any of the String functions offered by
XPath can be used. In the document below, the two elements <code><text></code> and
<code><desc></code> are translatable, but they have only one corresponding
@@ -2022,7 +2224,7 @@
<desc>The module cannot find the default settings file.
You need to re-initialize the system.</desc>
</msg>
-</doc></pre></div><p>[Source file: <a href="examples/xml/EX-idvalue-element-2.xml" shape="rect">examples/xml/EX-idvalue-element-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-attribute-1" id="EX-idvalue-attribute-1" shape="rect"/>Example 60: Using <code>xml:id</code> and <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a>
+</doc></pre></div><p>[Source file: <a href="examples/xml/EX-idvalue-element-2.xml" shape="rect">examples/xml/EX-idvalue-element-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-attribute-1" id="EX-idvalue-attribute-1" shape="rect"/>Example 63: Using <code>xml:id</code> and <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a>
</div><p>When an <code>xml:id</code> attribute is present for a node selected by an
<a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element, the value of <code>xml:id</code> takes precedence over
the value defined by the <a class="itsmarkup" href="#idValueRule" shape="rect">idValueRule</a> element. In the example below, the unique
@@ -2036,8 +2238,8 @@
<res name="retryBtn" xml:id="btnAgain">Try Again</res>
<res name="retryTip">click this to re-run the process with the current settings.</res>
</file></pre></div><p>[Source file: <a href="examples/xml/EX-idvalue-attribute-1.xml" shape="rect">examples/xml/EX-idvalue-attribute-1.xml</a>]</p></div></div><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="idvalue-markup" id="idvalue-markup" shape="rect"/>6.16.3 Markup Declarations for Id Value</h4><dl><dt class="label">idValueRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="idValueRule" id="idValueRule" shape="rect"/>[120] </td><td rowspan="1" colspan="1"><code>idValueRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
- element its:idValueRule { idValueRule.content, <a href="#idValueRule.attributes" shape="rect">idValueRule.attributes</a> }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="idValueRule.content" id="idValueRule.content" shape="rect"/>[121] </td><td rowspan="1" colspan="1"><code>idValueRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="idValueRule.attributes" id="idValueRule.attributes" shape="rect"/>[122] </td><td rowspan="1" colspan="1"><code>idValueRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="idvalue-markup" id="idvalue-markup" shape="rect"/>6.16.3 Markup Declarations for Id Value</h4><dl><dt class="label">idValueRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="idValueRule" id="idValueRule" shape="rect"/>[133] </td><td rowspan="1" colspan="1"><code>idValueRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ element its:idValueRule { idValueRule.content, <a href="#idValueRule.attributes" shape="rect">idValueRule.attributes</a> }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="idValueRule.content" id="idValueRule.content" shape="rect"/>[134] </td><td rowspan="1" colspan="1"><code>idValueRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="idValueRule.attributes" id="idValueRule.attributes" shape="rect"/>[135] </td><td rowspan="1" colspan="1"><code>idValueRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>, attribute idValue { string }</code></td></tr></tbody></table></dd></dl></div></div><div class="div2">
<h3><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="preservespace" id="preservespace" shape="rect"/>6.17 Preserve Space</h3><div class="div3">
<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="preservespace-definition" id="preservespace-definition" shape="rect"/>6.17.1 Definition</h4><p>The <a href="preservespace" shape="rect">Preserve Space</a> data category indicates how whitespace
@@ -2046,7 +2248,7 @@
xml:space attribute. The default value is "default".</p></div><div class="div3">
<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="preservespace-implementation" id="preservespace-implementation" shape="rect"/>6.17.2 Implementation</h4><p>The <a href="preservespace" shape="rect">Preserve Space</a> data category can be expressed with
global rules, or locally using the <code>xml:space</code> attribute.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The <a href="preservespace" shape="rect">Preserve Space</a> data category is not applicable to
- HTML5 documents because <code>xml:space</code> (and by extension <a href="preservespace" shape="rect">Preserve Space</a>) has no effect in documents parsed as text/html.</p></div><p>GLOBAL: The <a class="itsmarkup" href="#preserveSpaceRule" shape="rect">preserveSpaceRule</a> element contains the following:</p><ul><li><p>A required <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <a class="itsmarkup" href="#preserveSpaceRule.attributes" shape="rect">space</a> attribute with the value "default" or "preserve".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-perservespace-global-1" id="EX-perservespace-global-1" shape="rect"/>Example 61: The <a href="preservespace" shape="rect">Preserve Space</a> data category expressed
+ HTML5 documents because <code>xml:space</code> (and by extension <a href="preservespace" shape="rect">Preserve Space</a>) has no effect in documents parsed as text/html.</p></div><p>GLOBAL: The <a class="itsmarkup" href="#preserveSpaceRule" shape="rect">preserveSpaceRule</a> element contains the following:</p><ul><li><p>A required <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <a class="itsmarkup" href="#preserveSpaceRule.attributes" shape="rect">space</a> attribute with the value "default" or "preserve".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-perservespace-global-1" id="EX-perservespace-global-1" shape="rect"/>Example 64: The <a href="preservespace" shape="rect">Preserve Space</a> data category expressed
globally</div><p>The preserveSpaceRule element specifies that whitespace in all verse elements must be
treated literally.</p><div class="exampleInner"><pre xml:space="preserve">
<book
@@ -2057,14 +2259,14 @@
<its:preserveSpaceRule selector="//verse" space="preserve"/>
</its:rules>
</info>
- <verse xml:space="preserve">
+ <verse>
’Twas brillig, and the slithy toves
Did gyre and gimble in the wabe;
All mimsy were the borogoves,
And the mome raths outgrabe.
</verse>
</book></pre></div><p>[Source file: <a href="examples/xml/EX-preservespace-global-1.xml" shape="rect">examples/xml/EX-preservespace-global-1.xml</a>]</p></div><p>LOCAL: The <code>xml:space</code> attribute, as defined in section 2.10 of <a title="Extensible Markup Language (XML)
								1.0 (Fourth Edition)" href="#xml10spec" shape="rect">[XML 1.0]</a>, maps exactly to the Preserve Space data
- category.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-perservespace-local-1" id="EX-perservespace-local-1" shape="rect"/>Example 62: The <a href="preservespace" shape="rect">Preserve Space</a> data category expressed
+ category.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-perservespace-local-1" id="EX-perservespace-local-1" shape="rect"/>Example 65: The <a href="preservespace" shape="rect">Preserve Space</a> data category expressed
locally</div><p>The standard <code>xml:space</code> attribute specifies that the whitespace in the verse
element must be treated literally.</p><div class="exampleInner"><pre xml:space="preserve">
<book
@@ -2077,12 +2279,12 @@
And the mome raths outgrabe.
</verse>
</book></pre></div><p>[Source file: <a href="examples/xml/EX-preservespace-local-1.xml" shape="rect">examples/xml/EX-preservespace-local-1.xml</a>]</p></div></div><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="preservespace-markup" id="preservespace-markup" shape="rect"/>6.17.3 Markup Declarations for Preserve Space</h4><dl><dt class="label">preserveSpaceRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule" id="preserveSpaceRule" shape="rect"/>[123] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="preservespace-markup" id="preservespace-markup" shape="rect"/>6.17.3 Markup Declarations for Preserve Space</h4><dl><dt class="label">preserveSpaceRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule" id="preserveSpaceRule" shape="rect"/>[136] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
element its:preserveSpaceRule
{
preserveSpaceRule.content,
<a href="#preserveSpaceRule.attributes" shape="rect">preserveSpaceRule.attributes</a>
- }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule.content" id="preserveSpaceRule.content" shape="rect"/>[124] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule.attributes" id="preserveSpaceRule.attributes" shape="rect"/>[125] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule.content" id="preserveSpaceRule.content" shape="rect"/>[137] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule.attributes" id="preserveSpaceRule.attributes" shape="rect"/>[138] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
attribute space { "default" | "preserve" }</code></td></tr></tbody></table></dd></dl></div></div></div></div><div class="back"><div class="div1">
@@ -2349,7 +2551,7 @@
<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="its-schematron-constraints" id="its-schematron-constraints" shape="rect"/>E Checking ITS Markup Constraints With Schematron (Non-Normative)</h2><p>
<em>This section is informative.</em>
</p><p>Several constraints of ITS markup cannot be validated with ITS schemas. The following <a title="Rule-based validation -- Schematron" href="#schematron" shape="rect">[Schematron]</a> document allows for validating some of these
- constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e7397" id="d3e7397" shape="rect"/>Example 63: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve">
+ constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e7790" id="d3e7790" shape="rect"/>Example 66: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve">
<sch:schema
xmlns:sch="http://www.ascc.net/xml/schematron" >
<!-- Schematron document to test constraints for global and local ITS markup.
@@ -2416,7 +2618,7 @@
<em>This section is informative.</em>
</p><p>The following <a title="Namespace-based Validation Dispatching Language (NVDL)" href="#nvdl" shape="rect">[NVDL]</a> document allows validation of ITS markup which has
been added to a host vocabulary. Only ITS elements and attributes are checked. Elements and
- attributes of host language are ignored during validation against this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e7419" id="d3e7419" shape="rect"/>Example 64: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><rules xmlns="http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"> <namespace
+ attributes of host language are ignored during validation against this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e7812" id="d3e7812" shape="rect"/>Example 67: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><rules xmlns="http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"> <namespace
ns="http://www.w3.org/2005/11/its"> <validate schema="its-elements.rng"/>
</namespace> <namespace ns="http://www.w3.org/2005/11/its" match="attributes">
<validate schema="its-attributes.rng"/> </namespace> <anyNamespace>
Received on Saturday, 18 August 2012 23:07:39 UTC