Mejoras y correcciones

[ckdvk]

Mejoras y correcciones en la traducción de "Eloquent JavaScript en Español"

Durante el proceso de revisión, se han corregido diversos aspectos tanto en el código como en la traducción para mejorar la claridad, la precisión y la funcionalidad del material.

Correcciones y mejoras principales:

1. Correcciones en el código fuente: Se han solucionado varios problemas en los ejemplos de código, algunos de los cuales no funcionaban correctamente (o, sin más, no funcionaban). También se han realizado ajustes para que los fragmentos de código no ejecutables en el navegador queden correctamente desactivados con lang:null, manteniendo así la coherencia y evitando confusiones.

2. Revisión de la traducción: Se ha realizado un trabajo exhaustivo para mejorar la naturalidad y precisión del texto en español. En algunos casos, la traducción inicial presentaba estructuras que parecían demasiado literales o influenciadas por el inglés, por lo que se han adaptado para que suenen más fluidas en español, sin perder fidelidad al original. Se ha procurado que el texto resultante sea natural en español de España sin que parezca extraño en español latinoamericano.

3. Mejoras en la coherencia y revisión de posibles automatizaciones: En algunas secciones se detectaron frases que probablemente fueron traducidas de manera automática sin una revisión posterior, lo que generaba ciertas inconsistencias. Se ha hecho un esfuerzo por armonizar estos fragmentos, asegurando que el texto mantenga un estilo uniforme y sea fácilmente comprensible. Esta revisión ha contribuido en parte a la mejora de la funcionalidad del código del sandbox, que fallaba en muchas partes debido a traducciones accidentales.

4. Mantenimiento de la estructura del proyecto: Siguiendo la recomendación del traductor original, no se han editado directamente los ficheros HTML generados, sino que los cambios se han realizado en los archivos .md originales, de modo que el contenido pueda regenerarse correctamente utilizando el Makefile. Además:

   • Se ha añadido la funcionalidad de notas del traductor (y otras notas), asegurando su compatibilidad tanto en HTML como en LaTeX (donde aparecerán como un pie de página). Puede utilizarse escribiendo la nota correspondiente en la forma {{note "Nota "}}.
   • Se han realizado los ajustes necesarios en los archivos fuente para que la generación de código HTML y LaTeX refleje correctamente estas mejoras.
   • Se han revisado los archivos JavaScript correspondientes para garantizar su correcto funcionamiento.

5. Actualización de la portada: Se ha mejorado la calidad de la imagen de portada, aunque podría ser conveniente reducir su peso, dado que igualmente se ha guardado en formato .jpg. También se ha actualizado para reflejar adecuadamente las contribuciones realizadas en esta revisión.

Estado actual del proyecto:

• La versión actual ha sido revisada en detalle y funciona correctamente.
• Se ha mejorado la traducción y la ejecución del código, respetando la estructura y el estilo del original, pero mejorando la naturalidad del español y la funcionalidad del código, que ahora es siempre ejecutable en los entornos de sandbox.
• Se han corregido enlaces y ajustes en la estructura de los capítulos para mejorar la experiencia de lectura, tanto en HTML como en LaTeX.

Con estas mejoras, el proyecto mantiene su fidelidad al original, pero con una traducción más pulida y una ejecución del código sin errores. Espero que estos cambios sean útiles y ayuden a mejorar la experiencia de los lectores en español.

Motivación:

Al comenzar a estudiar JavaScript, me interesé en esta versión en español de Eloquent JavaScript, ya que me pareció un excelente recurso para aprender el lenguaje como introducción. Sin embargo, al avanzar en la lectura, noté que había algunas áreas en las que la traducción podía pulirse para mejorar su fluidez y naturalidad en español. Además, encontré ciertos problemas en el código de los ejemplos, que en algunos casos no funcionaban correctamente.

Por ello, decidí contribuir con una revisión completa, corrigiendo estos detalles tanto en la traducción como en el código, con el objetivo de mantener la fidelidad al original mientras se mejora la claridad y la precisión del texto. También he añadido compatibilidad para las notas del traductor en HTML y LaTeX, asegurando que la generación de los archivos se mantenga consistente con el flujo de trabajo del proyecto.

Termino con mi agradecimiento a midudev por el trabajo de base, que ha hecho más sencillo el realizar una traducción aceptable de todo el libro.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
eloquent-javascript-es	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Feb 24, 2025 4:10pm