Documentation officielle d’Angular traduite avec l’IA
(angular-kr-docs.web.app)Bonjour ! J’ai récemment rejoint un projet Angular et j’ai eu du mal à avancer faute de ressources en coréen.
J’ai donc utilisé un projet open source de traduction par IA pour traduire en coréen la documentation officielle d’Angular et la mettre en ligne en seulement 5 heures.
Pour le moment, la majeure partie du travail n’en est qu’au stade d’une première traduction réalisée par l’IA. !
État d’avancement de la traduction
- Environ 300 fichiers md déjà traduits
- Traduction en cours des fichiers qui ne sont pas automatiquement traduits, comme les fichiers HTML
- Possibilité de comprendre les concepts clés en coréen avec les exemples de code
- Même structure que l’original anglais, ce qui permet de retrouver facilement les informations nécessaires
En réalité, j’ai hésité entre utiliser la catégorie Show GN pour présenter cette documentation Angular traduite, ou la catégorie News pour présenter l’outil de traduction.
Il n’y a sans doute pas énormément de personnes qui utilisent Angular, mais je me suis dit que cela pourrait peut-être aider celles et ceux qui cherchent des ressources en coréen, donc j’ai choisi Show GN !
Outils utilisés
J’ai découvert un petit projet appelé "ai-markdown-translator", et le résultat a été meilleur que prévu.
Il m’a beaucoup plu, au point que je suis en train de fork le dépôt et de modifier le code pour contribuer au projet.
Points forts
- Projet open source spécialement conçu pour la traduction de documents Markdown
- Possibilité de traduire récursivement les fichiers d’une extension donnée dans un dossier
- Traduction en une seule fois avec la commande
npx ai-markdown-translator -i . -e md -l "Korean" --log - Préserve en grande partie la structure syntaxique et le format Markdown lors de la traduction
- Outil bien adapté à la documentation technique générée à partir de contenus MD
Limites
- La traduction littérale de termes techniques, comme Signal rendu par « signal », reste décevante
- J’ai constaté des problèmes où certains chemins de référence de fichiers étaient modifiés de façon incorrecte
- Certains passages nécessitent encore des améliorations, car cela reste au niveau d’une première traduction
Processus de traduction et de déploiement
- Clonage du dépôt de la documentation officielle d’Angular
- Exécution de la commande, puis environ 300 fichiers traduits au bout de 2 heures
- Correction des chemins de référence de fichiers erronés
- Déploiement en s’appuyant sur la configuration Firebase d’un projet Angular existant
Il reste encore beaucoup de choses à peaufiner et à corriger progressivement, mais le résultat me semble plutôt bon au regard du temps investi.
Je recommande de tester cet outil à celles et ceux qui souhaitent traduire de la documentation technique rédigée au format MD !!
Merci d’avoir lu jusqu’au bout ! Passez une excellente journée !! ❤️🔥
4 commentaires
Waouh ! Angular !
... ! Vous utilisez Angular ?
On dirait qu'il n'y a presque plus d'utilisateurs coréens ces temps-ci, alors ça me fait vraiment super plaisir de voir votre commentaire ! mdr
Je ne sais pas utiliser React, je ne connais qu’un peu Angular, donc ça me fait plaisir de voir un article sur Angular dans la communauté coréenne.
Moi, je n’utilisais que React avant de passer à Angular, donc c’est l’inverse mdr
Si j’en ai l’occasion un jour, j’écrirai à nouveau un article sur Angular,,, haha