Documentation traducteur

Traduire Dolibarr dans une autre langue

Dolibarr est par défaut développé en Français et Anglais

• Traduction par iniTranslator

Des outils libre pour aider les traductions existent, comme iniTranslator (sous Windows).

- Lancer votre application de traduction qui vous demandera le fichier modèle (Par exemple, sous iniTranslator, faire Fichier - Ouvrir Original). Choisir le fichier source modèle dans le répertoire htdocs/langs/en_EN ou htdocs/langs/fr_FR, qui sont à jour.

- Puis choisissez éventuellement le fichier destination, dans le répertoire htdocs/langs/xx_XX ou xx est le code langue à traduire.

- Votre outils affichera les 2 fichiers face à face avec les chaines à traduire manquante.

- Compléter

- Sauvegarder le nouveau fichier destination.

• Traduction manuelle

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.

Notons que, pour l'instant, il reste de nombreuses phrases en dur dans le code des pages PHP. Ces dernières doivent etre remplacées par le code suivant:

$langs->trans("CodeX")

Et une entrée du type

CodeX=Phrase X

doit etre ajoutée aux fichiers .lang

Intégrer sa traduction dans Dolibarr

Si vous avez complété des fichiers .lang existant déjà dans Dolibarr mais incomplets :

• Vous pouvez nous soumettre vos modifications en réalisant un fichier patch suivant la méthode décrite sur la page FAQ Développeur dans la section "Sans accès CVS en ecriture".

Si vous avez créé des nouveaux fichiers .lang pour une nouvelle langue, vous pouvez :

• Envoyer vos fichier par mail en pièce jointe sur la liste: dolibarr-dev@nongnu.org. 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.