Traducción JavaScript: dificultades ocultas y consejos

Consejos para traducir JavaScript: dificultades ocultas y consejos que debes tener en cuenta al traducir código JavaScript

¿Sabías que algunos de los identificadores, comentarios y cadenas de JavaScript tienen un significado especial en el contexto de una traducción? ¿O que es posible dividir o fusionar una cadena en función del contexto? ¿O incluso que se usan caracteres especiales en los fragmentos de código?

Si traduces contenido técnico a nivel profesional y sueles trabajar con código fuente, es probable que ya te hayas topado con JavaScript en algún momento. ¿Pero hasta qué punto te sientes a gusto con este lenguaje de programación? ¿Sabes todo lo necesario desde la perspectiva de un traductor técnico de JavaScript?

JavaScript es uno de los lenguajes más potentes para desarrollar el front-end de los sitios web. Sin embargo, cuando decides traducir código JavaScript, no siempre resulta sencillo y entraña ciertas dificultades.

Existe un gran número de posibles dificultades que debes tener en cuenta. En este blog analizaremos algunas de las dificultades ocultas y consejos que debes saber al traducir código JavaScript.

Dificultad oculta: identificación automática de comentarios y cadenas en JavaScript

JavaScript tiene una funcionalidad integrada que identifica automáticamente los comentarios y las cadenas que contienen una secuencia de caracteres que parece un comentario o una cadena. Esta funcionalidad puede provocar problemas al intentar traducir el código. JavaScript reconoce dos tipos de comentarios: comentarios de una línea, que empiezan con //, y comentarios multilínea, que empiezan con /* y terminan con */. Estos comentarios pueden encontrarse en muchos lenguajes de programación y se suelen utilizar para escribir notas e instrucciones a fin de realizar tareas de mantenimiento más adelante. En el contexto de una traducción, pueden contener texto que debería incluirse en la traducción.

Lo mismo sucede con las cadenas que contienen una secuencia de caracteres que parece una cadena. Puede que el lenguaje disponga de una sintaxis especial para concatenar o insertar cadenas. Sin embargo, cuando JavaScript identifica cadenas automáticamente, estos símbolos especiales desaparecen del código fuente. Esto significa que en la traducción se incluirán los valores literales del código fuente en lugar de la traducción prevista.

Dificultad oculta: no siempre te puedes fiar de las herramientas de traducción automática para traducir código JavaScript

Las herramientas de traducción automática han sido diseñadas para reconocer código fuente y almacenar cadenas, comentarios e identificadores tal cual. Por desgracia, desconocen por completo los caracteres especiales que se utilizan en JavaScript. Esto significa que no podrán reconocerlos como parte del código fuente. Como consecuencia, esto puede derivarse en traducciones técnicas con errores o en las que falte contenido. Por lo tanto, se recomienda no utilizar herramientas de traducción automática para traducir JavaScript. Como alternativa, deberías traducir el código fuente de forma manual. Este proceso te brinda un control total del código y garantiza que la traducción sea correcta.

Dificultad oculta: los identificadores tienen un significado especial en el contexto de una traducción

Algunos identificadores tienen un significado especial en un lenguaje de programación que se utiliza para diversas operaciones del código. En otros lenguajes de programación, los identificadores suelen escribirse con minúsculas y CamelCase en las definiciones de clases y métodos. Sin embargo, en JavaScript, los identificadores usan snake_case. Esto significa que puedes escribir el nombre de un identificador de distintas maneras. Por ejemplo, el identificador de la instrucción if es «if» y el identificador de la instrucción for es «for». Los identificadores pueden escribirse de formas diferentes y las herramientas de traducción automática no saben cuál escoger. Para garantizar que el traductor reconocerá todos los identificadores correctamente y escogerá la traducción más adecuada, debes tener cuidado al escribir el código fuente. Asegúrate de seguir las pautas de redacción incluidas a continuación y no te olvides de utilizar los identificadores de estilo PEP8. Esto hará que traducir código sea algo mucho más sencillo.

Dificultad oculta: las cadenas pueden dividirse o fusionarse en función del contexto

Existen diversas circunstancias en las que una cadena puede dividirse y fusionarse en función del contexto. Un ejemplo sería cuando quieres incluir la cadena en varias partes del código. Lo habitual es que la cadena se divida en la primera aparición de un carácter especial de JavaScript conocido como «separador». Por ejemplo, el separador del operador + es el símbolo de suma (+) y el separador del operador & es la y comercial (&). La cadena se dividirá en la primera aparición del separador y las partes restantes de la cadena se insertarán tras la posición del separador. Por ejemplo, observa el código siguiente:

var kim = «Kim» + » Ritman»

La cadena «Kim Ritman» se divide por primera vez en el signo más. Las partes restantes de la cadena se insertarán tras la variable Kim. Por lo tanto, la variable Kim se actualizará a «Kim Ritman».

Dificultad oculta: los caracteres especiales se utilizan en los fragmentos de código

Los caracteres especiales se utilizan en los fragmentos de código de JavaScript. Esto significa que, al ejecutar el fragmento de código, los caracteres especiales utilizados para indicarlo se eliminan del código fuente y no se ven en el producto final. No deberías preocuparte por esto al traducir código, pero sí deberías asegurarte de que el traductor sea consciente de ello. El traductor debe comprobar que el código fuente no contiene caracteres especiales que puedan ser eliminados por el intérprete de JavaScript como consecuencia de la ejecución del fragmento de código. Esto puede dar lugar a traducciones con errores o en las que falte contenido, ya que es posible que el traductor interprete el código fuente como texto literal. Es posible que el traductor interprete el fragmento de código como una cadena literal y que, como consecuencia, los caracteres especiales se eliminen del código fuente.

Consejo: ejecuta el código traducido en un intérprete o un depurador para verificarlo

Si quieres asegurarte de que el código traducido es correcto, puedes usar diversas herramientas de depuración para probar el código y ver si se ejecuta según lo previsto. Ten en cuenta que debes ejecutar el código traducido en lugar del código fuente. De lo contrario, todos los identificadores se sustituirán por los valores literales del código fuente y no verás los resultados de la traducción.

Existen muchas herramientas que puedes utilizar para depurar el código traducido. Visual Studio, Eclipse, Sublime Text y Visual Studio Code son los depuradores más conocidos. Estas herramientas incorporan depuradores especializados en la depuración de código traducido.

Aunque no puedas usar ninguno de estos depuradores integrados, sigue siendo posible depurar el código traducido y garantizar que dicho código es correcto. Tienes que cambiar el nombre de los archivos de traducción e incluir el nombre del idioma, y asegurarte de que el código utiliza la variable de idioma para seleccionar el archivo de traducción válido. Por ejemplo, si traduces el código al español y el nombre del archivo de traducción es es.js, puedes añadir el código siguiente antes de ejecutar el código para seleccionar la traducción correcta.

Consejo: no te fíes al 100 % de las herramientas automáticas al traducir código JavaScript. Seguirá siendo necesaria una revisión manual.

Aunque las herramientas de traducción automática suelen ser útiles para determinadas áreas de contenido, esto no significa que puedas fiarte de ellas al 100 % cuando traduces código. Por lo general, las herramientas de traducción tienen dificultades para entender el código debido a la forma en la que está escrito. Así pues, un traductor técnico que entienda el código debe traducirlo de forma manual. En lugar de utilizar las herramientas de traducción automática como resultado final, es mejor utilizarlas como orientación. Úsalas para tener una idea general del contenido y, después, haz una revisión manual para limpiar el texto. De esta manera, puedes asegurarte de que el código se traduce correctamente.

Consejo: ten cuidado con las cadenas que incluyan declaraciones y definiciones de funciones, ya que se sustituirán por los valores finales en el tiempo de ejecución.

Las declaraciones y definiciones de funciones son cadenas únicas que se añaden al código. Al ejecutar el programa, estas definiciones y declaraciones se sustituyen por el contenido real para que el programa pueda ejecutarse adecuadamente. Por lo tanto, estas cadenas nunca deberían considerarse traducibles y tampoco deberían incluirse en el archivo de traducción. Como alternativa, lo mejor sería escribirlas en inglés para que los traductores pueden encontrarlas durante la revisión inicial.

Conclusión

Existe un gran número de posibles dificultades que debes tener en cuenta al traducir código JavaScript. Las herramientas de traducción automática no siempre son fiables para traducir código JavaScript. Por lo tanto, no deberías fiarte de ellas al 100 % y deberías hacer una revisión manual. Ten cuidado con las cadenas que incluyan declaraciones y definiciones de funciones, ya que se sustituirán por los valores finales en el tiempo de ejecución. Si tienes estos consejos en cuenta, disfrutarás de una experiencia mucho más agradable al traducir código JavaScript.

sanscrit
info+gravatar@sanscrit.net