Internationalisation/Localisation des documents XML Internationalization Tag Set (V1.0)

Najib Tounsi

Ecole Mohammadia d'Ingénieurs
Bureau W3C Rabat (World Wide Web Consortium)

Novembre 2008

http://www.w3c.org.ma/Talks/ircam2008/its.html

Internationalisation/Localisation des documents XML

ITS

• ITS 1.0: "Internationalization Tag Set (ITS)  Version 1.0"
  http://www.w3.org/TR/its
• Recommandation W3C (April 2007),
  Défini par le Groupe de Travail ITS / i18n du W3C
  http://www.w3.org/International/its

Motivations

• XML,  moyen répandu d'expression de contenu
• l10n et i18n de ces documents
• Exemple de pb: traduire certaines parties et pas d'autres.
  

  <Livre> ...
  
   <p> Elle a parlé en anglais et dit: <quote>thank you.</quote>
  
   </p>...
  
  </Livre>
  

• Besoin de mécanisme standard pour identifier les parties à (ne pas) traduire
  

  <Livre> ...
  
   <p> Elle a parlé en anglais et dit: 
  
   <quote its:translate="no">thank you.</quote>
  
   </p>...
  
  </Livre>
  

• La spécification ITS définit un vocabulaire standard destiné à l10n i18n de documents XML
• Principalement sous forme d'éléments et d'attributs XML.

Objectifs de ITS

• Cible:  Documents et Schémas XML
• But: Fournir les  informations ("data categories") pour  l'internationalisation et la localisation de  Documents et Schémas XML

Audience / Usage Scenarios

• Créateurs de contenus  (indiquer les informations pour l10n et i18n)
• Développeurs d'outils  auteurs
• Support pour la traduction et les terminologies 
• Développement de logiciels (documentation crée en XML)
• ...

Exigences pour ITS

• Intégration dans schémas existants / créer de nouveaux schémas
• ITS est défini de façon indépendante des langages  existants
• Notions de "Data categories" qui conceptualise les besoins
• La spécification ITS 1.0 est accompagée d'un autre document du Groupe de Travail
  "Best Practices for XML Internationalization"
• http://www.w3.org/TR/xml-i18n-bp/

ITS 1.0 Data Categories

• Translate: pour séparer ce qui est traduisible de ce qui l'est pas
• Localization Notes: pour passer un message aux localiseurs
• Terminology: pour identifier les termes et éventuellement leur d'associer une définition
• Directionality: pour pouvoir spécifier le sens d'écriture du texte et l'application ou non de l'algorithme bidi Unicode
• Ruby: passage de texte servant à "commenter" un autre passage de texte
• Language Information: pour indiquer le langage d'une partie de texte
• Elements within Text: pour spécifier si un élément XML (sous texte) peut être considéré indépendant (e.g. <p> dans <li>) de l'élément englobant

Exemple de Data category: "Translate"

• Certaines parties du document  ne sont pas à traduire:

   <Livre> ...
  
   <p> Elle a parlé en anglais et dit: 
  
   <quote its:translate="no">thank you.</quote>
  
   </p>...
  
   </Livre>
  

• Par défaut tous les éléments d'un document XML sont à traduire. L'attribut its:translate (avec la valeur "no") est introduit pour indiquer une exception à cette règle.

Pourquoi les Data Categories?

1. Description verbose de la nature de la catégorie ITS (exemple traduction)
2. Implémentation de façon indépendante d'un language de schéma
3. La declaration dans un langage particulier (DTDs, XML Schema, RELAX NG)

Exemple pour "Translate"

1. Description verbose de la Data category:
   "Parties de document (ne) devrait (pas) être traduites."
   
2. Implementation indépendante d'un langage de Schéma
   

   <livre its:translate="yes"…>... </livre>
   

3.  Déclaration dans un langage spécifique (langage XML DTD ici)
   

   <!ELEMENT livre … >
   
   <!ATTLIST livre its:translate (yes|no) #IMPLIED>
   

Exemple: "Localization Note"

1. Description verbose de la Data category:
   "Fournir des informations aux localiseurs"
   
2. Implementation indépendante d'un langage de Schéma
   

   <livre its:locNote="attention usage car. ctrl unicode">
   
   its:locNoteType="alert"> ... </livre>
   
   

3. Déclaration dans un langage spécifique (langage XML DTD ici)
   

   <!ELEMENT livre … >
   
   <!ATTLIST livre its:locNote CDATA ...>
   

4. its: locNote pour donner une information utile au localiseur. 
5. its: locNoteType est le type de note "alert" ou "description"

Usage local ou global

• Exemples vus, usage local de ITS 1.0 data categories
• Usage global, sous forme de règles appliquées à tout le document (e.g. les éléments <code>... </code> ne sont pas à traduire)
• Correspondance entre les data categories et un balisage 'équivalent' existant
• Pointeur vers des valeurs déjà existantes

Usage global: exemple 

• XPath permet de sélectionner toute(s) partie(s) d'un document XML.
• Utilisé dans les règles globales

<monDocument …> …

 <its:rules …>

 <its:translateRule … translate="no"

 selector="//p[@editor='Untel']"/></its:rules …>

 <!-- règle s'applique aux éléments <p> édités par Untel.

 --> …

</monDocument>

• Expression XPath, pour sélectionner les parties à atteindre par translate="no"
• Apparition de l'information de façon globale au document
• D'autres éléments règles: locNoteRule, termRule, dirRule, …
  

Combinaison global/local

<livre …><its:rules …>

 <its:translateRule translate="no"

 selector="//quote"/></its:rules>

 <body> ...

 <p>Il a dit: je cherche 

 <quote its:translate="yes">le bureau des objets perdus</quote>

 </p> ... </body>

</livre>

• Ici, on a exprimé une règle globale que le contenu de tous les éléments <quote> ne doit pas être traduit.
• Exception faite pour certains endroits.

Correspondance avec un autre balisage

<livre …><its:rules …>

 <its:translateRule

 translate="no" selector="//*[@dita:translate='no']"/>

 <its:termRule term="yes" selector="//quote"/></its:rules>

 <body> ...

 <p>Il a dit: je cherche 

 <quote dita:translate="no">le bureau des objets perdus</quote>

 </p> ... </body>

</livre>

• A l'attribut translate="no" dans  <its:translateRule>  correspond l'attribut dita:translate="no" de DITA (vocabulaire XML répandu  pour documentation technique). 
• L'attribut term="yes" implemente la data category "Terminology". Il est associé à tous les éléments <quote>.  
• Ce mécanisme de correspondance permet de réutiliser le balisage d'un vocabulaire XML déjà défini, (e.g. DITA) et donc d'appliquer ITS sans impacter un document XML existant.

Autre mécanisme similaire

• Pointer vers des valeurs déjà existantes, exemple une note de localisation

<monDocument …>

 <its:rules …>

 <its:locNoteRule

 locNoteType="alert" selector="//*[@loc-n]"

 locNotePointer="@loc-n"/>…</its:rules>

 ...

 <span loc-n="…">…</span>

 …

</monDocument>

• data category "Localization Note".
• L'attribut locNotePointer de l'élément <its:locNoteRule> est là pour faire référence à la valeur de l'attribut loc-n  .

Conclusion

MERCI

• Le standard ITS 1.0: http://www.w3.org/TR/its ou http://www.w3.org/International/its
• Les Bonnes Pratique pour i18n dans XML: http://www.w3.org/TR/xml-i18n-bp/
• Site du W3C: http://www.w3.org
• W3C Maroc: http://www.w3.org.ma