Difference between revisions of "Translation for developers/fr"

From Kiwix
Jump to navigation Jump to search
(Created page with "Chaque semaine, quelqu'un de Translatewiki vérifie la présence de nouvelles chaînes dans le fichier "en" et synchronise Translatewiki avec ce fichier si nécessaire.")
(Created page with "=== Créer une ébauche de traduction de votre nouvelle chaîne pour toutes les langues ===")
Line 54: Line 54:
Chaque semaine, quelqu'un de Translatewiki vérifie la présence de nouvelles chaînes dans le fichier "en" et synchronise Translatewiki avec ce fichier si nécessaire.
Chaque semaine, quelqu'un de Translatewiki vérifie la présence de nouvelles chaînes dans le fichier "en" et synchronise Translatewiki avec ce fichier si nécessaire.


=== Create stub translation of you new string for all languages ===
=== Créer une ébauche de traduction de votre nouvelle chaîne pour toutes les langues ===


The last thing you need to do is creating stub translation of your new localized string for all supported user interface languages in Kiwix. If you don't do that, Kiwix won't be able to work correctly in a language other than English.
The last thing you need to do is creating stub translation of your new localized string for all supported user interface languages in Kiwix. If you don't do that, Kiwix won't be able to work correctly in a language other than English.

Revision as of 17:25, 23 May 2020

Other languages:
Bahasa Melayu • ‎English • ‎català • ‎español • ‎français • ‎galego • ‎italiano • ‎magyar • ‎português • ‎русский • ‎日本語

En dehors de la partie Special:MyLanguage/traduction, le code source de Kiwix doit être synchronisé avec Translatewiki

Cette synchronisation avec Translatewiki a besoin de trois opérations:

  • Ajouter une chaîne entre Kiwis et Translatewiki, cad ajouter une chaîne dynamique qui sera remplacée par la traduction correspondante lors de l'exécution.
  • Mettre à jour les chaînes Kiwix avec les traductions venant de Translatewiki
  • Ajouter une nouvelle traduction complète de Translatewiki sur Kiwix

Prérequis

Vous avez besoin d'un système d'exploitation GNU/Linux. Il est possible de le faire dans un autre système d'exploitation, mais il bien plus compliqué d'obtenir un environnement fonctionnel.

Vous devez garder plusieurs chose en tête:

  • Les fichiers de traduction de Kiwix se trouvent tous dans le dossier kiwix/chrome/locale
  • Il y a deux types de fichiers de traduction pour traduire l'interface utilisateur (Jetez un oeil aux fichiers *.js et *.xul dans kiwix/chrome/content/main pour en comprendre le fonctionnement):
    • "main.dtd" fournit les traductions pour tous les fichiers *.xul
    • "main.properties" fournit les traductions pour touts les fichies *.js
  • Les traduction Translatewiki sont importées séparément dans le dépôt de code Kiwix une fois par semaine ; nous avons toujours besoin de synchroniser ces fichiers avec le code de Kiwix dans les deux direction (KW->TW et TW->KW)

ATTENTION: avant toute modification dans le code source de Kiwix, mettez à jour chacun de vos dépôts locaux avec "git pull origin master".

Extraction du code et démarrage de Kiwix

Avant de commencer à travailler sur l'intégration de nouvelles chaînes dans le code Kiwix, il est préférable de compiler Kiwix:

  • Prenez le code instable
  • Compilez le
  • Exécutez-le en allant dans le dossier kiwix et lancez "kiwix"

Remarque: Si vous n'arrivez pas à compiler Kiwix, ou n'avez pas de xulrunner disponible (c'est par exemple le cas pour Ubuntu Oneirix et au delà), vous pourrez toujours démarrer kiwix et obtenir une interface bien que l'application ne fonctionnera pas correctement ; cela sera cependant suffisant pour manipuler les fichiers XUL. Dans ce cas vous devrez effectuer quelques opérations supplémentaires telles qu'ajouter "MaxVersion=42" comme nouvelle ligne de au fichier kiwix/application.ini et lancer Kiwix en utilisant la commande suivante dans la console (depuis le dossier "kiwix"): "firefox -app application.ini".

Ajouter une chaîne aux traductions

Trouver une chaîne à localiser

Cherchez dans les fichiers *.xul et *.js pour trouver des chaînes codées en dur.

Si vous en trouvez, vous devez trouver un identificateur de chaîne (par exemple foobar), puis regarder dans la chaîne trouvée pour savoir à quoi elle devrait ressembler. Le plus important à savoir est que dans les fichiers *.xul, cela devrait ressembler à "&foobar", et dans les fichiers *.js à "getProperty('foobar')".

Traduire dans la langue maîtresse (anglais)

Vous devrez le faire à deux endroits. Tout d'abord dans les fichiers main.dtd ou main.properties sous "kiwix/chrome/locale/en/main". De cette facon, Kiwi sait quoi afficher si la langue de l'interface utilisateur est l'anglais.

Mettre à jour les fichiers Translatewiki

Vous avez également besoin de dire à Translatewiki d'ajouter cette chaîne dans la liste des chaînes qui doivent être fournies (pour les traducteurs Translatewiki) pour traduction. Pour cela vous avez besoin d'extraire une autre part du dépôt de code Kiwix. Entrez la commande suivante en dehors de votre dossier de code local kiwix:

git pull origin master

Vous avez maintenant les traductions translatewiki sur votre ordinateur. Vous avez seulement besoin de mettre à jour le fichier "en" qui est le fichier maître de traduction pour Translatewiki. Ajoutez simplement votre nouvelle chaine en suivant l'exmple de chaînes déjà insérée et envoyez votre fichier "en".

Chaque semaine, quelqu'un de Translatewiki vérifie la présence de nouvelles chaînes dans le fichier "en" et synchronise Translatewiki avec ce fichier si nécessaire.

Créer une ébauche de traduction de votre nouvelle chaîne pour toutes les langues

The last thing you need to do is creating stub translation of your new localized string for all supported user interface languages in Kiwix. If you don't do that, Kiwix won't be able to work correctly in a language other than English.

For that purpose you need to use the TW2PL.pl script (this is a perl script, so perl needs to be installed) like following (go in the translatewiki file directory):

./TW2KW.pl --path=/full/path/to/the/kiwix/code/directory --allLanguages=kw

Commit the new Kiwix translation files

Now, all the locale file in kiwix/chrome/locale should be updated and you should have a lot of (modified) files listed by typing:

git status kiwix/chrome/locale

After checking everything is OK, you can commit your modifications: ie. the kiwix/chrome/locale directory and the *.xul and/or *.js files you have modified.

Update Kiwix translations

Another task is to update already supported Kiwix languages with the last strings updated coming from Translatewiki. The first thing to know about that is that in the remote subversion repository, the Translatewiki file (in maintenance/translatewiki) is updated every two weeks from a Translatewiki contributors. That means, you only need to update your local repository and update and commit the kiwix code translation files like this:

cd /full/path/to/the/kiwix/maintenance_tools/translatewiki
./TW2KW.pl --path=/full/path/to/the/kiwix/code/directory --allLanguages=kw
git commit /full/path/to/the/kiwix/code/directory/kiwix/chrome/locale
git push origin master

The full path should be the moulinkiwix directory, not the kiwix directory in it.

Add a new supported language to Kiwix

Kiwix tries to add only 100% translated languages coming from Translatewiki. So it happens often that there are more languages in the "maintenance_tools/translatewiki" directory than in the "kiwix/kiwix/chrome/locale" directory. In such a case, that simply means the Translatewiki language was still not integrated in Kiwix code base. We explain now how to do that.

First of all you need to create the translation files in a new directory at "kiwix/kiwix/chrome/locale/your_language_iso_code" like this:

./TW2KW.pl --path=/full/path/to/your/kiwix/code/base/directory/ --language=your_language_iso_code

After that, you need go to the Kiwix source code directory in "kiwix/chrome" and edit with your preferred text editor the "chrome.manifest" and "chrome.manifest.prod" files. No explanation here, just do like for the already supported languages.

Next edit chrome/content/main/js/languages.js and here also add the new languages.

Now update CHANGELOG and make a notice about the addition of the new supported languages.

Add the new language directory and commit like this:

git add kiwix/chrome/locale/language_iso_code
git commit CHANGELOG kiwix/chrome/chrome.manifest kiwix/chrome/chrome.manifest.prod kiwix/chrome/locale/ kiwix/chrome/content/main/js/gui.js
git push origin master

Voir aussi