Linea21

[[TOC]]

= Pour réaliser la traduction de linea21 =

== Le fonctionnement des langues dans Linea21 ==

L'ensemble des messages de l'interface de Linea21 est contenu dans des fichiers de traduction dans le dossier languages à la racine de l'application.

Chaque langue est contenue dans un dossier portant un code iso sur 2 lettres de la langue considérée : fr, en, it, es, ...

Les fichiers de langue obéissent à la syntaxe suivante :

{{{ 

$lang['module']['item'] = 'traduction' ; 

}}}

module : nom du module considéré[[BR]]

item : identifiant unique du message à traduire[[BR]]

traduction : traduction du message dans la langue considérée

Exemple :

{{{

$lang['newsletter']['name']='newsletter';

$lang['newsletter']['confirm_add'] = "Ajout de la nouvelle newsletter réalisé avec succès\n";

$lang['newsletter']['confirm_mod'] = "Modification de la newsletter réalisée avec succès\n";

$lang['newsletter']['confirm_sup'] ="Suppression de la newsletter réalisée avec succès\n";

}}}

Vous pouvez donc modifier un message dans ces fichiers de langue en prenant garde de modifier l'ensemble des traductions dans chaque dossier.

== Comment traduire linea21 dans une nouvelle langue ? ==

Nous prenons pour exemple la traduction en italien.

En fonction de la langue de départ que vous maitrisez le plus, vous pouvez partir de la langue anglaise "en" ou française "fr"[[BR]]

[[BR]]

Créer le repertoire "it" dan le dossier languages

[[BR]]

Copier tous les fichiers du repertoire "en" ou "fr" vers le nouveau dossier "it"

[[BR]]

Dans le répertoire "it", éditer chaque fichier et traduisez les messages en italien.

[[BR]]

ATTENTION, les fichiers de Linea21 sont encodés en UTF8, il est impératif d'enregistrer vos fichiers dans ce format.

Pour éditer ces fichiers, nous vous recommandons donc d'utiliser l'éditeur de texte Scite disponible à cette adresse http://www.scintilla.org/SciTE.html.

Avec Scite, Avant tout enregistrement du fichier aller dans "Fichier">"encodage">"UTF8 cookie" pour activer l'enregistrement en UTF8.

[[BR]]

Pour tester vos traductions, dans le fichier define_release.ini, modifier la section "LANGUAGE" en "it" pour passer votre application en italien.

Vous pouvez réaliser ce paramétrage directement par l'interface d'administration dans le menu configuration.

== Compléments de traduction ==

Pour réaliser une traduction complète et exhaustive de l'application, plusieurs autres fichiers doivent être traduits :

 * /Readme.code_langue.txt (à la racine de l'application)

 * /public/tpl_accessiblity.code_langue.php

 * /languages/code_langue/define.php

[[BR]]

=== Complément d'information sur define.php ===

Les valeurs contenues dans les clés de tableaux ''linkvalue'' doivent comporter exclusivement des caractères latins et la caractère '-'. Pas d'espace, ni d'accent.

== Outil d'audit des langues ==

Un outil d'audit pour connaitre l'état d'avancement de votre traduction pour la langue considérée peut être activé pour les traducteurs.

Pour activer cet outil, dans l'interface d'administration, activez le module TOOLS en passant le paramètre MOD_TOOLS à 1 dans la section configurer/système

[[BR]]

Pour utiliser l'audit, aller dans le menu configurer/outils et cliquez sur le lien "Audit des fichiers de langues", analysez les résultats.

[[BR]]

Attention, cet outil est très consommateur en ressources processeur.