Documentación traductores

Page waiting for translation. To translate, create an account, go back and clic on "Modify". Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier". Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar". Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica". Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar". Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten". 页面等待翻译。若要翻译本页，先创建一个帐户、登录并返回本页后单击“编辑”。

Traducir Dolibarr a otro idioma

Dolibarr se desarrolla por defecto en Francés e inglés

Existen 4 métodos para realizar la traducción de Dolibarr (1 automático mediante autotranslator.php, 3 manuales mediente phpLangEditor, iniTranslation o completamente manual). Los describimos a continuación por orden de preferencia de uso:

Traducción automática mediante la utilidad autotranslator.php

• SO del traductor: Cualquiera
• Utilidad: autotranslator.php viene con Dolibarr 2.5.1 y superior, se encuentra en la carpeta dev/translation.

Para traducir o actualizar todos los archivos en un nuevo idioma, símplemente ejecute el script:

 autotranslator.php lang_code_source lang_code_target

Por ejemplo:

 autotranslator.php en_US pt_PT para realizar la traducción al portugés(pt_PT) utilizando el inglés (en_US) como origen.

Todos los ficheros no existentes serán creados, y los existentes se actualizarán con las cadenas inexistentes. Las cadenas ya traducidas anteriormente se conservarán tal cual. La utilidad utiliza el servicio de traducción de Google para encontrar el valor traducido de una cadena. Su PHP debe de tener permisios de escritura en la carpeta htdocs/langs y disponer de las funciones de la extensión curl disponibles.

Traducción manual mediante el plugin de Firefox phpLangEditor

• SO del traductor: Cualquiera
• Utilidad: phpLangEditor (plugin de Firefox)

1. Instalar Firefox y la versión 2.5 o superior del plugin phpLangEditor ( http://code.google.com/p/phplangeditor/ )
2. Necesita realizar un paso complementario para terminar la instalación del plugin. Teclee la dirección about:config y, seguidamente en el campo filtro, indique phplangeditor.

Doble clic en la línea phpLangEditor.file.typeOfLangExt y ponga ini en lugar de php. phpLangEditor estará disponible para traducir Dolibarr.

1. Desde Firefox, abra phpLangEditor buscando el menú Herramientas -> PHP lang editor.
2. Haga clic en "Abrir referencia" y busque su fichero .lang de origen (por ejemplo, en su carpeta Dolibarr, htdocs/langs/en_US/bills.lang
3. Haga clic en "Abrir traducción" y seleccione el fichero que congenga la traducción, si el fichero ya existe (por ejemplo htdocs/langs/es_ES/bills.lang).
4. Puede escojer ver todos los términos a traducir o sólamente los que lo estén. Haga clic en el término en la columna de la izquierda para realizar la traducción en el cuadro de abajo. También puede utilizar métodos abreviados de teclado, como CTRL+N para pasar a la siguiente
5. Guarde el fichero una vez haya terminado la traducción.
6. Editar el fichero con un editor de texto para suprimir o corregir la primera línea de comentario. En efecto, con phpLangEditor, no és posible traducir las líneas comentadas (las que empiezan con un #), así que el fichero traducido contiene una vez sea guardado la línea de comentario del archivo origen. Una pequeña edición manual es necesaria para corregir o suprimir esta línea, aunque esto no afecta negativamente el buen funcionamiento del nuevo archivo .Lang.

Traduction manuelle avec iniTranslator

• OS du traducteur: Windows
• Outil: iniTranslator (sous Windows).

1. 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_US ou htdocs/langs/fr_FR, qui sont à jour.
2. Puis choisissez éventuellement le fichier destination, dans le répertoire htdocs/langs/xx_XX ou xx est le code langue à traduire.
3. Votre outils affichera les 2 fichiers face à face avec les chaines à traduire manquante.
4. Compléter
5. Sauvegarder le nouveau fichier destination.

Attention, iniTranslator souffre d'un grave défaut. Il ne conserve pas l'ordre d'origine des paramètres et tri le fichier généré par ordre alphabétique des clés plutot que dans l'ordre du fichier source. De plus, les zones commentaires du fichiers source ne sont pas repercutées dans le fichier destination traduit.

Traduction manuelle complètement

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.

Diffusion de votre langue

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

Le fichier .tgz fabriqué doit juste être dézippé dans le répertoire Dolibarr pour que la langue soit disponible. Ce fichier peut être envoyé sur le site web http://www.dolibarr.org dans l'espace téléchargement, modules/addon ou sur la mailing-list développeur dolibarr-dev@nongnu.org de Dolibarr.