Documentation traducteur
<keywords content="traduction, documentation, traducteur, localisation, localiser, internationalise, langage" />
Traduire l'application Dolibarr dans une autre langue
Dolibarr est livré avec plusieurs langues. Par défaut, le Français et l'Anglais sont toujours complets. Les autres langues dépendent des contributions. Cette documentation vous présente comment traduire les fichiers langues pour ajouter une langue non traduite ou traduite de manière incomplète.
Il existe 4 méthodes pour réaliser la traduction de Dolibarr (1 automatique avec autotranslator.php, 2 manuelles via la méthode complètement manuelle ou transifex). Les voici par ordre de préférences:
Traduction automatique avec l'outil autotranslator.php
- OS du traducteur: Tous
- Outil: autotranslator.php fourni avec Dolibarr dans le répertoire dev/translation.
Pour traduire ou mettre à jour tous les fichiers dans une nouvelle langue, lancez simplement le script:
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
Par exemple :
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
pour traduire en portugais (pt_PT) en utilisant l'anglais (en_US) comme fichiers sources.
Tous les fichiers non existant seront créés, et ceux existant déjà seront mis à jour pour être complétés avec les chaines manquantes. Les chaines déjà traduites sont conservées tel quelles. L'outil utilise le service de traduction Google pour trouver la valeur traduite d'une chaine, aussi un accès internet depuis le poste où est lancé la commande est requis. De plus, une clé pour utiliser les API Google Translate sont nécessaire et Google fait payer l'utilisation de cette API (20 $ / 1 000 000 de caractères traduits). Votre PHP doit de plus avoir les permissions d'écrire dans le répertoire htdocs/langs directory et doit avoir les fonctions de l'extension curl disponibles.
Traduction manuelle complètement (non recommandé)
Pour traduire Dolibarr dans une autre langue, il faut aller dans le répertoire langs et créer un répertoire ayant pour nom le code langue à traduire (En suivant le même format que ceux déjà existant, par exemple en_US, fr_FR, es_ES, de_DE, etc...). Il faut ensuite recopier les fichiers lang depuis un répertoire déjà traduit (par exemple en_US/main.lang ou fr_FR/bills.lang), les recopier dans le répertoire de la nouvelle langue que l'on vient de créer et traduire le contenu de ces fichiers.
Ces fichiers sont constitués de la manière suivante:
Code1=Phrases à traduire 1
Code2=Phrases à traduire 2
...
Coden=Phrases à traduire n
Seules les phrases à droite du = sont à traduire, le code doit rester inchangé. Il est possible de traduire les fichiers un par un, sans tous les traduire d'un coup. Si un fichier n'a pas été traduit dans la nouvelle langue, Dolibarr utilisera l'anglais.
Pour avoir une chaine variable selon la langue dans le code PHP, tout ce que vous avez à faire et de charger le fichier lang et d'utiliser la méthode pour récupérer la variable traduite. Ceci peut se faire de la manière suivante:
$langs->load("nomdufichier"); // ou $langs->load("nomdufichier@monmodule") si monfichier.lang est dans le répertoire htdocs/monmodule/langs/xx_XX
print $langs->trans("CodeX")
Et une entrée du type
CodeX=Phrase X
doit être ajoutée aux fichiers .lang
Traduction via transifex (recommandé)
|
|
Page waiting to complete. To complete, create an account, go back and clic on "Modify".
Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".
Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"
Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".
Diffusion ou intégration en standard de votre traduction
Dans les sources Dolibarr officielles
La meilleure chose à faire, après avoir réalisé une traduction, est de les inclure dans la version officielle de Dolibarr.
Si vous avez complété des fichiers .lang existant déjà dans Dolibarr mais incomplets ou si vous avez créé des nouveaux fichiers .lang pour une nouvelle langue, vous pouvez :
- Inclure vos changements ou fichiers dans la version officielle de Dolibarr. Ceci est possible si vous connaissez le système GIT. Pour cela, créer un compte sur https://github.com/Dolibarr/dolibarr, forker le projet, modifier les fichiers concernés et envoyer une Pull Request.
- Ou plus simplement, envoyer vos fichier par mail en pièce jointe sur la liste: dolibarr-dev@nongnu.org (Inscription sur https://savannah.nongnu.org/mail/?group=dolibarr). Un développeur les intégrera pour vous.
Remarque: Il y a 2 langues maitres, toutes les 2 toujours complètes:
- Le français (fichiers .lang du répertoire lang/fr_FR)
- L'anglais (fichiers .lang du répertoire lang/en_US)
Il est possible d'utiliser indifférement l'une ou l'autre (celle qui arrange) comme référence car les 2 sont à jour. Tous les autres fichiers langues sont susceptibles d'être incomplets.
En tant qu'extension
Quand vous avez créer une nouvelle langue, si elle n'est pas intégrée dans Dolibarr, elle peut être malgré tout diffuser pour d'autres utilisateurs. Vous pouvez fabriquer un package pour la distribuer en utilisant le script build/makepack-dolibarrlang.pl ou en réalisant un zip de manière manuel que vous posterez sur dolistore.com ou sur la mailing-list des développeurs dolibarr-dev (Inscription sur https://savannah.nongnu.org/mail/?group=dolibarr).
Le fichier fabriqué doit juste être dézippé dans le répertoire Dolibarr pour que la langue soit disponible.
Traduire la documentation du wiki
Le wiki est maintenu en 3 langues: Englais, Français et Espagnol. Si vous voulez améliorer la documentation d'une de ces langues, il vous suffit de créer un compte sur ce wiki. Ensuite, vous pouvez modifier toute page qui possède une traduction incorrecte ou traduire une page qui attend d'être traduite. La liste de ces pages est disponible sur la page Category:Page_waiting_for_translation.