31,003
edits
Documentation traducteur: Difference between revisions
Jump to navigation
Jump to search
m
no edit summary
mNo edit summary |
|||
| Line 4: | Line 4: | ||
Il existe 3 méthodes pour réaliser la traduction de Dolibarr: | Il existe 3 méthodes pour réaliser la traduction de Dolibarr: | ||
# Manuelle en utilisant Transifex.com (officielle et recommandée). | |||
# Manuelle par modification des fichiers langues | |||
# Automatique avec autotranslator.php | # Automatique avec autotranslator.php | ||
Les voici par ordre inverse de préférences: | Les voici par ordre inverse de préférences: | ||
== Traduction via transifex (recommandé) == | == Traduction via transifex (recommandé) == | ||
| Line 205: | Line 153: | ||
tx -d push -s # To push source file | tx -d push -s # To push source file | ||
</source> | </source> | ||
== 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: | |||
<source lang="ini"> | |||
Code1=Phrases à traduire 1 | |||
Code2=Phrases à traduire 2 | |||
... | |||
Coden=Phrases à traduire n | |||
</source> | |||
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: | |||
<source lang="php"> | |||
$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") | |||
</source> | |||
Et une entrée du type | |||
<source lang="ini"> | |||
CodeX=Phrase X | |||
</source> | |||
doit être ajoutée aux fichiers .lang | |||
== 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: | |||
<source lang="bash"> | |||
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY | |||
</source> | |||
Par exemple : | |||
<source lang="bash"> | |||
php autotranslator.php en_US pt_PT GOOGLEAPIKEY | |||
</source> | |||
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 [http://translate.google.com 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. | |||
= [[File:Language.png]] Diffusion ou intégration en standard de votre traduction = | = [[File:Language.png]] Diffusion ou intégration en standard de votre traduction = | ||