Le jeu de balises d'internationalisation (ITS) version 1.0

1.1.1 Les problèmes typiques

Les exemples suivants illustrent l'un des blocages actuels pour la localisation efficace d'un contenu de type XML : l'absence d'un mécanisme déclaratif normalisé identifiant les parties d'un document XML à traduire. Les outils sont souvent incapables de cette identification automatique.

<resources>
 <section id="Homepage">
  <arguments>
   <string>page</string>
   <string>childlist</string>
  </arguments>
  <variables>
   <string>POLICY</string>
   <string>Corporate Policy</string>
  </variables>
  <keyvalue_pairs>
   <string>Page</string>
   <string>ABC Corporation - Policy Repository</string>
   <string>Footer_Last</string>
   <string>Pages</string>
   <string>bgColor</string>
   <string>NavajoWhite</string>
   <string>title</string>
   <string>List of Available Policies</string>
  </keyvalue_pairs>
 </section>
</resources>

<dialogue xml:lang="en-gb">
 <rsrc id="123">
  <component id="456" type="image">
   <data type="text">images/cancel.gif</data>
   <data type="coordinates">12,20,50,14</data>
  </component>
  <component id="789" type="caption">
   <data type="text">Cancel</data>
   <data type="coordinates">12,34,50,14</data>
  </component>
  <component id="792" type="string">
   <data type="text">Number of files: </data>
  </component>
 </rsrc>
</dialogue>

1.2.1 Les utilisateurs potentiels du jeu ITS

La spécification ITS vise à fournir aux différents types d'utilisateurs des informations sur le balisage nécessaire pour une utilisation mondiale et pour une réelle internationalisation et localisation du contenu. Les paragraphes suivants esquissent ces différents types d'utilisateurs et leurs utilisations du jeu ITS.

• Le développeur de schémas élaborant un schéma depuis le commencement :

  Ce type d'utilisateur trouvera des propositions pour les noms d'attributs et d'éléments à inclure dans un nouveau schéma (un ensemble appelé aussi « vocabulaire hôte »). Il peut être avantageux d'utiliser des noms d'éléments et attributs proposés dans la spécification ITS car les utilisateurs et processeurs de schémas reconnaîtront peut-être plus facilement les concepts représentés. Toutefois, un développeur de schémas peut parfaitement créer son propre jeu de noms d'éléments et d'attributs. L'objet de la spécification est avant tout d'assurer la disponibilité du balisage nécessaire, et que le comportement de ce balisage corresponde à des besoins établis.

• Le développeur de schémas travaillant avec un schéma existant :

  Ce type d'utilisateur travaillera avec des schémas tels que DocBook, DITA ou peu-être un schéma propriétaire. Le groupe de travail ITS a sollicité l'avis d'experts dans le développement de formats largement utilisés comme ceux mentionnés ici.

  Remarque :

  La question « Comment utiliser le jeu ITS avec les schémas de balisage courants existants ? » est couverte plus en détails (y compris des exemples) dans un document séparé : [XML i18n BP].

  Le développeur travaillant sur un schéma existant devraient vérifier si celui-ci gère le balisage proposé ici dans cette spécification et l'ajouter au sien là où c'est approprié.

  Parfois, le schéma existant contient déjà un balisage équivalent de celui recommandé dans le jeu ITS. Auquel cas, il ne sera pas nécessaire d'ajouter un balisage en double car ITS offre des mécanismes pour associer le balisage ITS au balisage dans un vocabulaire hôte ayant une vocation similaire (cf. la section 5.5 L'association de catégories de données ITS au balisage existant). Néanmoins, le développeur devrait vérifier que le comportement associé au balisage dans son propre schéma est entièrement compatible aux attentes décrites dans cette spécification.

• Le vendeur d'outils en rapport avec le contenu :

  Ce type d'utilisateur comprend les sociétés fournissant des outils de création, de traduction, ou d'autres solutions logicielles liées aux contenus. Il importe de s'assurer que ces outils rendent possible une utilisation mondiale et une localisation réelle du contenu. Par exemple, les outils de traduction devraient empêcher que le contenu balisé comme étant hors traduction ne soit changé ou traduit. On espère de la spécification ITS qu'elle rendra la tâche plus facile aux vendeurs en normalisant le format et les attentes de traitement (processing expectations) de certains éléments pertinents du balisage, et en leur permettant de déterminer plus efficacement comment traiter le contenu.

• Les producteurs de contenu :

  Ce type d'utilisateur comprend les auteurs, les traducteurs et autres créateurs de contenus. Le balisage proposé dans cette spécification peut leur servir à marquer des morceaux spécifiques de contenu. En aparté : on peut soulager le producteur de contenu de la charge d'insérer le balisage en reliant les informations ITS aux morceaux pertinents de contenu de manière globale (cf. l'approche globale fondée sur des règles). Toutefois, ce travail global incombera plutôt aux architectes de l'information qu'aux créateurs de contenus mêmes.

Pour tenir compte de tous ces utilisateurs, les renseignements à propos du balisage à utiliser pour permettre une utilisation mondiale et une localisation réelle du contenu sont fournis dans cette spécification de deux façons :

• De manière abstraite dans les descriptions des catégories de données : la section 6 La description des catégories de données

• De manière concrète dans les schémas ITS : l'annexe D Les schémas ITS

1.2.2 Les façons d'utiliser le jeu ITS

La spécification ITS propose plusieurs mécanismes pour soutenir une utilisation mondiale et une réelle internationalisation et localisation du contenu. Nous les esquisserons ci-dessous en les observant des points de vues de certains types d'utilisateurs. Pour les besoins de l'illustration, nous démontrerons comment le jeu ITS peut indiquer que certaines parties du contenu sont à traduire ou non.

• Un créateur de contenus utilise un attribut sur un élément particulier pour indiquer que le texte qui y est contenu ne devrait pas être traduit.

<help
  xmlns:its="http://www.w3.org/2005/11/its" 
  its:version="1.0">
 <head>
  <title>Building the Zebulon Toolkit</title>
 </head>
 <body>
  <p>To re-compile all the modules of the Zebulon toolkit you need to go in the
    <path
     its:translate="no">\Zebulon\Current Source\binary</path> directory.
    Then from there, run batch file <cmd
     its:translate="no">Build.bat</cmd>.</p>
 </body>
</help>

• Un créateur de contenus ou un architecte de l'information utilisent le balisage au début du document pour identifier le type d'élément ou de contexte particuliers dans lesquels le contenu ne devrait pas être traduit.

<help
  xmlns:its="http://www.w3.org/2005/11/its" 
  its:version="1.0">
 <head>
  <title>Building the Zebulon Toolkit</title>
  <its:rules version="1.0">
   <its:translateRule selector="//path | //cmd" translate="no"/>
  </its:rules>
 </head>
 <body>
  <p>To re-compile all the modules of the Zebulon toolkit you need to go in the
    <path>\Zebulon\Current Source\binary</path> directory.
    Then from there, run batch file <cmd>Build.bat</cmd>.</p>
 </body>
</help>

• Un processeur peut insérer, au début du document, du balisage qui lie à des instructions ITS hors du document.

<help
  xmlns:its="http://www.w3.org/2005/11/its" 
  xmlns:xlink="http://www.w3.org/1999/xlink" 
  its:version="1.0">
 <head>
  <title>Building the Zebulon Toolkit</title>
  <its:rules version="1.0" xlink:href="EX-ways-to-use-its-4.xml" xlink:type="simple"/>
 </head>
 <body>
  <p>To re-compile all the modules of the Zebulon toolkit you need to go in the
    <path>\Zebulon\Current Source\binary</path> directory.
    Then from there, run batch file <cmd>Build.bat</cmd>.</p>
 </body>
</help>

<its:rules
  xmlns:its="http://www.w3.org/2005/11/its"  version="1.0">
 <its:translateRule selector="//path | //cmd" translate="no"/>
</its:rules>

• Un développeur de schémas intègre des déclarations de balisage ITS dans son schéma pour permettre à ses utilisateurs d'indiquer quelles parties spécifiques du contenu ne pas traduire.

<xs:schema
  xmlns:its="http://www.w3.org/2005/11/its" 
  xmlns:xs="http://www.w3.org/2001/XMLSchema"  elementFormDefault="qualified">
 <xs:import namespace="http://www.w3.org/2005/11/its" schemaLocation="its.xsd"/>
 <xs:attributeGroup name="commonAtts">
  <xs:attributeGroup ref="its:att.local.with-ns.attribute.translate"/>
  <xs:attribute name="id" type="xs:ID" use="optional"/>
 </xs:attributeGroup>
 <xs:element name="help">
  <xs:complexType>
   <xs:sequence>
    <xs:element name="head">
     <xs:complexType>
      <xs:sequence>
       <xs:element name="title" type="xs:string"/>
      </xs:sequence>
      <xs:attributeGroup ref="commonAtts"/>
     </xs:complexType>
    </xs:element>
    <xs:element name="body">
     <xs:complexType>
      <xs:choice minOccurs="1" maxOccurs="unbounded">
       <xs:element name="p">
        <xs:complexType mixed="true">
         <xs:choice minOccurs="0" maxOccurs="unbounded">
          <xs:element ref="path"/>
          <xs:element ref="cmd"/>
         </xs:choice>
         <xs:attributeGroup ref="commonAtts"/>
        </xs:complexType>
       </xs:element>
      </xs:choice>
     </xs:complexType>
    </xs:element>
   </xs:sequence>
   <xs:attributeGroup ref="its:att.version.attribute.version"/>
  </xs:complexType>
 </xs:element>
 <xs:element name="path">
  <xs:complexType mixed="true">
   <xs:attributeGroup ref="commonAtts"/>
  </xs:complexType>
 </xs:element>
 <xs:element name="cmd">
  <xs:complexType mixed="true">
   <xs:attributeGroup ref="commonAtts"/>
  </xs:complexType>
 </xs:element>
</xs:schema>

Les deux premières approches précédentes peuvent être comparées à l'utilisation de CSS dans [XHTML 1.0]. Avec un attribut style, un créateur de contenu XHTML peut assigner une couleur à un paragraphe particulier. L'auteur aurait pu utiliser l'élément style au début de la page pour déclarer que tous les paragraphes d'une classe particulière ou dans un contexte particulier aient une couleur rouge.

2.1.1 L'approche locale

Le document dans l'exemple n° 8 montre comment un créateur de contenus peut utiliser l'attribut ITS translate pour indiquer que tout le contenu de l'élément author devrait être écarté de la traduction. Les outils de traduction comprenant la signification de cet attribut peuvent alors passer le contenu pertinent au crible exclure le contenu pertinent du processus de traduction.

<dbk:article
  xmlns:its="http://www.w3.org/2005/11/its" 
  xmlns:dbk="http://docbook.org/ns/docbook" 
  its:version="1.0" version="5.0" xml:lang="en">
 <dbk:info>
  <dbk:title>An example article</dbk:title>
  <dbk:author
    its:translate="no">
   <dbk:personname>
    <dbk:firstname>John</dbk:firstname>
    <dbk:surname>Doe</dbk:surname>
   </dbk:personname>
   <dbk:affiliation>
    <dbk:address>
     <dbk:email>foo@example.com</dbk:email>
    </dbk:address>
   </dbk:affiliation>
  </dbk:author>
 </dbk:info>
 <dbk:para>This is a short article.</dbk:para>
</dbk:article>

Pour un bon fonctionnement, le développeur du schéma aura besoin d'ajouter l'attribut translate au schéma comme attribut commun sur toutes les définitions d'éléments pertinentes. Notez, dans ce cas, l'attente quant à la part de l'héritage dans l'identification du contenu à traduire ou non. Les outils traitant ce contenu pour traduction devront mettre en œuvre le comportement d'héritage attendu.

2.1.2 L'approche globale

Le document dans l'exemple n° 9 montre une approche différente pour identifier un contenu non traduisible, similaire à celle utilisée avec l'élément style dans [XHTML 1.0], mais en utilisant un élément défini par ITS appelé rules. Il agit comme suit : un document peut contenir un élément rules (placé là où il n'affecte pas la structure du document, comme dans la section « head »). Il contient un ou plusieurs éléments de règles (par exemple translateRule). Chacun de ces éléments spécifiques contient un attribut selector. Comme suggéré par son nom, cet attribut sélectionne le nœud (ou les nœuds) XML dont dépend une information ITS correspondante. Les valeurs des attributs ITS selector sont des chemins d'emplacements absolus XPath. L'information de traitement des espaces de noms dans ces expressions de chemins est prélevée dans les déclarations d'espaces de noms [XML Names] de l'élément rules courant.

<myTopic
  xmlns:its="http://www.w3.org/2005/11/its" 
  xmlns="myNamescapeURI" id="topic01" xml:lang="en-us">
 <prolog>
  <title>Using ITS</title>
  <its:rules version="1.0">
   <its:translateRule selector="//n:term" selector="//term" translate="no"/>
  </its:rules>
 </prolog>
 <body>
  <p>ITS defines <term>data category</term> as an abstract
  concept for a particular type of information for 
  internationalization and localization of XML schemas and 
  documents.</p>
 </body>
</myTopic>

Pour le bon fonctionnement de cette approche, le développeur du schéma doit ajouter l'élément rules et le balisage associé au schéma.

Dans certains cas, cela permet au développeur du schéma d'éviter l'ajout d'un autre balisage ITS (tel qu'un attribut translate) aux éléments du schéma. Toujours est-il, les auteurs utiliseront vraisemblablement des attributs sur le balisage, à l'occasion, pour déroger (override) à la règle générale.

Pour la spécification de l'information de la catégorie de données Traduire, le contenu de l'élément rules sera normalement conçu par un architecte de l'information familier du format de document et familier (ou collaborant avec une personne familière) des besoins du groupe de localisation.

L'approche globale fondée sur des règles présente les avantages suivants :

• Les créateurs de contenus n'ont pas à se préoccuper de créer du balisage supplémentaire ou de vérifier la bonne application du balisage. Les catégories de données ITS sont associées à des ensembles de nœuds XML (par exemple, tous les éléments p d'une instance XML).

• Les changements peuvent être effectués dans un seul endroit (si l'élément rules est stocké comme entité externe), au lieu de rechercher et modifier le balisage à travers un (ou plusieurs) document.

• Les catégories de données ITS peuvent désigner des valeurs d'attributs aussi bien que des éléments.

• Il est possible d'associer le balisage ITS à un balisage existant (par exemple, l'élément term dans DITA).

Le point commun aux deux exemples précédents est le balisage translate='no'. Ce bout de balisage ITS peut s'interpréter comme suit :

• Il se rapporte à la catégorie de données Traduire ;

• L'attribut translate porte la valeur "no".

L'attribut ITS selector permet :

• Aux attributs des catégories de données ITS d'apparaître dans des règles globales (même en dehors d'un document ou schéma XML) ;

• Aux attributs des catégories de données ITS de se rapporter à des ensembles de nœuds XML (par exemple, tous les éléments p dans un document XML) ;

• Au balisage ITS de se rapporter à des attributs ;

• Au balisage ITS de s'associer à un balisage existant (par exemple, l'élément term dans DITA).

5.2.1 La sélection globale avec des règles

La sélection globale avec des règles est mise en œuvre en utilisant l'élément rules. Celui-ci contient zéro à plusieurs éléments de règles. Chaque élément de règle a un attribut selector obligatoire. Cet attribut et tous les autres attributs possibles des éléments de règles sont dans l'espace de noms vide (empty namespace) et sont utilisés sans préfixe.

S'il y a plusieurs éléments rules dans un document XML, les règles de chaque section doivent être traitées au même niveau de priorité. Les sections rules se lisent dans l'ordre du document, et leurs règles ITS se traitent successivement. Les versions de ces éléments rules NE DOIVENT PAS être différentes.

Selon la catégorie de données et son utilisation, d'autres attributs permettent d'ajouter de l'information aux nœuds sélectionnés ou de pointer vers de l'information existante dans le document. Par exemple, on peut utiliser la catégorie de données Note de localisation pour ajouter des notes aux nœuds sélectionnés ou pour pointer vers des notes existantes dans le document. Dans le premier cas, on pourra utiliser un élément locNote, dans le dernier cas, un attribut locNotePointer.

Chaque catégorie de données permet d'ajouter de l'information aux nœuds sélectionnés, sauf la catégorie de données Information de langue. Il n'est pas possible pour les catégories de données exprimant un ensemble fermé de valeurs de pointer vers de l'information existante, à savoir Traduire, Directionnalité et Éléments dans du texte.

Les fonctionnalités d'ajout d'information et de pointage vers de l'information existante sont mutuellement exclusives. C'est-à-dire qu'il NE DOIT PAS apparaître de balisage pour pointer et ajouter dans le même élément de règle.

Une autre différence entre l'ajout et le pointage est dans l'utilisation de XPath :

• La valeur de l'attribut selector DOIT être une expression XPath commençant par un caractère « / ». C'est-à-dire qu'elle doit être de type AbsoluteLocationPath comme décrit dans [XPath 1.0] ou ses successeurs. Cela garantit que la sélection n'est pas relative à un emplacement spécifique. Les nœuds résultants DOIVENT être des nœuds d'éléments ou d'attributs.

• Les attributs pointant vers des informations existantes dans le document, c'est-à-dire les attributs dont le nom se termine par « Pointer », DOIVENT utiliser une valeur de type RelativeLocationPath comme décrit dans [XPath 1.0] ou ses successeurs. L'expression XPath est évaluée relativement aux nœuds sélectionnés par l'attribut selector. Les attributs suivants pointent vers des informations existantes : locNotePointer, locNoteRefPointer, termInfoPointer, termInfoRefPointer, rubyPointer, rtPointer, rpPointer, rbcPointer, rtcPointer, rbspanPointer, langPointer.

Si des espaces de noms [XML Names] sont utilisés dans les expressions XPath, dans l'attribut selector ou les attributs de pointage, les règles suivantes DOIVENT être appliquée pendant le traitement XPath :

1. Pour chaque préfixe, il DOIT y avoir un attribut xmlns au même élément de règle permettant de résoudre l'adresse URI d'espace de noms du préfixe ;

2. Les noms d'éléments et d'attributs sans préfixe sont interprétés comme n'ayant pas d'espace de noms ;

3. Afin d'éviter les conflits avec la règle n° 2, les espaces de noms par défaut NE DOIVENT PAS être utilisés dans les expressions XPath.

<its:rules
  xmlns:its="http://www.w3.org/2005/11/its" 
  xmlns:tei="http://www.tei-c.org/ns/1.0" version="1.0">
 <its:termRule selector="//tei:term" term="yes"/>
</its:rules>

<its:rules
  xmlns:its="http://www.w3.org/2005/11/its"  version="1.0">
 <its:termRule selector="//qterm" term="yes"/>
</its:rules>

Les règles globales peuvent apparaître dans le document XML auquel elle s'appliqueront ou dans un document XML séparé. La priorité de leur traitement dépend de ces variations. Cf. également la section 5.4 La priorité entre les sélections.

Le balisage pour une sélection globale avec des règles est défini comme suit :

rules

[1]	rules	::=	element its:rules { rules.content, rules.attributes }
[2]	rules.content	::=	( translateRule | locNoteRule | termRule | dirRule | rubyRule | langRule | withinTextRule )*
[3]	rules.attributes	::=	attribute version { xsd:float }, attribute xlink:href { xsd:anyURI }?, attribute xlink:type { "simple" }?

att.selector

[4]	att.selector.attributes	::=	att.selector.attribute.selector
[5]	att.selector.attribute.selector	::=	attribute selector { string }

att.version

[6]	att.version.attributes	::=	att.version.attribute.version
[7]	att.version.attribute.version	::=	attribute its:version { xsd:float }

5.2.2 La sélection locale dans un document XML

La sélection locale dans les documents XML est réalisée avec des attributs ITS locaux, l'élément ruby ou l'élément span. L'élément span sert juste de porteur pour les attributs ITS locaux et de conteneur pour l'élément ruby.

Le modèle de contenu de span autorise une imbrication arbitraire du balisage ruby, puisque les éléments rb et rt eux-mêmes peuvent contenir des éléments span. Une application ruby NE DOIT PAS utiliser une telle imbrication arbitraire.

La catégorie de données détermine ce qui est sélectionné. Les valeurs par défaut nécessaires spécifiques des catégories de données sont décrites dans la section 6.1 La position, les valeurs par défaut, l'héritage et la prédominance des catégories de données.

<text
  xmlns:its="http://www.w3.org/2005/11/its" 
  its:version="1.0" xml:lang="en">
 <head
   its:translate="no">
  <author>Sven Corneliusson</author>
  <date>2006-09-26T17:34:04Z</date>
  <title
    its:translate="yes" role="header">Bidirectional Text</title>
 </head>
 <body>
  <par>In Arabic, the title <quote xml:lang="ar"
     its:dir="rtl">نشاط التدويل، W3C</quote>
     means <quote>Internationalization Activity, W3C</quote>.</par>
 </body>
</text>

Le balisage pour la sélection locale est défini comme suit. Le groupe d'attributs att.local.no-ns.attributes contient les attributs ITS sans espace de noms (N.d.T. in no namespace) et s'utilise avec les éléments span, locNote, ruby, rb, rt, rbc, rtc et rp. Le groupe d'attributs att.local.with-ns.attributes contient les attributs ITS qualifiés d'un espace de noms (namespace qualified ITS attributes) et s'utilise avec les éléments provenant d'espaces de noms différents.

att.local.no-ns

[8]	att.local.no-ns.attributes	::=	att.local.no-ns.attribute.translate, att.local.no-ns.attribute.locNote, att.local.no-ns.attribute.locNoteType, att.local.no-ns.attribute.locNoteRef, att.local.no-ns.attribute.termInfoRef, att.local.no-ns.attribute.term, att.local.no-ns.attribute.dir
[9]	att.local.no-ns.attribute.translate	::=	attribute translate { "yes" | "no" }?
[10]	att.local.no-ns.attribute.locNote	::=	attribute locNote { string }?
[11]	att.local.no-ns.attribute.locNoteType	::=	attribute locNoteType { "alert" | "description" }?
[12]	att.local.no-ns.attribute.locNoteRef	::=	attribute locNoteRef { xsd:anyURI }?
[13]	att.local.no-ns.attribute.termInfoRef	::=	attribute termInfoRef { xsd:anyURI }?
[14]	att.local.no-ns.attribute.term	::=	attribute term { "yes" | "no" }?
[15]	att.local.no-ns.attribute.dir	::=	attribute dir { "ltr" | "rtl" | "lro" | "rlo" }?

att.local.with-ns

[16]	att.local.with-ns.attributes	::=	att.local.with-ns.attribute.translate, att.local.with-ns.attribute.locNote, att.local.with-ns.attribute.locNoteType, att.local.with-ns.attribute.locNoteRef, att.local.with-ns.attribute.termInfoRef, att.local.with-ns.attribute.term, att.local.with-ns.attribute.dir
[17]	att.local.with-ns.attribute.translate	::=	attribute its:translate { "yes" | "no" }?
[18]	att.local.with-ns.attribute.locNote	::=	attribute its:locNote { string }?
[19]	att.local.with-ns.attribute.locNoteType	::=	attribute its:locNoteType { "alert" | "description" }?
[20]	att.local.with-ns.attribute.locNoteRef	::=	attribute its:locNoteRef { xsd:anyURI }?
[21]	att.local.with-ns.attribute.termInfoRef	::=	attribute its:termInfoRef { xsd:anyURI }?
[22]	att.local.with-ns.attribute.term	::=	attribute its:term { "yes" | "no" }?
[23]	att.local.with-ns.attribute.dir	::=	attribute its:dir { "ltr" | "rtl" | "lro" | "rlo" }?

span

[24]	span	::=	element its:span { span.content, span.attributes }
[25]	span.content	::=	( text | ruby | span )*
[26]	span.attributes	::=	att.local.no-ns.attributes

6.2.1 Définition

La catégorie de données Traduire exprime l'information selon laquelle le contenu d'un élément ou d'un attribut devrait être traduit ou non. Les valeurs de cette catégorie de données sont "yes" (traduisible) ou "no" (non traduisible).

6.2.2 Mise en œuvre

La catégorie de données Traduire peut s'exprimer avec des règles globales ou localement sur un élément individuel. L'information s'applique au contenu textuel de l'élément, incluant les sous-éléments mais excluant les attributs. Par défaut, les éléments sont traduisibles et les valeurs des attributs ne le sont pas.

GLOBAL : L'élément translateRule présente le contenu suivant :

• Un attribut selector obligatoire. Celui-ci contient une expression XPath sélectionnant les nœuds auxquels cette règle s'applique ;

• Un attribut translate obligatoire avec la valeur "yes" ou "no".

<its:rules
  xmlns:its="http://www.w3.org/2005/11/its"  version="1.0">
 <its:translateRule translate="no" selector="//code"/>
</its:rules>

LOCAL : La catégorie de données Traduire peut utiliser le balisage local suivant :

• Un attribut translate avec la valeur "yes" ou "no".

<messages
  xmlns:its="http://www.w3.org/2005/11/its" 
  its:version="1.0">
 <msg num="123">Click Resume Button on Status Display or  
    <panelmsg
    its:translate="no">CONTINUE</panelmsg> Button
    on printer panel</msg>
</messages>

6.2.3 Les déclarations de balisage pour la catégorie Traduire

translateRule

[27]	translateRule	::=	element its:translateRule { translateRule.content, translateRule.attributes }
[28]	translateRule.content	::=	empty
[29]	translateRule.attributes	::=	att.selector.attributes, attribute translate { "yes" | "no" }

att.translate

[30]	att.translate.attributes	::=	att.translate.attribute.translate
[31]	att.translate.attribute.translate	::=	attribute its:translate { "yes" | "no" }?

6.3.1 Définition

La catégorie de données Note de localisation est utilisée pour communiquer des notes à propos d'un élément de contenu particulieur aux traducteurs (localizers).

Cette catégorie de données peut avoir plusieurs utilisations, y compris mais non limité à :

• Dire au traducteur comment traduire des parties du contenu ;

• Développer la signification ou l'utilisation contextuelle d'un élément spécifique, par exemple, à quoi se rapporte une variable ou comment une chaîne sera utilisée dans l'interface d'utilisateur ;

• Lever une ambiguïté et montrer suffisamment les relations entre les éléments pour une traduction exacte (par exemple, dans beaucoup de langues, il est impossible de traduire le qualificatif anglais « enabled » isolément sans connaître le genre, le nombre et le cas de l'objet auquel il se rapporte) ;

• Indiquer pourquoi un morceau de texte est mis en exergue (important, sarcastique, etc.)

Deux types de notes informatives sont nécessaires :

• Une alerte contenant des informations que le traducteur doit lire avant de traduire un morceau de texte. Exemple : une instruction au traducteur aux traducteurs de laisser des parties du texte dans le langage source.

• Un description fournissant une information de base à laquelle le traducteur se référera les traducteurs se référeront uniquement si besoin. Exemple : la levée d'une ambiguïté dans le texte source.

Les outils d'édition peuvent offrir un moyen pratique de créer ce type d'information. Les outils de traduction peuvent être conçus pour distinguer ces deux types de notes de localisation et présenter les informations aux traducteurs de différentes façons.

6.3.2 Mise en œuvre

La catégorie de données Note de localisation peut s'exprimer avec des règles globales ou localement sur un élément individuel. L'information s'applique au contenu textuel de l'élément, incluant les sous-éléments mais excluant les attributs.

GLOBAL : L'élément locNoteRule présente le contenu suivant :

• Un attribut selector obligatoire. Celui-ci contient une expression XPath sélectionnant les nœuds auxquels cette règle s'applique ;

• Un attribut locNoteType obligatoire avec la valeur "description" ou "alert" ;

• Un seul exactement des suivants :

  • Un élément locNote qui contient la note en question et autorise un balisage ITS local ;

  • Un attribut locNotePointer contenant une expression XPath relative qui pointe vers un nœud contenant la note de localisation ;

  • Un attribut locNoteRef qui contient une adresse URI indiquant l'emplacement de la note de localisation ;

  • Un attribut locNoteRefPointer contenant une expressions XPath relative qui pointe vers un nœud contenant l'adresse URI indiquant l'emplacement de la note de localisation.

<myRes
  xmlns:its="http://www.w3.org/2005/11/its" >
 <head>
  <its:rules version="1.0"
    its:translate="no">
   <its:locNoteRule locNoteType="alert" selector="//msg[@id='DisableInfo']">
    <its:locNote>The variable {0} has three possible values: 'printer', 
        'stacker' and 'stapler options'.</its:locNote>
   </its:locNoteRule>
  </its:rules>
 </head>
 <body>
  <msg id="DisableInfo">The {0} has been disabled.</msg>
 </body>
</myRes>

<Res
  xmlns:its="http://www.w3.org/2005/11/its" >
 <prolog>
  <its:rules version="1.0">
   <its:translateRule selector="//msg/notes" translate="no"/>
   <its:locNoteRule locNoteType="description" selector="//msg/data" locNotePointer="../notes"/>
  </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>

<myRes
  xmlns:its="http://www.w3.org/2005/11/its" >
 <head>
  <its:rules version="1.0">
   <its:locNoteRule locNoteType="description" selector="//msg[@id='NotFound']" locNoteRef="ErrorsInfo.html#NotFound"/>
  </its:rules>
 </head>
 <body>
  <msg id="NotFound">Cannot find {0} on {1}.</msg>
 </body>
</myRes>

<dataFile
  xmlns:its="http://www.w3.org/2005/11/its" >
 <prolog>
  <its:rules version="1.0">
   <its:locNoteRule locNoteType="description" selector="//data" locNoteRefPointer="../@noteFile"/>
  </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>
</dataFile>

LOCAL : La catégorie de données Note de localisation peut utiliser le balisage local suivant :

• L'un des suivants :

  • Un attribut locNote contenant la note en question ;

  • Un attribut locNoteRef qui contient une adresse URI référençant l'emplacement de la note de localisation.

• Un attribut locNoteType optionnel avec la valeur "description" ou "alert". Si l'attribut locNoteType est absent, la note de localisation sera censé de type "description".

<msgList
  xmlns:its="http://www.w3.org/2005/11/its"  xml:space="preserve"
  its:version="1.0">
 <data name="LISTFILTERS_VARIANT"
   its:locNote="Keep the leading space!"
   its:locNoteType="alert">
  <value> Variant {0} = {1} ({2})</value>
 </data>
 <data
   its:locNote="%1\$s is the original text's date in the format YYYY-MM-DD HH:MM always in GMT">
  <value>Translated from English content dated <span id="version-info">%1\$s</span> GMT.</value>
 </data>
</msgList>

6.3.3 Les déclarations de balisage pour la catégorie Note de localisation

locNoteRule

[32]	locNoteRule	::=	element its:locNoteRule { locNoteRule.content, locNoteRule.attributes }
[33]	locNoteRule.content	::=	locNote?
[34]	locNoteRule.attributes	::=	att.selector.attributes, attribute locNotePointer { string }?, attribute locNoteType { "alert" | "description" }, attribute locNoteRef { xsd:anyURI }?, attribute locNoteRefPointer { string }?

locNote

[35]	locNote	::=	element its:locNote { locNote.content, locNote.attributes }
[36]	locNote.content	::=	( text | ruby | span )*
[37]	locNote.attributes	::=	att.local.no-ns.attributes

att.locNote

[38]	att.locNote.attributes	::=	att.locNote.attribute.locNote, att.locNote.attribute.locNoteType, att.locNote.attribute.locNoteRef
[39]	att.locNote.attribute.locNote	::=	attribute its:locNote { string }?
[40]	att.locNote.attribute.locNoteType	::=	attribute its:locNoteType { "alert" | "description" }?
[41]	att.locNote.attribute.locNoteRef	::=	attribute its:locNoteRef { xsd:anyURI }?

6.4.1 Définition

La catégorie de données Terminologie sert à marquer des termes et, en option, les associer à des informations, telles que des définitions. Cela permet d'améliorer la cohérence à travers les différentes parties de la documentation. Elle est aussi utile pour la traduction.

6.4.2 Mise en œuvre

La catégorie de données Terminologie peut s'exprimer avec des règles globales ou localement sur un élément individuel. Il n'y a pas d'héritage. Par défaut, ni les éléments ni les attributs sont des termes.

GLOBAL : L'élément termRule présente le contenu suivant :

• Un attribut selector obligatoire. Celui-ci contient une expression XPath sélectionnant les nœuds auxquels cette règle s'applique ;

• Un attribut term obligatoire avec la valeur "yes" ou "no" ;

• Un seul exactement des suivants :

  • Un attribut termInfoPointer contenant une expression XPath relative qui pointe vers un nœud contenant l'information de terminologie ;

  • Un attribut termInfoRef contenant une adresse URI qui référence la ressource fournissant l'information à propos du terme ;

  • Un attribut termInfoRefPointer contenant une expression XPath relative qui pointe vers un nœud contenant l'adresse URI référençant l'emplacement de l'information de terminologie.

<text
  xmlns:its="http://www.w3.org/2005/11/its" >
 <its:rules version="1.0">
  <its:termRule selector="//term" term="yes" termInfoPointer="id(@def)"/>
 </its:rules>
 <p>We may define <term def="TDPV">discoursal point of view</term>
 as <gloss xml:id="TDPV">the relationship, expressed through discourse
  structure, between the implied author or some other addresser,
  and the fiction.</gloss>
 </p>
</text>

<text
  xmlns:its="http://www.w3.org/2005/11/its" >
 <its:rules version="1.0">
  <its:termRule selector="//term[1]" term="yes" termInfoRef="#TDPV"/>
 </its:rules>
 <p>We may define <term>discoursal point of view</term>
 as <gloss xml:id="TDPV">the relationship, expressed through discourse
  structure, between the implied author or some other addresser,
  and the fiction.</gloss>
 </p>
</text>

<text
  xmlns:its="http://www.w3.org/2005/11/its" >
 <its:rules version="1.0">
  <its:termRule selector="//term" term="yes" termInfoRefPointer="@target"/>
 </its:rules>
 <p>We may define <term target="#TDPV">discoursal point of view</term>
 as <gloss xml:id="TDPV">the relationship, expressed through discourse
  structure, between the implied author or some other addresser,
  and the fiction.</gloss>
 </p>
</text>

LOCAL : La catégorie de données Terminologie peut utiliser le balisage local suivant :

• Un attribut term avec la valeur "yes" ou "no" ;

• Un attribut termInfoRef optionnel contenant une adresse URI qui référence la ressource fournissant l'information à propos du terme.

<book
  xmlns:its="http://www.w3.org/2005/11/its" 
  its:version="1.0">
 <head>...</head>
 <body> ...  <p>And he said: you need a
   new <quote
     its:term="yes">motherboard</quote>
  </p> ...
  </body>
</book>

6.4.3 Les déclarations de balisage pour la catégorie Terminologie

termRule

[42]	termRule	::=	element its:termRule { termRule.content, termRule.attributes }
[43]	termRule.content	::=	empty
[44]	termRule.attributes	::=	att.selector.attributes, attribute term { "yes" | "no" }, attribute termInfoRef { xsd:anyURI }?, attribute termInfoRefPointer { string }?, attribute termInfoPointer { string }?

att.term

[45]	att.term.attributes	::=	att.term.attribute.termInfoRef, att.term.attribute.term
[46]	att.term.attribute.termInfoRef	::=	attribute its:termInfoRef { xsd:anyURI }?
[47]	att.term.attribute.term	::=	attribute its:term { "yes" | "no" }?

6.5.1 Définition

La catégorie de données Directionnalité permet à l'utilisateur de définir le direction d'écriture de base (base writing direction) des blocs, incorporations (embeddings) et dérogations (overrides) pour l'algorithme bidirectionnel Unicode. Elle a quatre valeurs : "ltr", "rtl", "lro" et "rlo".

6.5.2 Mise en œuvre

La catégorie de données Directionnalité peut s'exprimer avec des règles globales ou localement sur un élément individuel. L'information s'applique au contenu textuel de l'élément, incluant les sous-éléments et les attributs. Par défaut, les éléments et les attributs ont un sens d'écriture (directionality) de gauche-à-droite.

GLOBAL : L'élément dirRule présente le contenu suivant :

• Un attribut selector obligatoire. Celui-ci contient une expression XPath sélectionnant les nœuds auxquels cette règle s'applique ;

• Un attribut dir obligatoire avec la valeur "ltr", "rtl", "lro" ou "rlo".

<text xml:lang="en">
 <body>
  <par>In Hebrew, the title <quote xml:lang="he" direction="rtlText">פעילות הבינאום, W3C</quote>
     means <quote>Internationalization Activity, W3C</quote>.</par>
 </body>
</text>

<its:rules
  xmlns:its="http://www.w3.org/2005/11/its"  version="1.0">
 <its:dirRule dir="rtl" selector="//*[@direction='rtlText']"/>
</its:rules>

LOCAL : La catégorie de données Directionnalité peut utiliser le balisage local suivant :

• Un attribut dir avec la valeur "ltr", "rtl", "lro" ou "rlo".

<text
  xmlns:its="http://www.w3.org/2005/11/its"  xml:lang="en"
  its:version="1.0">
 <body>
  <par>In Arabic, the title <quote xml:lang="ar"
     its:dir="rtl">نشاط التدويل، W3C</quote>
     means <quote>Internationalization Activity, W3C</quote>.</par>
 </body>
</text>

6.5.3 Les déclarations de balisage pour la catégorie Directionnalité

dirRule

[48]	dirRule	::=	element its:dirRule { dirRule.content, dirRule.attributes }
[49]	dirRule.content	::=	empty
[50]	dirRule.attributes	::=	att.selector.attributes, attribute dir { "ltr" | "rtl" | "lro" | "rlo" }

att.dir

[51]	att.dir.attributes	::=	att.dir.attribute.dir
[52]	att.dir.attribute.dir	::=	attribute its:dir { "ltr" | "rtl" | "lro" | "rlo" }?

6.6.1 Définition

La catégorie de données Ruby est utilisée pour un morceau de texte (run of text) associé à un autre morceau de texte, appelé texte de base. Le texte ruby sert à fournir une annotation brève du texte de base associé. On l'utilise presque toujours comme guide pour la lecture (prononciation).

6.6.2 Mise en œuvre

La catégorie de données Ruby peut s'exprimer avec des règles globales ou localement. Il n'y a pas d'héritage.

GLOBAL : L'élément rubyRule présente le contenu suivant :

• Un attribut selector obligatoire. Celui-ci contient une expression XPath sélectionnant les nœuds auxquels cette règle s'applique. C'est le texte de base du ruby ;

• Un attribut rubyPointer optionnel contenant une expression XPath relative qui pointe vers un nœud correspondant à l'élément ruby ;

• Un attribut rpPointer optionnel contenant une expression XPath relative qui pointe vers un nœud correspondant à la parenthèse ruby (ruby parenthesis) ;

• Un attribut rbcPointer optionnel contenant une expression XPath relative qui pointe vers un nœud correspondant au conteneur de base ruby (ruby base container) ;

• Un attribut rtcPointer optionnel contenant une expression XPath relative qui pointe vers un nœud correspondant au conteneur de texte ruby (ruby text container) ;

• Un attribut rbspanPointer optionnel contenant une expression XPath relative qui pointe vers un nœud correspondant à l'attribut rbspan ;

• Un élément rubyText optionnel contenant le texte ruby ;

• Un attribut rtPointer optionnel contenant une expression XPath relative qui pointe vers un nœud correspondant au texte ruby (ruby text).

<text
  xmlns:its="http://www.w3.org/2005/11/its" >
 <head> ... 
   <its:rules version="1.0">
   <its:rubyRule selector="/text/body/img[1]/@alt">
    <its:rubyText>World Wide Web Consortium</its:rubyText>
   </its:rubyRule>
  </its:rules>
 </head>
 <body>
  <img src="w3c_home.png" alt="W3C"/> ...
  </body>
</text>

LOCAL : Dans un document, la catégorie de données Ruby est réalisée avec un élément ruby. Celui-ci présente le contenu suivant :

• Un élément rb qui contient le texte de base ruby et autorise un balisage ITS local ;

• Un élément rp qui contient la parenthèse ruby. On l'utilise dans un balisage simple pour indiquer les caractères qui peuvent dénoter le début et la fin du texte ruby lorsque les agents utilisateurs n'ont pas d'autres moyens pour distinguer le texte ruby du texte du texte de base à la présentation ;

• Un élément rt qui contient le texte ruby et autorise un balisage ITS local. Il a un attribut rbspan optionnel. L'attribut rbspan permet à un élément rt de couvrir (span) plusieurs éléments rb ;

• Un élément rbc qui contient le conteneur de base ruby ;

• Un élément rtc qui contient le conteneur de texte ruby.

Tous ces éléments partagent les attributs de l'élément span.

<text
  xmlns:its="http://www.w3.org/2005/11/its" 
  its:version="1.0">
 <head> ... </head>
 <body>
  <p>この本は <its:ruby>
    <its:rb>慶応義塾大学</its:rb>
    <its:rp>(</its:rp>
    <its:rt>けいおうぎじゅくだいがく</its:rt>
    <its:rp>)</its:rp>
   </its:ruby>の歴史を説明するものです。</p>
 </body>
</text>

6.6.3 Les déclarations de balisage pour la catégorie Ruby

rubyRule

[53]	rubyRule	::=	element its:rubyRule { rubyRule.content, rubyRule.attributes }
[54]	rubyRule.content	::=	rubyText?
[55]	rubyRule.attributes	::=	att.selector.attributes, attribute rubyPointer { string }?, attribute rtPointer { string }?, attribute rpPointer { string }?, attribute rbcPointer { string }?, attribute rtcPointer { string }?, attribute rbspanPointer { string }?

rubyText

[56]	rubyText	::=	element its:rubyText { rubyText.content, rubyText.attributes }
[57]	rubyText.content	::=	text
[58]	rubyText.attributes	::=	att.local.no-ns.attributes, attribute rbspan { string }?

ruby

[59]	ruby	::=	element its:ruby { ruby.content, ruby.attributes }
[60]	ruby.content	::=	( rb, ( rt | ( rp, rt, rp ) ) ) | ( rbc, rtc, rtc? )
[61]	ruby.attributes	::=	att.local.no-ns.attributes

rb

[62]	rb	::=	element its:rb { rb.content, rb.attributes }
[63]	rb.content	::=	( text | span )*
[64]	rb.attributes	::=	att.local.no-ns.attributes

rt

[65]	rt	::=	element its:rt { rt.content, rt.attributes }
[66]	rt.content	::=	( text | span )*
[67]	rt.attributes	::=	att.local.no-ns.attributes, attribute rbspan { string }?

rbc

[68]	rbc	::=	element its:rbc { rbc.content, rbc.attributes }
[69]	rbc.content	::=	rb+
[70]	rbc.attributes	::=	att.local.no-ns.attributes

rtc

[71]	rtc	::=	element its:rtc { rtc.content, rtc.attributes }
[72]	rtc.content	::=	rt+
[73]	rtc.attributes	::=	att.local.no-ns.attributes

rp

[74]	rp	::=	element its:rp { rp.content, rp.attributes }
[75]	rp.content	::=	text
[76]	rp.attributes	::=	att.local.no-ns.attributes

6.7.1 Définition

L'élément langRule sert à exprimer la langue d'une partie donnée du contenu. L'attribut langPointer pointe vers le balisage qui exprime la langue du texte sélectionné par l'attribut selector. Ce balisage DOIT utiliser des valeurs conformes au standard [BCP47]. La méthode recommandée pour indiquer une identification de langue est d'utiliser l'attribut xml:lang. L'élément langRule est seulement prévu comme mécanisme de repli pour les documents où la langue est identifiée à l'aide d'un autre concept (construct).

<its:rules
  xmlns:its="http://www.w3.org/2005/11/its"  version="1.0">
 <its:langRule selector="//p" langPointer="@mylangattribute"/>
</its:rules>

6.7.2 Mise en œuvre

La catégorie de données Information de langue peut seulement s'exprimer avec des règles globales. L'information s'applique au contenu textuel de l'élément, incluant les sous-éléments et les attributs. Il n'y a aucune valeur par défaut.

GLOBAL : L'élément langRule présente le contenu suivant :

• Un attribut selector obligatoire. Celui-ci contient une expression XPath sélectionnant les nœuds auxquels cette règle s'applique ;

• Un attribut langPointer obligatoire contenant une expression XPath relative qui pointe vers un nœud contenant l'information de langue.

6.7.3 Les déclarations de balisage pour la catégorie Information de langue

langRule

[77]	langRule	::=	element its:langRule { langRule.content, langRule.attributes }
[78]	langRule.content	::=	empty
[79]	langRule.attributes	::=	att.selector.attributes, attribute langPointer { string }

6.8.1 Définition

La catégorie de données Éléments dans du texte révèle si et comment un élément affecte le comportement d'un contenu textuel d'un point de vue linguistique. Cette information est pertinente, par exemple, pour fournir des indications de segmentation de texte de base à des outils tels que les systèmes de mémoire de traduction (translation memory systems). Les valeurs associées à cette catégorie de données sont les suivantes :

• "yes" : L'élément et son contenu font partie du flux de l'élément parent. Par exemple, l'élément strong dans [XHTML 1.0]:

  <strong>Appaloosa horses</strong> have spotted coats.

• "nested" : L'élément fait partie du flux de l'élément parent, son contenu est un flux indépendant. Par exemple, l'élément fn dans [DITA 1.0] :

  Palouse horses<fn>A Palouse horse is the same as an Appaloosa.</fn> have spotted coats.

• "no" : L'élément coupe le flux de texte de l'élément parent et son contenu est un flux de texte indépendant. Par exemple, l'élément p lorsqu'il se trouve dans un élément li dans DITA ou XHTML :

  <li>Palouse horses: <p>They have spotted coats.</p> <p>They have been bred by the Nez Perce.</p> </li>

6.8.2 Mise en œuvre

La catégorie de données Éléments dans du texte ne peut s'exprimer qu'avec des règles globales. Il n'y a pas d'héritage. Par défaut, les éléments ne sont pas dans du texte.

GLOBAL : L'élément withinTextRule présente le contenu suivant :

• Un attribut selector obligatoire. Celui-ci contient une expression XPath sélectionnant les nœuds auxquels cette règle s'applique ;

• Un attribut withinText obligatoire avec la valeur "yes", "no" ou "nested".

<its:rules
  xmlns:its="http://www.w3.org/2005/11/its"  version="1.0">
 <its:withinTextRule withinText="yes" selector="//b | //em | //i"/>
</its:rules>

6.8.3 Les déclarations de balisage pour la catégorie Éléments dans du texte

withinTextRule

[80]	withinTextRule	::=	element its:withinTextRule { withinTextRule.content, withinTextRule.attributes }
[81]	withinTextRule.content	::=	empty
[82]	withinTextRule.attributes	::=	att.selector.attributes, attribute withinText { "yes" | "no" | "nested" }