- From: Felix Sasaki <fsasaki@w3.org>
- Date: Sat, 29 Apr 2006 12:22:58 +0900
- To: Yves Savourel <yves@opentag.com>
- Cc: public-i18n-its@w3.org
- Message-ID: <4452DC12.8020205@w3.org>
Hi Yves, all, I implemented your proposals. Please look at the changemarks at http://www.w3.org/International/its/itstagset/itstagset-diff-20060414.html#locInfo-datacat-def If nobody disagrees, I would keep it like that. - Felix Yves Savourel wrote: > 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 Saturday, 29 April 2006 03:23:07 UTC