Documentación oficial de Angular traducida con IA
(angular-kr-docs.web.app)¡Hola! Hace poco me uní a un proyecto con Angular y me costó bastante por la falta de material en coreano.
Así que aproveché un proyecto open source de traducción con IA para traducir la documentación oficial de Angular al coreano y hasta publicarla, todo en solo 5 horas.
Por ahora, en la mayoría de los casos solo se ha hecho una primera pasada de traducción con IA.
Estado del progreso de la traducción
- Se completó la traducción de alrededor de 300 archivos md
- También se están traduciendo archivos que no se tradujeron automáticamente, como archivos HTML
- Se pueden entender los conceptos clave en coreano junto con ejemplos de código
- Es fácil encontrar el contenido necesario porque mantiene la misma estructura que el original en inglés
La verdad, estuve pensando si usar la categoría Show GN para presentar la documentación de Angular traducida o la categoría News para presentar la herramienta de traducción.
Puede que no haya tanta gente usando Angular, pero pensé que quizá podría ayudar a quienes estén buscando material en coreano, así que elegí Show GN.
Herramienta utilizada
Encontré un pequeño proyecto llamado "ai-markdown-translator", y el resultado fue mucho mejor de lo que esperaba.
Me gustó bastante, así que ahora estoy forkeando el repositorio y modificando el código para contribuir al proyecto.
Ventajas
- Proyecto open source especializado en traducir documentos Markdown
- Puede traducir de forma recursiva archivos con extensiones específicas dentro de una carpeta
- Traduce todo de una vez usando el comando
npx ai-markdown-translator -i . -e md -l "Korean" --log - Conserva en gran medida la estructura sintáctica y el formato Markdown al traducir
- Herramienta adecuada para documentación técnica que genera páginas a partir de contenido MD
Limitaciones
- Queda debiendo en traducciones literales de términos técnicos, como traducir Signal como “señal”
- Encontré un problema en el que algunas rutas de referencia de archivos se cambian incorrectamente
- Hay partes que todavía necesitan mejoras porque el resultado sigue siendo de nivel borrador inicial
Proceso de traducción y despliegue
- Clonar el repositorio oficial de documentación de Angular
- Ejecutar el comando y, dos horas después, completar la traducción de unos 300 archivos
- Corregir las rutas de referencia de archivos que estaban mal
- Desplegar tomando como referencia la configuración de Firebase del proyecto existente de Angular
Todavía hay muchas partes por pulir, así que tendré que revisarlas y corregirlas poco a poco, pero creo que el resultado quedó bastante bien para el tiempo invertido.
¡¡Se los recomiendo a quienes quieran probar traduciendo documentación técnica escrita en formato MD!!
¡Gracias por leer hasta aquí! ¡Que tengan un excelente día! ❤️🔥
4 comentarios
¡Guau! ¡Angular!
...! ¿Usas Angular?
Últimamente parece que casi no hay usuarios en Corea, así que me da muchísimo gusto que hayas dejado un comentario. ¡jajaja!
No sé usar React y solo sé un poco de Angular, pero me alegra ver una publicación sobre Angular en la comunidad coreana.
Yo solo usaba React y terminé pasándome a Angular, así que es al revés jajaja.
Si algún día se da la oportunidad, volveré a escribir algo sobre Angular,,, jaja