Pointui Home 2 - Traduction (substitution de termes)

Modifié le mardi, 10 février 2009 20:39 par Montecristoff — Catégorisé en: Pointui Home

Substitution de termes

Afin de supporter d'autres langue que l'anglais, Pointui Home 2 offre des possibilités de substitution de termes qui permettent de réaliser simplement des traductions du logiciel. Ces substitutions sont réalisées au travers de l'objet global Terms. Les termes sont définis dans des fichiers xml. Pointui fournira au minimum un fichier xml contenant les termes en anglais (sans correspondance dans une autre langue). Typiquement, le fichier xml est appelé "Terms.xml" et est localisé dans chaque dossier 'Applet' ou 'Theme'. Il est aussi possible d'utiliser plusieurs fichiers xml pour une même applet. Une applet peut donc être développée pour supporter plusieurs langues et offrir à l'utilisateur la possibilité d'en choisir un. A ce moment-là, l'applet chargera le fichier xml correspondant au langage sélectionné.

Remarque : seuls les langages compatibles avec la norme de caractères ASCII sont actuellement pris en compte dans Home 2. Dans le futur, lorsque le rendu graphique GDI sera intégré au Revolution Engine™, les langages Unicode seront reconnus.

Format XML du fichier Terms.xml

Le format de ce fichier est identique à celui utilisé pour les version précédentes de Pointui Home.
Voilà un exemple :

Image

Chaque terme représente un noeud dans le fichier xml. Si une valeur traduite de ce terme est présente, elle remplacera le terme original utilisé.

La substitution de termes permet de fournir des versions multilangues, mais elle offre également la possibilité de définir des réglages spécifiques suivant le langage d'origine de l'appareil ou encore suivant le modèle.
Par exemple, si un chemin spécifique est nécessaire pour lancer une application tierce présente d'origine dans l'appareil, il est possible de définir un terme comme suit :

Image

Pour utiliser ce terme dans votre script, vous pouvez alors utiliser le code suivant :

String applicationALancer;
appliALancer= Terms.Get("Slideshow.Application.Filename");
Process.Start(applicationALancer);

Utilisation des termes dans les applets

Pour utiliser des termes dans vos applets, vous devez simplement charger les fichiers xml correspondants.
Voici un exemple :

class SlideshowApplet : Applet
{
	void Load()
	{
		Terms.LoadFromFile("French.xml");
		Terms.LoadFromFile("CustomPaths.xml");
	}
}

Le code ci-dessus cherchera dans le dossier de l'applet Slideshow et importera tous les termes du fichier "French.xml" qui sont définis comme devant contenir la traduction française des termes utilisés dans l'applet.
De plus, ce script va importer tous les termes contenus dans le fichier "CustomPaths.xml". Tous les termes définis dans le fichier "French.xml" et également présents dans "CustomPaths.xml" seront "écrasés" (disons remplacés) par la valeur contenue dans le fichier "CustomPaths.xml".