Description des fichiers d'Up ! Natural Language Support

Introduction

Les ressources linguistiques sont stockées dans les fichiers Nls d'extension nls rangés par défaut dans le répertoire ${UPS_HOME}/upsnls/${UPS_LANGUAGE}.

La langue choisie correspond à la variable environnement UPS_LANGUAGE. Sa valeur est l'une des suivantes :

ValeurSémantique
ArabicLangue arabe.
ChineseLangue chinoise.
EnglishLangue anglaise.
GermanLangue allemande.
ItalianLangue italienne.
JapaneseLangue japonaise.
PortugueseLangue portuguese.
SpanishLangue espagnole.
RussianLangue russe.

La valeur par défaut est English.

A chaque module peut être associé un fichier Nls. En ce cas, le fichier Nls porte le même nom que le module. Up ! Natural Language Support se charge de la gestion de ces fichiers, en particulier leur chargement et leur exploitation au travers des API présentées dans ce manuel. Ces fichiers Nls comportent différentes sections classifiant les informations.

Les fichiers Nls doivent accessibles via la variable environnement obligatoire UPS_NLS qui n'a pas de valeur par défaut. Cette variable contient une liste de répertoires séparés par un caractère point-virgule : ou deux-points : selon la plate-forme. A chaque répertoire cité dans la valeur de cette variable, Up ! Natural Language Support adjoint le sous-répertoire correspondant à la langue de la configuration de l'utilisateur.

Une section d'un fichier Nls comporte une succession d'entrées identifiées par des mots-clé immuables quelle que soit la langue choisie. Les mots-clés doivent être deux à deux distincts pour une section. A chaque mot-clé est associé un texte correspondant à la traduction dans la langue de l'utilisateur. Voici les sections supportées :

Il est possible de partager un fichier de ressources linguistiques entre plusieurs modules d'un même application, voire entre plusieurs applications. Cela s'effectue au moyen d'un thésaurus, qui n'est pas rattaché à un module particulier.

Les thésaurus sont conservés dans le répertoire ${UPS_HOME}/upsnls/${UPS_LANGUAGE}. Le thésaurus sélectionné est celui indiqué par le paramètre thesaurus.

Exemple

Voici un exemple correspondant au module Up ! System :

[Miscellaneous]
Oui=oui
Vrai=vrai
Groupe=groupe

[Message]
CreationImpossible=012345Erreur %s-1 : Impossible de créer '%s'.
SuppressionImpossible=012345Erreur %s-2 : Impossible d'effacer '%s'.
ChangementRepertoireImpossible=012345Erreur %s-3 : Impossible de changer de répertoire dans '%s'.
RepertoireCourantImpossible=012345Erreur %s-4 : Impossible de lire le répertoire courant.
RenommageImpossible=012345Erreur %s-5 : Impossible de renommer '%s' en '%s'.
ExecutionImpossible=012345Erreur %s-6 : Impossible d'exécuter '%s' : %s.
ChangementDroitDAccesImpossible=012345Erreur %s-7 : Impossible de changer les droits de '%s'.
LireDroitDAccesImpossible=012345Erreur %s-8 : Impossible de lire les droits de '%s'.
AlarmeImpossible=012345Erreur %s-9 : Impossible de poser une alarme.
LireCaracteristiquesImpossible=012345Erreur %s-10 : Impossible de lire les caracteristiques de '%s'.
ArretImpossible=012345Erreur %s-11 : Impossible d'arrêter le processus '%s'.
LireCodeRetourImpossible=012345Erreur %s-12 : Impossible de lire le code-retour du processus '%s'.
LireTempsImpossible=012345Erreur %s-13 : Impossible de lire les temps d'exécution du processus.
CopieImpossible=012345Erreur %s-14 : Impossible de copier '%s' en '%s'.

[Api]
Ecran=Ecran
FichierListe=FichierListe
ProcessusListe=ProcessusListe
UniteListee=UniteListee