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.

Traducción manual mediante iniTranslator

• SO del traductor: Windows
• Utilidad: iniTranslator (bajjo Windows).

1. Ejecute su aplicación de traducción, la cual le pedirá el fichero modelo (Por ejemplo, en iniTranslator, Archivo - Abrir Original). Escojer el fihero origen modelo en la carpeta htdocs/langs/en_US ó htdocs/langs/fr_FR, que están actualizados.
2. Escoja seguidamente el fichero a traducir, en la carpeta htdocs/langs/xx_XX donde xx és el código del idioma a traducir.
3. iniTranslator mostrará los archivos 2 cara a cara con la falta de cadenas a traducir.
4. Completar
5. Guardar el nuevo fichero de destino.

Atención, iniTranslator sufre un grave defecto. No mantiene el orden original de los parámetros y crea el archivo generado por orden alfabético de las claves en lugar de mantener el orden del archivo de origen. Además, las áreas de comentarios de los archivos de origen no se reflejan en el archivo de destino traducido.

Traducción totalmente manual

Para traducir Dolibarr a otro idioma, vaya a la carpeta langs y cree una carpeta llamada con el código de idioma a traducir (Siguiendo el mismo formato de las ya existentes, por ejemplo en_US, fr_FR, es_ES, de_DE, etc...). Deberá copiar los archivos de una carpeta lang ya traducida (por ejemplo en_US/main.lang ó fr_FR/bills.lang), y pegarlas en la carpeta del nuevo idoma que acabamos de crear y empezaremos a traducir el contenido de estos archivos.

Estos ficheros están constituidos de la siguiente manera:

Code1=Frase a traducir 1

Code2=Frase a traducir 2

...

Coden=Frase a traducir n

Sólamene las frases a la derecha del = se deben traducir, el código debe permanecer sin cambios. Es posible traducir los archivos uno por uno, sin tener que traducirlos todos a la vez. Si un archivo no se ha traducido en el nuevo idioma, Dolibarr utilizará el Inglés.

Tenga en cuenta que por el momento, todavía hay frases directamente en el código de las páginas PHP. Estas deben ser reemplazadas con el siguiente código:

$langs->trans("CodeX")

Y de una entrada del tipo

CodeX=Phrase X

debe de ser añadida a los ficheros .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.