Précédent | Sommaire | Suivant

4.10 Langues multiples

Depuis la version 2, NSIS supporte pleinement plusieurs langues. Une installation peut ainsi avoir plus d'une langue.

Utilisez LoadLanguageFile pour chaque langue dont il faille charge les textes de l'interface et les propriétés de la langue.

Les textes de l'interface par défaut peuvent être facilement modifiés en utilisant des instructions comme ComponentText etc.

Vous pouvez aussi utiliser le contenu des chaînes de langue standards dans votre propres chaînes (par exemple, $(^Name) contient le nom de l'installation définit par l'instruction Name). Les noms de toutes les chaînes de langue sont listés en commentaire juste au-dessus des chaînes dans les fichiers de langue. Les fichiers de langue sont situés dans Contrib\Language Files.

Pour créer vos propres chaînes de langue, utilisez LangString.

Pour un exemple d'installation comprenant plusieurs langues, voir languages.nsi.

4.10.1 Sélection de la langue

Lorsque l'installation démarre, elle passe par trois étapes pour sélectionner la langue de l'interface :

1. Récupération de la langue par défaut de l'interface utilisateur Windows
2. Recherche d'une correspondance exacte pour la langue
3. S'il n'existe aucune correspondance exacte, recherche de la langue primaire correspondante
4. S'il aucune ne correspond, utilisation de la première langue définie dans le script (vérifiez que la première langue est assez connue, comme l'anglais)
5. Si la variable de langue $LANGUAGE a été modifiée pendant .onInit, NSIS réitère les étapes 2 à 4.

4.10.2 Le plugin LangDLL

Le plugin LangDLL vous permet de donner la possibilité à l'utilisateur de choisir la langue de l'installation. Placez (Push) simplement l'identifiant de la variable (${LANG_langfile}) et son nom pour chaque langue de votre installation, puis le nombre de langues et ensuite le texte demandant à l'utilisateur de sélectionner la langue. Appelez la fonction du plugin nommée LangDialog, récupérez la valeur de retour dans $LANGUAGE et vous êtes bons pour continuer. Si l'utilisateur clique sur Annuler, la valeur de retour sera "cancel".

Pour un exemple d'utilisation, voir languages.nsi.

4.10.3 Les langues RTL

Les langues RTL sont des langues écrites de droite à gauche (comme l'arabe et l'hébreux). NSIS supporte totalement les langues RTL. Dans le fichier de langue, il y a un endroit pour spécifier si la langue est ou pas RTL. Pour savoir si la langue courante est RTL, vérifiez la valeur de la chaîne de langue $(^RTL). Elle doit être à 1 si la langue est RTL et 0 sinon. Cela peut être utile pour les plugins qui créés des fenêtres, et qui ont souvent aussi un paramètre RTL.

Précédent | Sommaire | Suivant