Translating/fr

{{#customtitle:Comment traduire Gestinux}}

anglais

Cette page explique comment traduire gestinux, sans connaissances particulières en programmation Lazarus ou autre.

Nous vous demandons de ne traduire que vers votre langue maternelle. Idéalement, il faut comprendre le français car c'est la langue originale de gestinux.

Traduire le programme

Seule la version 1.0 de gestinux doit être traduite et ce qui suit ne concerne qu'elle.

Si vous êtes développeur et comprenez l'anglais, vous pouvez consulter les mécanismes internes de traduction pour en savoir plus.

Les codes de langues

Avant d'entamer une nouvelle traduction, vous devez déterminer le code de la langue à traduire.

Les langues sont identifiées dans gestinux selon la norme POSIX par un double code, de la forme xx_YY.

La première partie xx en minuscules identifie la langue principale, selon la norme ISO-639-1 La seconde partie YY en majuscules identifie une variante possible, généralement avec le code d'un pays, selon la norme ISO-3166.

Il est préférable de n'utiliser que les codes ISO référencés. Si vous en inventez, le risque est qu'ils soient officialisés plus tard.

Exemples de codes :

• fr_FR : français "de France"
• fr_CA : québécois
• en_US : anglais des états-unis d'amérique
• sv_SE : suédois "de Suède"

Dans le doute, demandez confirmation sur le forum.

Le fichier source à traduire

Gestinux 1.0 prend les traductions dans un fichier "texte" xx_YY.ini

En général, ces fichiers sont dans un dossier languages au même niveau que l'exécutable gestinux. Toutefois pour se conformer aux règles Linux Debian, notamment pour Ubuntu, les fichiers, sont pour ces distributions, dans le dossier /usr/share/gestinux/languages

Ces fichiers sont installés en écriture seule. N'essayez pas de les modifier ou de les déprotéger à cet emplacement. Si vous souhaitez améliorer une traduction existante ou partielle, vous pouvez copier un de ces fichiers dans un dossier de votre choix, dans vos documents personnels.

Vous pouvez aussi créer un fichier dans vos documents personnels, et écrire sur les deux premières lignes :

[General]

LanguageCode=xx_YY

LanguageName=name of language (in english)

Une fois ce fichier créé, il faut mettre ce fichier dans le répertoire de sources de gestinux (géré par SVN) et le verrouiller pour éviter à un autre d'entamer le même travail simultanément. Ceci doit être fait avant que la traduction soit terminée, au tout début c'est mieux.

Si vous savez utiliser SVN, demandez un profil "développeur". Sinon faîtes vous connaître sur le forum et joignez le fichier de traduction à votre message, d'autres développeurs le mettront dans SVN.

Paramétrage initial

Lancez gestinux et choisissez dans le menu Paramètres, Langages, puis l'onglet Écrire une traduction :

• Le langage de référence est obligatoirement un des langages installés avec gestinux. Il sera votre source. Si possible, choisissez le français, car l'anglais est assez approximatif aujourd'hui.
• Cherchez votre fichier de traduction, créé comme indiqué dans le paragraphe précédent, en cliquant sur le bouton de choix.
• Cochez la case "Utiliser la traduction" pour que les traductions de ce fichier soient utilisées. Sinon ce seront celles du langage de référence.

Saisir les traductions

Vous pouvez traduire globalement en cliquant sur le bouton Traduire. Dans ce cas, vous aurez dans la partie gauche la liste des différentes fenêtres de l'application, ainsi que quelques sections non liées à une fenêtre. Utiliser la traduction globale est nécessaire pour les sections qui ne correspondent pas à une fenêtre, et surtout pour ne pas en oublier. Le bouton Next Missing permet de trouver la première traduction manquante.

Il est aussi possible d'aller dans les différentes fenêtres de l'application, et d'appuyer sur CTRL + F4 pour traduire la section correspondant à la fenêtre. Dans ce cas, il n'y aura que cette seule fenêtre dans la partie gauche. L'avantage de cette dernière méthode est qu'une fois la traduction saisie vous pouvez la vérifier en appuyant sur F4, ce qui vous bascule de la langue de référence vers la langue de traduction, ou l'inverse.

Quoiqu'il en soit, pour la section sélectionnée dans la partie gauche, la liste des clés de traduction est affichée dans la partie droite. La traduction de référence, non modifiable est affichée en dessous, et vous avez la possibilité de saisir ou modifier la traduction dans votre langage. L'enregistrement est automatique quand vous changez de clef.

Installer les traductions

Une fois la traduction terminée, si possible relue par d'autres personnes dont c'est aussi la langue maternelle, déverrouillez le fichier dans SVN si vous savez le faire, ou demandez via le forum à un développeur de le faire pour vous.

Si c'est une langue répandue, votre traduction sera ajoutée à la prochaine version de gestinux.

Si c'est une langue rare, ou pour ne pas attendre la prochaine version, il est possible de faire un paquet additionnel comprenant cette langue pour les différents systèmes cibles (Windows, Debian, ...). Vous pouvez vous inspirer du paquet principal et le faire vous-même, ou demander à un développeur.

Quand on le lance pour la première fois sur un poste, Gestinux essaie d'activer la bonne traduction automatiquement, en fonction de la langue de l'ordinateur. Malheureusement, Windows ne connaît pas les codes de langue POSIX, et il y a des cas ou cela n'est pas automatique. Une petite modification du logiciel sera nécessaire, à signaler aux développeurs. Ce problème n'existe pas sous Linux qui respecte mieux les normes.

Traduire la documentation

Après, ou avant, avoir traduit le programme, il est utile de traduire la documentation (le wiki).

Pour cela, il suffit de demander le droit "éditeur" via la forum et de respecter les conventions du wiki (qui seront explicitées plus tard).

Fournir les traductions des données

La liste des pays doit être créée pour chaque langue disponible dans Gestinux. C'est un fichier xx_YY_countries.txt qui sera chargé automatiquement à la création ou lors d'une vérification de la base de données si on a sélectionné le langage correspondant avant.

Il est aussi utile de créer des jeux d'essais dans la langue traduite, pour un ou plusieurs pays qui l'utilisent. Vous pourrez envoyer une exportation de la base de données pour que celle-ci soit hébergée sur gestinux.net et accessible à tous.

Si vous avez fait des états fiscaux spécifique à un pays, ils peuvent aussi être intégrés au logiciel.