Ayudas para traducir archivos con desafios e instrucciones de FreeCodeCamp usando Google Translator Toolkit

Estas ayudas como módulo

Primero puede instalar estas ayudas como módulo de su clon de las fuentes de FreeCodeCamp con:

  git submodule add https://github.com/vtamara/fcc_trad

Google Toolkit Translator

Para traducir rápido recomendamos emplear Google Toolkit Translator, que requiere que tenga una cuenta en Google.

Google Toolkit Translator puede importar un archivo JSON para traducirlo hará traducción automática del documento entero y le permitirá corregir frase a frase.

Preparar archivo JSON para usar en Google Toolkit Translator

Google Translator Kit introduce errores en el archivo JSON, por ejemplo al separar las entidades HTML y las etiquetas de cierre, y en algunos casos intercambiar ." por ".

Por eso conviene pasar lo mínimo que se va a traducir. Para generar lo mínimo por traducir de un archivo semilla (ubicados en el directorio seeds/challenges y que contienente desafios e instrucciones para FreeCodeCamp), puede usar el programa exportrad.js de estas ayudas así:

node fcc_trad/exportrad.js seed/challenges/jquery.json > /tmp/portrad.json

Que generará el archivo /tmp/portrad.json el cual debe copiar y pegar en Google Translator Toolkit (no me ha funcionado bien la opción de subirlo, pero si la de copiar y pegar).

Para corregir algunos de los errores introducidos por Google Translator Kit conviene hacer las siguientes sustituciones (Ctrl+F en la interfaz de Google Translator Kit):

• ' </ code>' por '</code>'
• '<code> ' por '<code>'
• '"Namees"' por '"nameEs"'
• '"Descriptiones"' por '"descriptionEs"'
• '\ "' por '\"'

También es importante traducir con cuidado y corregir los errores introducidos para que el JSON resultante sea válido. Puede verificar si lo es y ubicar la línea del error pegando la traducción resultante en http://jsonlint.com/

El JSON resultante debe almacenarlo en un archivo (digamos /tmp/trad.json) y se puede reintegrar al original con:

node fcc_trad/importrad.js seed/challenges/jquery.json /tmp/trad.json > /tmp/integrado.json

Después se puede revisar o validar nuevamente el archivo generado /tmp/integrado.json para finalmente remplazar el archivo semilla inicial.

Creación de descripciones para problemas de traducción

Para crear la descripción de un problema de traducción issue con el avance en la traducción se usó:

node avance.js ../FreeCodeCamp/seed/challenges/jquery.json