Documentación traductores: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
Line 7: Line 7:
# Manualmente usando Transifex.com (oficial y recomendado).
# Manualmente usando Transifex.com (oficial y recomendado).


Los describimos por orden inverso de preferencia:
Los describimos por orden de preferencia:
 
== 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:
<source lang="bash">
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
</source>
Por ejemplo:
<source lang="bash">
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
</source>
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 [http://translate.google.com 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:
 
<source lang="ini">
Code1=Frase a traducir 1
Code2=Frase a traducir  2
...
Coden=Frase a traducir  n
</source>
 
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:
 
<source lang="php">
$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")
</source>
 
Y una entrada del tipo
<source lang="ini">
CodeX=Phrase X
</source>
 
debe de ser añadida a los ficheros .lang


== Traducción via transifex (recomendada) ==
== Traducción via transifex (recomendada) ==
Line 202: Line 151:
tx -d push -s  # To push source file
tx -d push -s  # To push source file
</source>
</source>
== Traducción totalmente manual (no recomendada) ==
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:
<source lang="ini">
Code1=Frase a traducir 1
Code2=Frase a traducir  2
...
Coden=Frase a traducir  n
</source>
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:
<source lang="php">
$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")
</source>
Y una entrada del tipo
<source lang="ini">
CodeX=Phrase X
</source>
debe de ser añadida a los ficheros .lang
== Traducción automática mediante la utilidad autotranslator.php (no recomendada) ==
* 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:
<source lang="bash">
php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY
</source>
Por ejemplo:
<source lang="bash">
php autotranslator.php en_US pt_PT GOOGLEAPIKEY
</source>
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 [http://translate.google.com 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.


= [[File:Language.png]] Difusión o inegras su idioma =
= [[File:Language.png]] Difusión o inegras su idioma =

Navigation menu