W3C home > Mailing lists > Public > public-i18n-its@w3.org > April to June 2006

locInfo ... Global rules

From: Yves Savourel <yves@opentag.com>
Date: Fri, 28 Apr 2006 14:53:04 +0200
To: "'Felix Sasaki'" <fsasaki@w3.org>
Cc: <public-i18n-its@w3.org>
Message-ID: <00a501c66ac2$b1bdbf40$640fa8c0@Breizh>

Hi all,

Trying to look at the locInfoRef and termRef attributes to do my action item, I ran into the description of the locInfo section
<http://www.w3.org/International/its/itstagset/itstagset.html#locInfo-datacat-def>.

It seems we are missing some definitions: what exactly is locInfo and locInfoRef for example. We also say twice that "The selector
attribute is mandatory". I've tried to come up with a more explicit wording and one example per case (this is for the global rule):

--------------------
6.3.2 Implementation

Localization information can be expressed with global rules, or locally on an individual element.

Using global rules, addition of localization information to selected nodes is achieved with a locInfoRule element, which has a
mandatory selector attribute and a mandatory locInfoType attribute. The information associated to the selection can be indicated
different ways using either a locInfo element, a locInfoRef attribute, a locInfoPointer attribute, or a locInfoRefPointer attribute.
The locInfo element, locInfoRef attribute, locInfoPointer attribute, and locInfoRefPointer MUST NOT occur together.

The locInfo element contains the information itself.

<myDoc>
 <head>
  <its:rules xmlns:its="http://www.w3.org/2005/11/its" its:version="1.0">
   <its:locInfoRule locInfoType="alert" selector="/body/p[1]">
    <its:locInfo>This p element has to be handled carefully.</its:locInfo> 
   </its:locInfoRule>
  </its:rules>
 </head>
 <body>
  <p>Paragraph to translate.</p>
 </body>
</myDoc>


The locInfoRef attribute is a URI referring to the location where is the information.

<myRes>
 <head>
  <its:rules xmlns:its="http://www.w3.org/2005/11/its" its:version="1.0">
   <its:locInfoRule locInfoType="description" selector="/body/msg[@id='FileNotFound']"
    locInfoRef="ErrorsInfo.html/#FileNotFound" />
   </its:locInfoRule>
  </its:rules>
 </head>
 <body>
  <msg id="FileNotFound">Cannot find the file {0}.</msg>
 </body>
</myRes>


The locInfoPointer is a relative XPath expression pointing to a node that holds the information.

<Res>
 <prolog>
  <its:rules xmlns:its="http://www.w3.org/2005/11/its" its:version="1.0">
   <its:locInfoRule locInfoType="description" selector="//msg/data"
    locInfoPointer="../notes" />
   </its:locInfoRule>
  </its:rules>
 </prolog>
 <body>
  <msg id="FileNotFound">
   <notes>Indicates that the resource file {0} could not be loaded.</notes>
   <data>Cannot find the file {0}.</data>
  </msg>
  <msg id="DivByZero">
   <notes>A division by 0 was going to be computed.</notes>
   <data>Invalid parameter.</data>
  </msg>
 </body>
</Res>


The locInfoRefPointer is a relative XPath expression pointing to a node that holds the URI referring to the location where is the
information.

<data>
 <prolog>
  <its:rules xmlns:its="http://www.w3.org/2005/11/its" its:version="1.0">
   <its:locInfoRule locInfoType="description" selector="//string"
    locInfoRefPointer="@noteInfo" />
   </its:locInfoRule>
  </its:rules>
 </prolog>
 <body>
  <string id="FileNotFound" noteFile="Comments.html/#FileNotFound">
   <data>Cannot find the file {0}.</data>
  </string>
  <string id="DivByZero" noteFile="Comments.html/#DivByZero">
   <data>Invalid parameter.</data>
  </string>
 </body>
</data>

...then the text for the local markup...
--------------------

Cheers,
-yves
Received on Friday, 28 April 2006 13:00:08 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:43:07 UTC