Translating/fr

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.

Que faut-il traduire et dans quel ordre ?

Idéalement, il faut commencer par traduire le logiciel lui-même, avant la documentation.

Cela permettra de l'utiliser pour créer un jeu d'essai de données, et de faire des copies d'écran dans la langue traduite.

Ensuite, on peut traduire la documentation, et cela peut être progressif.

Traduire le logiciel

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. Dans les 2 cas, utilisez le forum pour communiquer.

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.
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, depuis une fenêtre quelconque de l'application, d'appuyer sur CTRL + F4 pour afficher et traduire la section correspondant à cette 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, la liste des clés de traduction est affichée. 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.

Le symbole <CR> permet de sauter une ligne, et ne doit être utilisé que pour les messages.

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.

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 des états fiscaux spécifiques à un pays, ils peuvent aussi être intégrés au logiciel. Si vous ne savez pas réaliser une présentation d'édition, demandez à un développeur sur le forum, en lui envoyant les modèles.

Traduire la documentation

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

A ce jour, il y a environ 100 pages à traduire, mais certaines sont plus utiles que d'autres.

Voyez comment créer ou modifier des pages de ce wiki.

Il existe un moyen de lister les pages restant à traduire, ou dont l'original a été modifié après traduction. Pour l'instant, ils ne sont pas accessibles en ligne, demandez sur le forum.