Página 1 de 2

¿Como traducir extensiones phpBB?

Publicado: 23 Ago 2017, 17:14
por ThE KuKa
Son varios puntos a tener en cuenta a la hora de empezar a traducir una extensión, la más importante es usar el editor de código oportuno, desde siempre recomendamos Notepad++ y tenéis aquí su sitio web.

Lo siguiente es como configurar esos archivos y/o el editor, la codificación de los archivos y los finales de líneas.
UFT-8 Sin BOM (codificación del archivo) y UNIX LF (fin de línea).

Abajo en la parte derecha veremos como esta actualmente nuestro archivo:
Imagen

Para lo primero con el archivo abierto, vamos al menú Codificación - Convertir a... o Codificar en... ahora vemos tres opciones, Windows, Unix y MAC, seleccionamos Unix y guardamos el archivo.
Imagen

Para lo segundo con el archivo abierto, vamos al menú Editar - Conversión fin de línea ahora vemos tres opciones, Windows, Unix y MAC, seleccionamos Unix y guardamos el archivo.
Imagen

Ahora que sabemos como debe ser nuestro archivo vamos con ciertas normas de traducción del equipo oficial, pero aún así, os dejo esta guía de picaron

Vamos a imaginar una estructura de traducción "completa" incluyendo carpeta /email/ que no todas las extensiones la usan, pero así lo exponemos todo lo que podemos encontrar.

Esta será nuestra estructura:
language/es/
language/es/acp/
language/es/email/

  • Todos los archivos serán codificación UTF-8 Sin Bom y con fin de línea Unix LF.
  • Todos los archivos finalizan con una línea en blanco.
  • Todos los archivos de idioma tendrán la constante phpBB definida, para quienes no lo sepan, esto es la constante de phpBB definida en un archivo de idioma:

    Código: Seleccionar todo

    if (!defined('IN_PHPBB'))
    {
    	exit;
    }
  • Los archivos PHP comenzarán con su etiqueta <?php asegurándose de no tener caracteres delante, ni detrás.
  • Los archivos PHP no tendrán la etiqueta de cierre de código ?> al final del archivo, simplemente se finaliza el archivo con una línea en blanco (como se ha comentado más arriba).
  • Los archivos de carpetas /email/ también finalizan con una línea en blanco.
  • NUNCA se traduce la palabra Subject en los archivos de la carpeta /email/
    Pongo comparativa de ejemplos aquí abajo:
    Código correcto:

    Código: Seleccionar todo

    Subject: Activar cuenta de usuario.
    
    Hola,
    
    La cuenta de "{USERNAME}" ha sido desactivada o creada nuevamente, debería verificar los detalles de este usuario (si se requiere) y proceder según sea apropiado.
    
    Siga este enlace para ver el perfil del usuario:
    {U_USER_DETAILS}
    
    Siga este enlace para activar la cuenta:
    {U_ACTIVATE}
    
    {EMAIL_SIG}
    
    
    Código no correcto:

    Código: Seleccionar todo

    Asunto: Activar cuenta de usuario.
    
    Hola,
    
    La cuenta de "{USERNAME}" ha sido desactivada o creada nuevamente, debería verificar los detalles de este usuario (si se requiere) y proceder según sea apropiado.
    
    Siga este enlace para ver el perfil del usuario:
    {U_USER_DETAILS}
    
    Siga este enlace para activar la cuenta:
    {U_ACTIVATE}
    
    {EMAIL_SIG}
    
    
  • Se usan comillas inglesas como UTF8-Variant, por ejemplo:
    Correcto: “%s”
    No correcto: "%s"
    EXCEPTO en la carpeta /email/ donde si se permiten.
  • Si al traducir usas Google, no insertar líneas enteras con variables tipo $1d ya que Google añadirá espacios, sino os dais cuenta, provocará errores.
  • Al final de cada línea a traducir hay una coma , si esta es eliminada, provocará errores.
Espero que esto os quite algunas dudas, y si aún así tenéis dudas, preguntar sin problema alguno.

Más información oficial en Ingles aquí:
https://github.com/phpbb/phpbb-translat ... idation.md

Re: ¿Como traducir extensiones phpBB?

Publicado: 23 Ago 2017, 17:51
por J_Sparrow
:D :D
Tomo nota ThE KuKa, mira por donde hoy he aprendido de una sola vez un montón de cosas. Gracias, espero no volver a cometer los mismos errores.

Re: ¿Como traducir extensiones phpBB?

Publicado: 23 Ago 2017, 18:04
por ThE KuKa
De eso se trata, nadie nace enseñado. :wink:

Re: ¿Como traducir extensiones phpBB?

Publicado: 23 Ago 2017, 18:18
por petit79
Perfecto, es de gran ayuda. Yo mismo cometi exactamente esos fallos en mi primera traducción.

Re: ¿Como traducir extensiones phpBB?

Publicado: 23 Ago 2017, 22:40
por angelismo
Buen aporte @ThE KuKa

Re: ¿Como traducir extensiones phpBB?

Publicado: 26 Ago 2017, 14:38
por J_Sparrow
Hola ThE KuKa, una pequeño comentario a tu estupenda guía:
Las imágenes 2 y 3 no se corresponden con los textos que las preceden, o al revés, los textos no corresponden a las imágenes. Están intercambiadas, se me hacía muy raro que a simple vista la localización de lo que comentas, no estaba en la misma posición que explicas con respecto a mi programa.
Tu pones en la segunda imagen ...
ThE KuKa escribió:Para lo primero con el archivo abierto, vamos al menú Codificación - Conversión fin de línea ...
... y en la imagen se ve lo que comentas en la imagen siguiente ...
ThE KuKa escribió:Para lo segundo con el archivo abierto, vamos al menú Editar - Conversión fin de línea ...
Doy por hecho que ha sido un baile de textos o de imágenes. Cuando lo actualices puedes borrar este comentario mio.

Perdona las molestias.

Re: ¿Como traducir extensiones phpBB?

Publicado: 26 Ago 2017, 14:43
por ThE KuKa
Cierto, corregido.

Gracias por avisar. :wink:

Re: ¿Como traducir extensiones phpBB?

Publicado: 04 Oct 2018, 22:12
por Jack_Bauer
Suele ser que el fichero a traducir tenga mucho html? Eso no puede ser un problema?

Re: ¿Como traducir extensiones phpBB?

Publicado: 07 Oct 2018, 00:53
por Jack_Bauer
Alguien lo sabe?

Re: ¿Como traducir extensiones phpBB?

Publicado: 07 Oct 2018, 10:15
por ThE KuKa
Por phpBB "oficial" la respuesta es NO, todo debe estar basado en variables de idioma que se puedan traducir. Con extensiones NO oficiales, puedes ver 100 cosas en los HTML en Ingles.

Re: ¿Como traducir extensiones phpBB?

Publicado: 07 Oct 2018, 17:06
por Jack_Bauer
Muchas gracias.

Tienes algun enlace que lo diga eso?

Re: ¿Como traducir extensiones phpBB?

Publicado: 07 Oct 2018, 18:02
por ThE KuKa

Re: ¿Como traducir extensiones phpBB?

Publicado: 07 Oct 2018, 18:32
por Jack_Bauer
Gracias pero no consigo ver donde pone que no tiene que tener html... :(

Quería traducir esta extensión https://www.phpbb.com/community/viewtopic.php?t=2354426 pero creo que será imposible...

Re: ¿Como traducir extensiones phpBB?

Publicado: 07 Oct 2018, 20:24
por AbaddonOrmuz
@Jack_Bauer No sé si en el grupo de traductores comenten algo al respecto, pero almenos de manera pública no veo donde diga explícitamente que no se permite, sin embargo hay pautas que se pueden deducir si pasará la validación.

Lo siguiente es válido:

Código: Seleccionar todo

'ACP_OPTION_EXPLAIN' => 'Descripción de la opción <strong>ejemplo</strong> con el valor de <samp>valor</samp>';
Lo siguiente NO es váldo:

Código: Seleccionar todo

'ACP_OPTION_EXPLAIN' => '<html><head><title></title></head><body>Descripción de la opción <strong>ejemplo</strong> con el valor de <samp>valor</samp></body></html>';
No solo porque tiene tags vacíos, sino porque usa tags que pueden (y deben) ser usados en los ficheros de la plantilla y no en la traducción.

En la extensión que comentas no veo cuál es el problema, los únicos ficheros de traducción que usan mucho HTML son las plantillas de correo electronico (directorio email, con extensión .txt) y estas obtienen los mensajes de los ficheros PHP, por lo que no todas requieren de modificaciónes.

Re: ¿Como traducir extensiones phpBB?

Publicado: 07 Oct 2018, 23:06
por Jack_Bauer
Gracias, pero según dice el autor de la extensión que esos ficheros puede que cambie el html. Entonces habría que volver a traducir de nuevo...