Documentación traductores
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, 2 manuales completamente manual o transifex). 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, se encuentra en la carpeta dev/translation.
Para traducir o actualizar todos los archivos en un nuevo idioma, símplemente ejecute el script:
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
Por ejemplo:
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
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 totalmente manual (no recomandada)
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 idioma 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
Solamente 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.
Para tener una variable de cadena para el idioma en el código PHP, todo lo que necesita hacer es cargar el archivo de idioma y utilizar el método para recuperar la variable traducida. Esto se puede hacer de la siguiente manera:
$langs->load("nombredelarchivo"); // o $langs->load("nombredelarchivo@mimodulo") si miarchivo.lang se encuentra en el directorio htdocs/mimodulo/langs/xx_XX
print $langs->trans("CodeX")
Y una entrada del tipo
CodeX=Phrase X
debe de ser añadida a los ficheros .lang
Traducción via transifex (recomendada)
|
|
Page waiting to complete. To complete, create an account, go back and clic on "Modify".
Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".
Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"
Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".
Difusión o inegras su idioma
En los fuentes Dolibarr oficiales
Lo mejor que puede hacer, después de realizar una traducción, es incluirla incluye en la versión oficial de Dolibarr.
Si usted ha completado archivos .lang existentes en Dolibarr de forma incompleta o si ha creado nuevos archivos .lang para un nuevo idioma, puede :
- Incluir sus cambios o archivos en la versión oficial de Dolibarr. Es posible, si sabe usar un sistema GIT. Para ello cree una cuenta en https://github.com/Dolibarr/dolibarr, haga un fork del proyecto Dolibarr, haga sus cambios y mande un Pull Request.
- o envíe sus archivos por e-mail en un adjunto a la lista inglesa: dolibarr-dev@nongnu.org (Inscripción en https://savannah.nongnu.org/mail/?group=dolibarr). Un desarrollador lo integrará por usted.
Nota: Hay dos idomas principales, que siempre están completos:
- El francés (ficheros .lang de la carpeta lang/fr_FR)
- El inglés (ficheros .lang de la carpeta lang/en_US)
Puede utilizar indistintamente tanto uno como el otro (el que prefiera) como referencia ya que los dos están actualizados. Todos los demás archivos de idioma son susceptibles de estar incompletos.
Como una extensión
Al crear un nuevo idioma, si este no se encuentra integrado en Dolibarr, puede ser difundido a otros usuarios. Para ello puede crear un paquete para su distribución mediante el script build/makepack-dolibarrlang.pl o creando un zip de forma manual que puede subir a dolistore.com o a la lista de correo de desarrolladores dolibarr-dev (Inscripción en https://savannah.nongnu.org/mail/?group=dolibarr).
El archivo creado debe ser descomprimido en el directorio Dolibarr para que el idioma se encuente disponible.
Traducción del wiki
El wiki se mantiene en 3 idiomas: Inglés, Francés y Español. Si desea mejorar la documentación en uno de estos idiomas, simplemente debe de crear una cuenta en este wiki. Entonces, podrá modificar una traducción incorrecta o traducir una página a la espera de traducción. La lista de estas páginas se encuentra disponible en la página Category:Page_waiting_for_translation.