- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Wed, 27 Mar 2013 18:19:56 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20 In directory gil:/tmp/cvs-serv26307 Modified Files: its20.html its20.odd Added Files: its20-before-issue-113-edits.html Removed Files: its20-before-20121203-call.html Log Message: eddits for issue-113 from david and added a DIFF for previous version --- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/03/25 11:04:28 1.354 +++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/03/27 18:19:56 1.355 @@ -49,6 +49,7 @@ <div class="toc2">3.5 <a href="#def-rule-elements" shape="rect">Rule Elements</a></div> <div class="toc2">3.6 <a href="#iri-usage" shape="rect">Usage of Internationalized Resource Identifiers in ITS</a></div> <div class="toc2">3.7 <a href="#def-html" shape="rect">The Term HTML</a></div> +<div class="toc2">3.8 <a href="#def-css-selector" shape="rect">The Term CSS Selectors</a></div> </div> <div class="toc1">4 <a href="#conformance" shape="rect">Conformance</a><div class="toc2">4.1 <a href="#conformance-product-schema" shape="rect">Conformance Type 1: ITS Markup Declarations</a></div> <div class="toc2">4.2 <a href="#conformance-product-processing-expectations" shape="rect">Conformance Type 2: The Processing Expectations for ITS Markup</a></div> @@ -60,9 +61,9 @@ <div class="toc3">5.2.2 <a href="#selection-local" shape="rect">Local Selection in an XML Document</a></div> </div> <div class="toc2">5.3 <a href="#selectors" shape="rect">Query Language of Selectors</a><div class="toc3">5.3.1 <a href="#queryLanguage" shape="rect">Choosing Query Language</a></div> -<div class="toc3">5.3.2 <a href="#d0e2041" shape="rect">XPath 1.0</a></div> +<div class="toc3">5.3.2 <a href="#d0e2076" shape="rect">XPath 1.0</a></div> <div class="toc3">5.3.3 <a href="#css-selectors" shape="rect">CSS Selectors</a></div> -<div class="toc3">5.3.4 <a href="#d0e2271" shape="rect">Additional query languages</a></div> +<div class="toc3">5.3.4 <a href="#d0e2318" shape="rect">Additional query languages</a></div> <div class="toc3">5.3.5 <a href="#its-param" shape="rect">Variables in selectors</a></div> </div> <div class="toc2">5.4 <a href="#link-external-rules" shape="rect">Link to External Rules</a></div> @@ -157,9 +158,8 @@ concepts (such as “Translate”) that are important for internationalization and localization, and defines implementations of these concepts (termed “ITS data categories”) as a set of elements and attributes called the <em>Internationalization Tag Set - (ITS)</em>. The document provides implementations for HTML, serializations in <a href="http://nlp2rdf.org/nif-1-0" shape="rect">NIF</a>, and provides definitions of ITS elements - and attributes in the form of XML Schema <a title="XML Schema Part 1:
 Structures Second Edition" href="#xmlschema1" shape="rect">[XML Schema]</a> and - RELAX NG <a title="Regular-grammar-based validation -- RELAX NG" href="#relaxng" shape="rect">[RELAX NG]</a>.</p><p>This document aims to realize many of the ideas formulated in the <a href="http://www.w3.org/TR/2012/WD-its2req-20120524/" shape="rect">ITS 2.0 Requirements + (ITS)</em>. The document provides implementations for HTML, serializations in <a href="http://nlp2rdf.org/nif-1-0" shape="rect">NIF (NLP Interchange Format)</a>, and provides definitions of + ITS elements and attributes in the form of XML Schema <a title="XML Schema Part 1:
 Structures Second Edition" href="#xmlschema1" shape="rect">[XML Schema]</a> and RELAX NG <a title="Regular-grammar-based validation -- RELAX NG" href="#relaxng" shape="rect">[RELAX NG]</a>.</p><p>This document aims to realize many of the ideas formulated in the <a href="http://www.w3.org/TR/2012/WD-its2req-20120524/" shape="rect">ITS 2.0 Requirements document</a>, in <a title="Internationalization and
 Localization Markup Requirements" href="#itsreq" shape="rect">[ITS REQ]</a> and <a title="Requirements for Localizable
 DTD Design" href="#reqlocdtd" shape="rect">[Localizable DTDs]</a>.</p><p>Not all requirements listed there are addressed in this document. Those which are not addressed here are either covered in <a title="Best
 Practices for XML Internationalization" href="#xml-i18n-bp" shape="rect">[XML i18n BP]</a> (potentially in an as yet unwritten best practice document on multilingual Web content), @@ -174,8 +174,8 @@ <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="new-principles" id="new-principles" shape="rect"/>1.1.2 New Principles</h4><p>ITS 2.0 also adds the following principles and features not found in ITS 1.0:</p><ul><li><p>ITS 2.0 data categories are intended to be format neutral, with support for XML, HTML, and NIF: a data category implementation only needs to support a single 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 NIF out of HTML 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 + metadata.</p></li><li><p>A global implementation of ITS 2.0 requires at least the <a href="#xpath" shape="rect">XPath version 1.0</a>. + 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 id="its20-new-data-categories">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="#externalresource" shape="rect">External Resource</a></p></li><li><p><a href="#target-pointer" shape="rect">Target Pointer</a></p></li><li><p><a href="#idvalue" shape="rect">Id Value</a></p></li><li><p><a href="#preservespace" shape="rect">Preserve Space</a></p></li><li><p><a href="#lqissue" shape="rect">Localization Quality Issue</a></p></li><li><p><a href="#lqrating" shape="rect">Localization Quality Rating</a></p></li><li><p><a href="#mtconfidence" shape="rect">MT Confidence</a></p></li><li><p><a href="#allowedchars" shape="rect">Allowed Characters</a></p></li><li><p><a href="#storagesize" shape="rect">Storage Size</a></p></li></ul></div></div><div class="div2"> @@ -191,8 +191,8 @@ design and development, and the corresponding process is referred to as internationalization. For a detailed explanation of the terms “localization” and “internationalization”, see <a title="" href="#geo-i18n-l10n" shape="rect">[l10n i18n]</a>.</p><span class="editor-note">[Ed. note: Note: This should refer to the best practice document as well, when - ready.]</span><p>The increasing usage of XML as a medium for documentation-related content (e.g. DocBook - and DITA as formats for writing structured documentation, well suited to computer + ready.]</span><p>The increasing usage of XML as a medium for documentation-related content (e.g. <a href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook#technical" shape="rect">DocBook</a>> + and <a href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita#technical" shape="rect">DITA</a> as formats for writing structured documentation, well suited to computer hardware and software manuals) and software-related content (e.g. the eXtensible User Interface Language <a title="exTensible User Interface Language" href="#xul" shape="rect">[XUL]</a>) creates challenges and opportunities in the domain of XML internationalization and localization.</p><div class="div3"> @@ -201,46 +201,46 @@ identifies which parts of an XML document need to be translated. Tools often cannot automatically perform this identification.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-motivation-its-1" id="EX-motivation-its-1" shape="rect"/>Example 1: Document with partially translatable content</div><p>In this document it is difficult to distinguish between those <code>string</code> elements that are translatable and those that are not. Only the addition of an - explicit flag could resolve the issue.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><resources></strong>
 - <strong class="hl-tag" style="color: #000096"><section</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"Homepage"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><arguments></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>page<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>childlist<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"></arguments></strong>
 - <strong class="hl-tag" style="color: #000096"><variables></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>POLICY<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>Corporate Policy<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"></variables></strong>
 - <strong class="hl-tag" style="color: #000096"><keyvalue_pairs></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>Page<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>ABC Corporation - Policy Repository<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>Footer_Last<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>Pages<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>bgColor<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>NavajoWhite<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>title<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"><string></strong>List of Available Policies<strong class="hl-tag" style="color: #000096"></string></strong>
 - <strong class="hl-tag" style="color: #000096"></keyvalue_pairs></strong>
 - <strong class="hl-tag" style="color: #000096"></section></strong>
 -<strong class="hl-tag" style="color: #000096"></resources></strong>
 + explicit flag could resolve the issue.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><resources></strong> + <strong class="hl-tag" style="color: #000096"><section</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"Homepage"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><arguments></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>page<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>childlist<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"></arguments></strong> + <strong class="hl-tag" style="color: #000096"><variables></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>POLICY<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>Corporate Policy<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"></variables></strong> + <strong class="hl-tag" style="color: #000096"><keyvalue_pairs></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>Page<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>ABC Corporation - Policy Repository<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>Footer_Last<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>Pages<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>bgColor<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>NavajoWhite<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>title<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"><string></strong>List of Available Policies<strong class="hl-tag" style="color: #000096"></string></strong> + <strong class="hl-tag" style="color: #000096"></keyvalue_pairs></strong> + <strong class="hl-tag" style="color: #000096"></section></strong> +<strong class="hl-tag" style="color: #000096"></resources></strong> </pre></div><p>[Source file: <a href="examples/xml/EX-motivation-its-1.xml" shape="rect">examples/xml/EX-motivation-its-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-motivation-its-2" id="EX-motivation-its-2" shape="rect"/>Example 2: Document with partially translatable content</div><p>Even when metadata are available to identify non-translatable text, the conditions may be quite complex and not directly indicated with a simple flag. Here, for instance, only the text in the nodes matching the expression - <code>//component[@type!='image']/data[@type='text']</code> is translatable.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><dialogue</strong> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en-gb"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><rsrc</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"123"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"456"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"image"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>images/cancel.gif<strong class="hl-tag" style="color: #000096"></data></strong>
 - <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"position"</span><strong class="hl-tag" style="color: #000096">></strong>12,20<strong class="hl-tag" style="color: #000096"></data></strong>
 - <strong class="hl-tag" style="color: #000096"></component></strong>
 - <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"789"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"caption"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Cancel<strong class="hl-tag" style="color: #000096"></data></strong>
 - <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"position"</span><strong class="hl-tag" style="color: #000096">></strong>60,40<strong class="hl-tag" style="color: #000096"></data></strong>
 - <strong class="hl-tag" style="color: #000096"></component></strong>
 - <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"792"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"string"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Number of files: <strong class="hl-tag" style="color: #000096"></data></strong>
 - <strong class="hl-tag" style="color: #000096"></component></strong>
 - <strong class="hl-tag" style="color: #000096"></rsrc></strong>
 -<strong class="hl-tag" style="color: #000096"></dialogue></strong>
 + <code>//component[@type!='image']/data[@type='text']</code> is translatable.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><dialogue</strong> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en-gb"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><rsrc</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"123"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"456"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"image"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>images/cancel.gif<strong class="hl-tag" style="color: #000096"></data></strong> + <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"position"</span><strong class="hl-tag" style="color: #000096">></strong>12,20<strong class="hl-tag" style="color: #000096"></data></strong> + <strong class="hl-tag" style="color: #000096"></component></strong> + <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"789"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"caption"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Cancel<strong class="hl-tag" style="color: #000096"></data></strong> + <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"position"</span><strong class="hl-tag" style="color: #000096">></strong>60,40<strong class="hl-tag" style="color: #000096"></data></strong> + <strong class="hl-tag" style="color: #000096"></component></strong> + <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"792"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"string"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Number of files: <strong class="hl-tag" style="color: #000096"></data></strong> + <strong class="hl-tag" style="color: #000096"></component></strong> + <strong class="hl-tag" style="color: #000096"></rsrc></strong> +<strong class="hl-tag" style="color: #000096"></dialogue></strong> </pre></div><p>[Source file: <a href="examples/xml/EX-motivation-its-2.xml" shape="rect">examples/xml/EX-motivation-its-2.xml</a>]</p></div></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="users-usage" id="users-usage" shape="rect"/>1.3 Users and Usages of ITS</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="potential-users" id="potential-users" shape="rect"/>1.3.1 Potential Users of ITS</h4><p>The ITS specification aims to provide different types of users with information about @@ -302,19 +302,18 @@ third party users, for example, provenance information and quality scoring, and add relevant information for follow-on tasks, processes and services, such as MT post-editing, MT training and MT terminological enhancement.</p></div><div class="div4"> -<h5><a name="users_text_analytics" id="users_text_analytics" shape="rect"/>1.3.1.6 Text Analytics</h5><p>These types of users fulfil the role of providing services for automatic generation - of metadata for improving localization, data integration or knowledge management - workflows. This class of users comprises of developers and integrators of services - that automate language technology tasks such as domain classification, named entity - recognition and disambiguation, term extraction, language identification and others. - Text analytics services generate data that contextualizes the raw content with more - explicit information. This can be used to improve the output quality in machine - translation systems, search result relevance in information retrieval systems, as - well as management and integration of unstructured data in knowledge management - systems.</p></div><div class="div4"> +<h5><a name="users_text_analytics" id="users_text_analytics" shape="rect"/>1.3.1.6 Text Analytics</h5><p>This type of services provides automatically generated metadata for improving + localization, data integration or knowledge management workflows. This class of + users comprises of developers and integrators of services that automate language + technology tasks such as domain classification, named entity recognition and + disambiguation, term extraction, language identification and others. Text analytics + services generate data that contextualizes the raw content with more explicit + information. This can be used to improve the output quality in machine translation + systems, search result relevance in information retrieval systems, as well as + management and integration of unstructured data in knowledge management systems.</p></div><div class="div4"> <h5><a name="users_localization_workflow_managers" id="users_localization_workflow_managers" shape="rect"/>1.3.1.7 Localization Workflow Managers</h5><p>These types of users are concerned with localization workflows in which content goes through certain steps: preparation for localization, start of the localization - process by e.g. a conversion into a bitext format like <a title="" href="#xliff" shape="rect">[XLIFF]</a>, the actual localization by human translators or machine + process by e.g. a conversion into a bitext (aligned parallel text) format like <a title="" href="#xliff" shape="rect">[XLIFF]</a>, the actual localization by human translators or machine translation and other adaptations of content, and finally the integration of the localized content into the original format. That format is often based on XML or HTML; (Web) content management systems are widely used for content creation, and @@ -334,102 +333,102 @@ illustration, we will demonstrate how ITS can indicate that certain parts of content should or should not be translated.</p><ul><li><p>A content author uses an attribute on a particular element to say that the text in the element should not be translated.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-1" id="EX-ways-to-use-its-1" shape="rect"/>Example 3: Use of ITS by content author</div><p>The <code>its:translate="no"</code> attributes indicate that the <code>path</code> - and the <code>cmd</code> elements should not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><head></strong>
 - <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong>
 - <strong class="hl-tag" style="color: #000096"></head></strong>
 - <strong class="hl-tag" style="color: #000096"><body></strong>
 - <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the <strong class="hl-tag" style="color: #000096"><path</strong>
 - <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run
 - batch file <strong class="hl-tag" style="color: #000096"><cmd</strong> <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
 - <strong class="hl-tag" style="color: #000096"></body></strong>
 -<strong class="hl-tag" style="color: #000096"></help></strong>
 + and the <code>cmd</code> elements should not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><head></strong> + <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong> + <strong class="hl-tag" style="color: #000096"></head></strong> + <strong class="hl-tag" style="color: #000096"><body></strong> + <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the <strong class="hl-tag" style="color: #000096"><path</strong> + <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run + batch file <strong class="hl-tag" style="color: #000096"><cmd</strong> <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></strong>.<strong class="hl-tag" style="color: #000096"></p></strong> + <strong class="hl-tag" style="color: #000096"></body></strong> +<strong class="hl-tag" style="color: #000096"></help></strong> </pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-1.xml" shape="rect">examples/xml/EX-ways-to-use-its-1.xml</a>]</p></div><ul><li><p>A content author or information architect uses markup at the top of the document to identify a particular type of element or context in which the content should not be translated.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-2" id="EX-ways-to-use-its-2" shape="rect"/>Example 4: Use of ITS by information architect</div><p>The <code class="its-elem-markup">translateRule</code> element is used in the header of the document to indicate that none of the <code>path</code> or <code>cmd</code> elements should be - translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><head></strong>
 - <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong>
 - <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></its:rules></strong>
 - <strong class="hl-tag" style="color: #000096"></head></strong>
 - <strong class="hl-tag" style="color: #000096"><body></strong>
 - <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the
 - <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file
 - <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
 - <strong class="hl-tag" style="color: #000096"></body></strong>
 -<strong class="hl-tag" style="color: #000096"></help></strong>
 + translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><head></strong> + <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong> + <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></its:rules></strong> + <strong class="hl-tag" style="color: #000096"></head></strong> + <strong class="hl-tag" style="color: #000096"><body></strong> + <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the + <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file + <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></strong>.<strong class="hl-tag" style="color: #000096"></p></strong> + <strong class="hl-tag" style="color: #000096"></body></strong> +<strong class="hl-tag" style="color: #000096"></help></strong> </pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-2.xml" shape="rect">examples/xml/EX-ways-to-use-its-2.xml</a>]</p></div><ul><li><p>A processor may insert markup at the top of the document which links to ITS information outside of the document.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-3" id="EX-ways-to-use-its-3" shape="rect"/>Example 5: Use of ITS by processor</div><p>A <code class="its-elem-markup">rules</code> element is inserted in the header of the document. It has a XLink - <code class="its-attr-markup">href</code> attribute used to link to an <a href="#link-external-rules" shape="rect">ITS external rule</a> document.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><head></strong>
 - <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong>
 - <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span>
 - <span class="hl-attribute" style="color: #F5844C">xmlns:xlink</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xlink"</span> <span class="hl-attribute" style="color: #F5844C">xlink:href</span>=<span class="hl-value" style="color: #993300">"EX-ways-to-use-its-4.xml"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></head></strong>
 - <strong class="hl-tag" style="color: #000096"><body></strong>
 - <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the
 - <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file
 - <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
 - <strong class="hl-tag" style="color: #000096"></body></strong>
 -<strong class="hl-tag" style="color: #000096"></help></strong>
 + <code class="its-attr-markup">href</code> attribute used to link to an <a href="#link-external-rules" shape="rect">ITS external rule</a> document.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><head></strong> + <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong> + <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> + <span class="hl-attribute" style="color: #F5844C">xmlns:xlink</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xlink"</span> <span class="hl-attribute" style="color: #F5844C">xlink:href</span>=<span class="hl-value" style="color: #993300">"EX-ways-to-use-its-4.xml"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></head></strong> + <strong class="hl-tag" style="color: #000096"><body></strong> + <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the + <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file + <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></strong>.<strong class="hl-tag" style="color: #000096"></p></strong> + <strong class="hl-tag" style="color: #000096"></body></strong> +<strong class="hl-tag" style="color: #000096"></help></strong> </pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-3.xml" shape="rect">examples/xml/EX-ways-to-use-its-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-4" id="EX-ways-to-use-its-4" shape="rect"/>Example 6: ITS rule file shared by different documents</div><p>The <code class="its-elem-markup">rules</code> element contains several ITS rules that are common to different documents. One of them is a <code class="its-elem-markup">translateRule</code> element that indicates that no - <code>path</code> or <code>cmd</code> element should be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong>
 -<strong class="hl-tag" style="color: #000096"></its:rules></strong>
 + <code>path</code> or <code>cmd</code> element should be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong> +<strong class="hl-tag" style="color: #000096"></its:rules></strong> </pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-4.xml" shape="rect">examples/xml/EX-ways-to-use-its-4.xml</a>]</p></div><ul><li><p>A schema developer integrates ITS markup declarations in his schema to allow users to indicate that specific parts of the content should not be translated.</p></li></ul><span class="editor-note">[Ed. note: Following schema example has to updated once we have final XSD schema for ITS 2.0]</span><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-5" id="EX-ways-to-use-its-5" shape="rect"/>Example 7: An XSD schema with ITS declaration</div><p>The declarations for the <code class="its-attr-markup">translate</code> attribute is added to a - group of common attributes <code>commonAtts</code>. This allows to use the <code class="its-attr-markup">translate</code> attribute within the documents like in <a href="#EX-ways-to-use-its-1" shape="rect">Example 3</a>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><xs:schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:xs</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2001/XMLSchema"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span>
 - <span class="hl-attribute" style="color: #F5844C">elementFormDefault</span>=<span class="hl-value" style="color: #993300">"qualified"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:import</strong> <span class="hl-attribute" style="color: #F5844C">namespace</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">schemaLocation</span>=<span class="hl-value" style="color: #993300">"its.xsd"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.local.with-ns.attribute.translate"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"id"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:ID"</span> <span class="hl-attribute" style="color: #F5844C">use</span>=<span class="hl-value" style="color: #993300">"optional"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:attributeGroup></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"help"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:sequence></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"head"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:sequence></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"title"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:string"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:sequence></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:element></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"body"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"1"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"p"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"0"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:choice></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:element></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:choice></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:element></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:sequence></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.version.attribute.version"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:element></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:element></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
 - <strong class="hl-tag" style="color: #000096"></xs:element></strong>
 + group of common attributes <code>commonAtts</code>. This allows to use the <code class="its-attr-markup">translate</code> attribute within the documents like in <a href="#EX-ways-to-use-its-1" shape="rect">Example 3</a>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><xs:schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:xs</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2001/XMLSchema"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> + <span class="hl-attribute" style="color: #F5844C">elementFormDefault</span>=<span class="hl-value" style="color: #993300">"qualified"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:import</strong> <span class="hl-attribute" style="color: #F5844C">namespace</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">schemaLocation</span>=<span class="hl-value" style="color: #993300">"its.xsd"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.local.with-ns.attribute.translate"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"><xs:attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"id"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:ID"</span> <span class="hl-attribute" style="color: #F5844C">use</span>=<span class="hl-value" style="color: #993300">"optional"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:attributeGroup></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"help"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"><xs:sequence></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"head"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"><xs:sequence></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"title"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:string"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:sequence></strong> + <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"></xs:element></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"body"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"1"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"p"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"0"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:choice></strong> + <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"></xs:element></strong> + <strong class="hl-tag" style="color: #000096"></xs:choice></strong> + <strong class="hl-tag" style="color: #000096"></xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"></xs:element></strong> + <strong class="hl-tag" style="color: #000096"></xs:sequence></strong> + <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.version.attribute.version"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"></xs:element></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"></xs:element></strong> + <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"></xs:complexType></strong> + <strong class="hl-tag" style="color: #000096"></xs:element></strong> <strong class="hl-tag" style="color: #000096"></xs:schema></strong></pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-5.xsd" shape="rect">examples/xml/EX-ways-to-use-its-5.xsd</a>]</p></div><p>The first two approaches above can be likened to the use of CSS in <a title="XHTML™ 1.0 The Extensible
 HyperText Markup Language (Second Edition)" href="#xhtml10" shape="rect">[XHTML 1.0]</a>. Using a <code>style</code> attribute, an XHTML content author may assign a color to a particular paragraph. That author could also have used the <code>style</code> element at the top of the page to say that all @@ -440,25 +439,25 @@ approach</a>” in HTML, this specification defines a link type for referring to files with global rules in <a class="section-ref" href="#html5-global-rules" shape="rect">Section 6.2: Global rules</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5-global-1" id="EX-translate-html5-global-1" shape="rect"/>Example 8: Using ITS global rules in HTML</div><p>The <code>link</code> element points to the rules file <code>EX-translateRule-html5-1.xml</code> The <code>rel</code> attribute identifies - the ITS specific link relation <code>its-rules</code>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
 -<strong class="hl-tag" style="color: #000096"><html></strong>
 - <strong class="hl-tag" style="color: #000096"><head></strong>
 - <strong class="hl-tag" style="color: #000096"><meta</strong> <span class="hl-attribute" style="color: #F5844C">charset</span>=<span class="hl-value" style="color: #993300">utf-8</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><title></strong>Translate flag global rules example<strong class="hl-tag" style="color: #000096"></title></strong>
 - <strong class="hl-tag" style="color: #000096"><link</strong> <span class="hl-attribute" style="color: #F5844C">href</span>=<span class="hl-value" style="color: #993300">EX-translateRule-html5-1.xml</span> <span class="hl-attribute" style="color: #F5844C">rel</span>=<span class="hl-value" style="color: #993300">its-rules</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"></head></strong>
 - <strong class="hl-tag" style="color: #000096"><body></strong>
 - <strong class="hl-tag" style="color: #000096"><p></strong>This sentence should be translated, but code names like the <strong class="hl-tag" style="color: #000096"><code></strong>span<strong class="hl-tag" style="color: #000096"></code></strong> element should not be translated.
 - Of course there are always exceptions: certain code values should be translated,
 - e.g. to a value in your language like <strong class="hl-tag" style="color: #000096"><code</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">yes</span><strong class="hl-tag" style="color: #000096">></strong>warning<strong class="hl-tag" style="color: #000096"></code></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
 - <strong class="hl-tag" style="color: #000096"></body></strong>
 -<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-translate-html5-global-1.html" shape="rect">examples/html5/EX-translate-html5-global-1.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5-global-1-rules-file" id="EX-translate-html5-global-1-rules-file" shape="rect"/>Example 9: ITS rules file linked from HTML</div><p>The rules file linked in <a href="#EX-translate-html5-global-1" shape="rect">Example 8</a>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span>
 - <span class="hl-attribute" style="color: #F5844C">xmlns:h</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xhtml"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//h:code"</span><strong class="hl-tag" style="color: #000096">/></strong>
 -<strong class="hl-tag" style="color: #000096"></its:rules></strong>
 + the ITS specific link relation <code>its-rules</code>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong> +<strong class="hl-tag" style="color: #000096"><html></strong> + <strong class="hl-tag" style="color: #000096"><head></strong> + <strong class="hl-tag" style="color: #000096"><meta</strong> <span class="hl-attribute" style="color: #F5844C">charset</span>=<span class="hl-value" style="color: #993300">utf-8</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><title></strong>Translate flag global rules example<strong class="hl-tag" style="color: #000096"></title></strong> + <strong class="hl-tag" style="color: #000096"><link</strong> <span class="hl-attribute" style="color: #F5844C">href</span>=<span class="hl-value" style="color: #993300">EX-translateRule-html5-1.xml</span> <span class="hl-attribute" style="color: #F5844C">rel</span>=<span class="hl-value" style="color: #993300">its-rules</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"></head></strong> + <strong class="hl-tag" style="color: #000096"><body></strong> + <strong class="hl-tag" style="color: #000096"><p></strong>This sentence should be translated, but code names like the <strong class="hl-tag" style="color: #000096"><code></strong>span<strong class="hl-tag" style="color: #000096"></code></strong> element should not be translated. + Of course there are always exceptions: certain code values should be translated, + e.g. to a value in your language like <strong class="hl-tag" style="color: #000096"><code</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">yes</span><strong class="hl-tag" style="color: #000096">></strong>warning<strong class="hl-tag" style="color: #000096"></code></strong>.<strong class="hl-tag" style="color: #000096"></p></strong> + <strong class="hl-tag" style="color: #000096"></body></strong> +<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-translate-html5-global-1.html" shape="rect">examples/html5/EX-translate-html5-global-1.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5-global-1-rules-file" id="EX-translate-html5-global-1-rules-file" shape="rect"/>Example 9: ITS rules file linked from HTML</div><p>The rules file linked in <a href="#EX-translate-html5-global-1" shape="rect">Example 8</a>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> + <span class="hl-attribute" style="color: #F5844C">xmlns:h</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xhtml"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//h:code"</span><strong class="hl-tag" style="color: #000096">/></strong> +<strong class="hl-tag" style="color: #000096"></its:rules></strong> </pre></div><p>[Source file: <a href="examples/html5/EX-translateRule-html5-1.xml" shape="rect">examples/html5/EX-translateRule-html5-1.xml</a>]</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="usage-in-legacy-html" id="usage-in-legacy-html" shape="rect"/>1.4.1 Support for legacy HTML content</h4><p>ITS 2.0 does not define how to use ITS in HTML versions prior version 5. Users are - encouraged to migrate their content to HTML or XHTML. While it is possible to use + encouraged to migrate their content to HTML5 or XHTML. While it is possible to use <code>its-*</code> attributes introduced for HTML5 in older versions of HTML (such as 3.2 or 4.01) and pages using these attributes will work without any problems, [7056 lines skipped] --- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2013/03/25 11:04:28 1.347 +++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2013/03/27 18:19:56 1.348 @@ -148,9 +148,9 @@ localization, and defines implementations of these concepts (termed “ITS data categories”) as a set of elements and attributes called the <emph>Internationalization Tag Set (ITS)</emph>. The document provides implementations for HTML, serializations in <ref - target="http://nlp2rdf.org/nif-1-0">NIF</ref>, and provides definitions of ITS elements - and attributes in the form of XML Schema <ptr target="#xmlschema1" type="bibref"/> and - RELAX NG <ptr target="#relaxng" type="bibref"/>.</p> + target="http://nlp2rdf.org/nif-1-0">NIF (NLP Interchange Format)</ref>, and provides definitions of + ITS elements and attributes in the form of XML Schema <ptr target="#xmlschema1" + type="bibref"/> and RELAX NG <ptr target="#relaxng" type="bibref"/>.</p> <p>This document aims to realize many of the ideas formulated in the <ref target="http://www.w3.org/TR/2012/WD-its2req-20120524/">ITS 2.0 Requirements @@ -194,8 +194,8 @@ format mapping in order to support a claim of ITS 2.0 conformance.</item> <item>ITS 2.0 provides algorithms to generate NIF out of HTML or XML with ITS 2.0 metadata.</item> - <item>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 + <item>A global implementation of ITS 2.0 requires at least the <ref target="#xpath">XPath version 1.0</ref>. + Other versions of XPath or other query languages (e.g., CSS Selectors) can be expressed via a dedicated <ref target="#queryLanguage">queryLanguage</ref> attribute.</item> </list> @@ -237,8 +237,8 @@ “internationalization”, see <ptr target="#geo-i18n-l10n" type="bibref"/>.</p> <note type="ed">Note: This should refer to the best practice document as well, when ready.</note> - <p>The increasing usage of XML as a medium for documentation-related content (e.g. DocBook - and DITA as formats for writing structured documentation, well suited to computer + <p>The increasing usage of XML as a medium for documentation-related content (e.g. <ref target="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook#technical">DocBook</ref>> + and <ref target="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita#technical">DITA</ref> as formats for writing structured documentation, well suited to computer hardware and software manuals) and software-related content (e.g. the eXtensible User Interface Language <ptr target="#xul" type="bibref"/>) creates challenges and opportunities in the domain of XML internationalization and localization.</p> @@ -362,22 +362,21 @@ </div> <div xml:id="users_text_analytics"> <head>Text Analytics</head> - <p>These types of users fulfil the role of providing services for automatic generation - of metadata for improving localization, data integration or knowledge management - workflows. This class of users comprises of developers and integrators of services - that automate language technology tasks such as domain classification, named entity - recognition and disambiguation, term extraction, language identification and others. - Text analytics services generate data that contextualizes the raw content with more - explicit information. This can be used to improve the output quality in machine - translation systems, search result relevance in information retrieval systems, as - well as management and integration of unstructured data in knowledge management - systems.</p> + <p>This type of services provides automatically generated metadata for improving + localization, data integration or knowledge management workflows. This class of + users comprises of developers and integrators of services that automate language + technology tasks such as domain classification, named entity recognition and + disambiguation, term extraction, language identification and others. Text analytics + services generate data that contextualizes the raw content with more explicit + information. This can be used to improve the output quality in machine translation + systems, search result relevance in information retrieval systems, as well as + management and integration of unstructured data in knowledge management systems.</p> </div> <div xml:id="users_localization_workflow_managers"> <head>Localization Workflow Managers</head> <p>These types of users are concerned with localization workflows in which content goes through certain steps: preparation for localization, start of the localization - process by e.g. a conversion into a bitext format like <ptr target="#xliff" + process by e.g. a conversion into a bitext (aligned parallel text) format like <ptr target="#xliff" type="bibref"/>, the actual localization by human translators or machine translation and other adaptations of content, and finally the integration of the localized content into the original format. That format is often based on XML or @@ -505,7 +504,7 @@ <div xml:id="usage-in-legacy-html"> <head>Support for legacy HTML content</head> <p>ITS 2.0 does not define how to use ITS in HTML versions prior version 5. Users are - encouraged to migrate their content to HTML or XHTML. While it is possible to use + encouraged to migrate their content to HTML5 or XHTML. While it is possible to use <code>its-*</code> attributes introduced for HTML5 in older versions of HTML (such as 3.2 or 4.01) and pages using these attributes will work without any problems, <code>its-*</code> attributes will be marked as invalid in validators.</p> @@ -600,16 +599,16 @@ <head>Selection</head> <p>Information (e.g. "translate this") captured by ITS markup (e.g. - <code>its:translate='yes'</code>) always pertains to one or more XML or HTML nodes - (primarily element and attribute nodes). In a sense, ITS markup “selects” the relevant - node(s). Selection may be explicit or implicit. ITS distinguishes two approaches to - selection: (1) local, and (2) using global rules.</p> + <code>its:translate='yes'</code>) always pertains to one or more XML or HTML nodes, + primarily element and attribute nodes, as defined in <ref target="xpath">XPath</ref>. + In a sense, ITS markup “selects” the relevant node(s). Selection may be explicit or implicit. + ITS distinguishes two approaches to selection: (1) local, and (2) using global rules.</p> <p>The mechanisms defined for ITS selection resemble those defined in <ptr target="#css2-1" type="bibref"/>. The local approach can be compared to the <code>style</code> attribute in HTML/XHTML, and the approach with global rules is similar to the <code>style</code> element in HTML/XHTML. ITS usually uses XPath for - identifying nodes although CSS and other query languages can be used if supported by - application. Thus,</p> + identifying nodes although CSS Selectors and other query languages can be used if supported by + the application. Thus,</p> <list> <item>the local approach puts ITS markup in the relevant element of the host vocabulary (e.g. the <code>author</code> element in DocBook)</item> @@ -656,7 +655,7 @@ example <gi>translateRule</gi>). Each of these specific elements contains a <att>selector</att> attribute. As its name suggests, this attribute selects the node or nodes to which a corresponding ITS information pertains. The values of ITS selector - attributes are XPath absolute location paths (or CSS selectors if <ref + attributes are XPath absolute location paths (or CSS Selectors if <ref target="#queryLanguage">queryLanguage</ref> is set to "css"). Information for the handling of namespaces in these path expressions is taken from namespace declarations <ptr target="#xmlns" type="bibref"/> at the current rule element.</p> @@ -902,9 +901,16 @@ </div> <div xml:id="def-html"> <head>The Term HTML</head> - <p>This specification uses the term <code>HTML</code> to refer to HTML5 or its successor + <p>This specification uses the term <code>HTML</code> to refer to HTML5 or its successor in HTML syntax <ptr target="#html5" type="bibref"/>.</p> </div> + <div xml:id="def-css-selector"> + <head>The Term CSS Selectors</head> + <p>This specification uses the term <code>CSS Selectors</code> in the + sense of <code>Selectors</code> as specifies in <ptr target="#css3-selectors" type="bibref"/> + to prevent confusion with the generic use of the word "selector". + <ptr target="#css3-selectors" type="bibref"/>.</p> + </div> </div> <div xml:id="conformance"> <head>Conformance</head> @@ -920,8 +926,10 @@ for ITS Markup</ref> and conformance of <ref target="#conformance-product-html-processing-expectations">3) processing expectations for ITS Markup in HTML</ref>. Also special <ref target="#conformance-class-html5-its" - >conformance class</ref> is defined for using ITS markup in HTML5 document which servers - as an applicable specification for HTML5+ITS. These conformance types and classes + >conformance class</ref> is defined for using ITS markup in HTML5 documents, HTML5+ITS, which serves + as an <emph>applicable specification</emph> in the sense specified in the + <ref target="http://www.w3.org/TR/html5/infrastructure.html#extensibility">Extensibility section</ref> of + <ptr target="#html5" type="bibref"/>. These conformance types and classes complement each other. An implementation of this specification <ref target="#rfc2119" >MAY</ref> use them separately or together.</p> <div xml:id="conformance-product-schema"> @@ -1369,19 +1377,26 @@ </div> <div xml:id="css-selectors"> <head>CSS Selectors</head> - <note><p xml:id="css-selectors-implementations">The working group will not provide a CSS selectors based implementation; nevertheless there are several existing libraries which can translate CSS selectors to XPath, so that XPath selectors based implementations can be used.</p></note> - <p>CSS Selectors are identified by <code>css</code> value in <att>queryLanguage</att> + <note><p>The term <code>CSS Selectors</code> is used throughout the specification in the + sense of <code>Selectors</code> as specified in <ptr target="#css3-selectors" type="bibref"/> + to prevent confusion with the generic use of the word "selector". + See <ref target="#css-selectors">The term CSS Selector</ref>.</p></note> + <note><p xml:id="css-selectors-implementations">The working group will not provide a + CSS Selectors based implementation; nevertheless there are several existing libraries, + which can translate CSS Selectors to XPath, so that XPath selectors based implementations + can be used.</p></note> + <p>CSS Selectors are identified by <code>css</code> value in <att>queryLanguage</att> attribute.</p> <div> <head>Absolute selector</head> <p>Absolute selector <ref target="#rfc-keywords">MUST</ref> be interpreted as selector - as defined in <ref target="#css3-selectors">Selectors Level 3</ref>. Both simple + as defined in <ptr target="#css3-selectors" type="bibref"/>. Both simple selectors and groups of selectors can be used.</p> </div> <div> <head>Relative selector</head> <p>Relative selector <ref target="#rfc-keywords">MUST</ref> be interpreted as selector - as defined in <ref target="#css3-selectors">Selectors Level 3</ref>. Selector is not + as defined in <ptr target="#css3-selectors" type="bibref"/>. Selector is not evaluated against the complete document tree but only against subtrees rooted at nodes selected by selector in the <att>selector</att> attribute.</p> </div> @@ -1389,15 +1404,15 @@ <div> <head>Additional query languages</head> <p>ITS processors <ref target="#rfc-keywords">MAY</ref> support additional query - languages. For each additional query language processor <ref target="#rfc-keywords" + languages. For each additional query language the processor <ref target="#rfc-keywords" >MUST</ref> define:</p> <list type="bulleted"> <item>identifier of query language used in <att>queryLanguage</att>;</item> <item>rules for evaluating absolute selector to collection of nodes;</item> <item>rules for evaluating relative selector to collection of nodes.</item> </list> - <p>Future versions of this specification <ref target="#rfc-keywords">MAY</ref> define - additional query languages. The following query language identifiers are reserved: + <p>Because future versions of this specification are likely to define + additional query languages, the following query language identifiers are reserved: <code>xpath</code>, <code>css</code>, <code>xpath2</code>, <code>xpath3</code>, <code>xquery</code>, <code>xquery3</code>, <code>xslt2</code>, <code>xslt3</code>.</p> @@ -1587,9 +1602,8 @@ <div xml:id="conversion-to-nif"> <head>Conversion to NIF</head> <p>This section defines an algorithm to convert XML or HTML documents (or their DOM - representations) that contain ITS metadata to the RDF-based format <ref - target="http://nlp2rdf.org/nif-1-0">NIF</ref>. The conversion results in RDF - triples.</p> + representations) that contain ITS metadata to the RDF-based format based on <ptr target="#NIF" type="bibref"/>. + The conversion results in RDF triples.</p> <note><p>The algorithm is intended to extract the text from the XML/HTML/DOM for an NLP tool and can produce a lot of <quote>phantom</quote> predicates from excessive whitespace, which 1) increases the size of the intermediate mapping and 2) extracts @@ -1807,6 +1821,8 @@ <div xml:id="html5-markup"> <head>Using ITS Markup in HTML</head> + <note><p>Please note that the term <code>HTML</code> refers to HTML5 or its successor in HTML syntax + <ptr target="#html5" type="bibref"/>.</p></note> <div xml:id="html5-local-attributes"> <head>Mapping of Local Data Categories to HTML</head> <p>All data categories defined in <ptr target="#datacategory-description" type="specref"/> @@ -1819,8 +1835,8 @@ <p>The above mentioned data categories are excluded because HTML has native markup for them.</p> </note> - <p>In HTML data categories are implemented as attributes. Name of HTML attribute is - derived from the name of attribute defined in the local implementation by using the + <p>In HTML data categories are implemented as attributes. Name of the HTML attribute is + derived from the name of the attribute defined in the local implementation by using the following rules:<list type="ordered"> <item>Attribute name is prefixed with <code>its-</code></item> <item>Each uppercase letter in the attribute name is replaced by <code>-</code> @@ -1832,7 +1848,7 @@ <note><p>Case of attribute names is also irrelevant given the nature of HTML syntax. So in HTML terminology data category can be stored as <att>its-term</att>, <code>ITS-TERM</code>, <code>its-Term</code> etc. All those attributes are treated - as equivalent and will gets normalized upon DOM construction.</p></note> + as equivalent and will get normalized upon DOM construction.</p></note> <p>Values of attributes which corresponds to data categories which use <ref target="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#double">XML Schema double data type</ref> <ref target="#rfc2119">MUST</ref> be also valid floating-point numbers as defined in <ptr target="#html5" type="bibref"/>.</p> @@ -1905,7 +1921,7 @@ <div xml:id="xhtml5-markup"> <head>Using ITS Markup in XHTML</head> - <p>XHTML documents aimed at public consumption by Web browsers <ref target="#rfc2119">SHOULD</ref> use the syntax described in <ptr + <p>XHTML documents aimed at public consumption by Web browsers, including HTML5 documents in XHTML synatx, <ref target="#rfc2119">SHOULD</ref> use the syntax described in <ptr target="#html5-markup" type="specref"/> in order to adhere to <ref target="http://www.w3.org/TR/html-design-principles/#dom-consistency">DOM Consistency HTML Design Principle</ref>.</p> @@ -2826,11 +2842,7 @@ <p>Applying the <ref target="#language-information">Language Information</ref> data category to <code>xml:lang</code> attributes using global rules is not necessary, since <code>xml:lang</code> is the standard way to specify language information in - XML. <code>xml:lang</code> is defined in terms of <ref - target="http://www.w3.org/TR/2006/REC-xml-20060816/#sec-lang-tag">RFC 3066 or its - successor</ref> (<ptr target="#bcp47" type="bibref"/> is the "Best Common - Practice" for language identification and encompasses <ptr type="bibref" - target="#rfc3066"/> and its successors.)</p> + <ptr target="#xml10spec" type="bibref"/> .</p> <p>In HTML <code>lang</code> is the mandated means of language identification.</p> </note> </div> @@ -2980,7 +2992,7 @@ <item><p>STEP 3-1-2-3: If the last character of the value is an APOSTROPHE (U+0027) or a QUOTATION MARK (U+0022): Remove it.</p></item> <item><p>STEP 3-1-2-4: If the value is empty: Go to STEP 3-1-2.</p></item> - <item><p>STEP 3-1-2-5: Check if there is a mapping for the string:</p> + <item><p>STEP 3-1-2-5: Check the <code>domainMapping</code> attribute to see if there is a mapping set for the string:</p> <list type="slist"> <item><p>STEP 3-1-2-5-1. If a mapping is found: Add the corresponding value to the result string.</p></item> @@ -3082,7 +3094,7 @@ /> </exemplum> <note> - <p>In HTML the preferred way to express domain information is a <code>meta</code> + <p>In HTML, one possible way how to express domain information is a <code>meta</code> element with the <code>name</code> attribute set to <val>keywords</val>, see <ref target="http://www.w3.org/TR/html5/single-page.html#standard-metadata-names" >standard metadata names in HTML</ref>. Alternatively, following the process for @@ -3151,7 +3163,7 @@ <p>A fragment of text is disambiguated at different granularities: (1) lexical type, (2) ontological concept, or (3) named entity.</p> <p>In the case of lexical type, the external resource may provide appropriate synonyms - and example usage, such as what WordNet services do.</p> + and example usage, such as what <ptr target="#wordnet" type="bibref"/> services do.</p> <p>In the case of ontological concept, the external resource may provide a formalized conceptual definition arranged in a hierarchical framework of related concepts.</p> <p>In the case of a named entity, the external resource may provide a fully fledged @@ -3161,7 +3173,7 @@ that could represent a subclass of 'Populated Place' at the conceptual granularity level, or the central area of a particular city, e.g. 'City of London', as interpreted at the entity granularity level.</p> - <p>Linked data networks, such as DBpedia, further increase the interlinking of + <p>Linked data networks, such as <ptr target="#dbpedia" type="bibref"/>, further increase the interlinking of ontological concepts and named entity definitions for same things and in different languages, thereby offering the possibility to directly facilitate translation through a source language description.</p> @@ -3299,8 +3311,8 @@ entities are distinct from types of lexical concepts or ontology concepts. While this distinction exists, the specification does not prescribe a way of automatically inferring a disambiguation level from a target type.</p> - <p>When serializing the ITS mark-up in HTML, the preferred way is to serialize in RDFa - Lite or Microdata due to the existing search and crawling infrastructure that is + <p>When serializing the ITS mark-up in HTML, the preferred way is to serialize in + <ptr target="#rdfa-lite" type="bibref"/> or <ptr target="#microdata" type="bibref"/> 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"> @@ -3843,8 +3855,9 @@ <p>The <ref target="#preservespace">Preserve Space</ref> data category indicates how whitespace should be handled in content. The possible values for this data category are "default" and "preserve" and carry the same meaning as the corresponding values of - the <ref target="http://www.w3.org/TR/2008/REC-xml-20081126/#sec-white-space" - >xml:space</ref> attribute. The default value is "default".</p> + the <ref target="http://www.w3.org/TR/2008/REC-xml-20081126/#sec-white-space">xml:space</ref> + attribute. The default value is "default". The Preserve Space data category does not apply + to HTML documents in HTML syntax.</p> </div> <div xml:id="preservespace-implementation"> <head>Implementation</head> @@ -3854,9 +3867,10 @@ to the textual content of the element, <emph>including</emph> child elements and attributes.</p> <note><p xml:id="preserve-space-and-html5">The <ref target="#preservespace">Preserve - Space</ref> data category is not applicable to HTML documents because + Space</ref> data category is not applicable to HTML documents in HTML synatx because <code>xml:space</code> (and by extension <ref target="#preservespace">Preserve - Space</ref>) has no effect in documents parsed as text/html.</p></note> + Space</ref>) has no effect in documents parsed as text/html. However, the data category + can be used in HTML <emph>in XHTML synatx</emph>.</p></note> <p xml:id="preservespace-global">GLOBAL: The <gi>preserveSpaceRule</gi> element contains the following:</p> @@ -4487,7 +4501,7 @@ <head>Implementation</head> <p>The <ref target="#storagesize">Storage Size</ref> data category can be expressed with global rules, or locally on individual elements. There is no inheritance. The default - value of the character set encoding is UTF-8.</p> + value of the character encoding is UTF-8.</p> <p xml:id="storagesize-global">GLOBAL: The <gi>storageSizeRule</gi> element contains the following:</p> <list type="unordered"> @@ -4506,7 +4520,7 @@ <item><p>None or exactly one of the following:</p> <list type="unordered"> <item><p>A <att>storageEncoding</att> attribute. It contains the name of the - character set encoding used to calculate the number of bytes of the selected + character encoding used to calculate the number of bytes of the selected text. The name <ref target="#rfc-keywords">MUST</ref> be one of the names or aliases listed in the <ref target="http://www.iana.org/assignments/character-sets">IANA Character Sets @@ -4541,7 +4555,7 @@ XML</head> <p>The <gi>storageSizePointer</gi> attribute is used to map the non-ITS attribute <code>max</code> to the same functionality as <att>storageSize</att>. There is no - character set encoding specified, so the default UTF-8 is assumed. Note that, while + character encoding specified, so the default UTF-8 is assumed. Note that, while the name "Papouasie-Nouvelle-Guinée" is 25 character long, the character 'é' is encoded into two bytes in UTF-8. Therefore this name is one byte too long to fit in its storage destination.</p> @@ -4555,7 +4569,7 @@ <item><p>A <att>storageSize</att> attribute. It contains the maximum number of bytes the text of the selected node is allowed in storage.</p></item> <item><p>An optional <att>storageEncoding</att> attribute. It contains the name of the - character set encoding used to calculate the number of bytes of the selected text. + character encoding used to calculate the number of bytes of the selected text. The name <ref target="#rfc-keywords">MUST</ref> be one of the names or aliases listed in the <ref target="http://www.iana.org/assignments/character-sets">IANA Character Sets registry</ref> @@ -4577,6 +4591,7 @@ <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-storageSize-local-1.xml"/> </exemplum> + <note><p>Please note that the string <code>CONTINUE</code> in the above example does not fit the specified restriction.</p></note> <exemplum xml:id="EX-storageSize-html5-local-1"> <head>The <ref target="#storagesize">Storage Size</ref> data category expressed locally in HTML</head> @@ -4620,16 +4635,24 @@ target="http://www.rfc-editor.org/rfc/bcp/bcp47.txt"> http://www.rfc-editor.org/rfc/bcp/bcp47.txt</ref>.</bibl> <bibl xml:id="html4" n="HTML 4.01">Dave Raggett et al. <title> - <ref target="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</ref> - </title>. W3C Recommendation 24 December 1999. Available at <ref - target="http://www.w3.org/TR/1999/REC-html401-19991224"> - http://www.w3.org/TR/1999/REC-html401-19991224</ref>. The latest version of <ref + <ref target="http://www.w3.org/TR/1999/REC-html401-19991224/">HTML 4.01</ref> + </title>. W3C Recommendation 24 December 1999. Available at <ref + target="http://www.w3.org/TR/1999/REC-html401-19991224"> + http://www.w3.org/TR/1999/REC-html401-19991224</ref>. The latest version of <ref target="http://www.w3.org/TR/html401">HTML 4.01</ref> is available at http://www.w3.org/TR/html401.</bibl> + <bibl xml:id="html5" n="HTML5">Robin Berjon et al. <title> + <ref target="http://www.w3.org/TR/2012/CR-html5-20121217/">HTML5</ref> + </title>. W3C Candidate Recommendation 17 December 2012. Available at <ref + target="http://www.w3.org/TR/2012/CR-html5-20121217/"> + http://www.w3.org/TR/1999/REC-html401-19991224</ref>. The latest version of <ref + target="http://www.w3.org/TR/html5/">HTML5</ref> is available at + http://www.w3.org/TR/html5/.</bibl> <bibl xml:id="ianacharsets" n="IANA Character Sets"><title> <ref target="http://www.iana.org/assignments/character-sets">Character Sets</ref> </title> Available at <ref target="http://www.iana.org/assignments/character-sets" >http://www.iana.org/assignments/character-sets</ref>.</bibl> + <bibl xml:id="NIF" n="NIF">NIF Placeholder at http://persistence.uni-leipzig.org/nlp2rdf/</bibl> <bibl xml:id="qa-framework" n="QAFRAMEWORK">Karl Dubost, Lynne Rosental, Dominique Hazaël-Massieux, Lofton Henderson. <title> <ref target="http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/">QA Framework: [1087 lines skipped] --- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20-before-issue-113-edits.html 2013/03/27 18:19:56 NONE +++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20-before-issue-113-edits.html 2013/03/27 18:19:56 1.1 [6874 lines skipped]
Received on Wednesday, 27 March 2013 18:20:10 UTC