Documentação oficial do Angular traduzida com IA
(angular-kr-docs.web.app)Olá! Recentemente, ao entrar para um projeto com Angular, tive dificuldades por causa da falta de material em coreano.
Então usei um projeto open source de tradução com IA para traduzir a documentação oficial do Angular para o coreano e até publicar tudo em apenas 5 horas.
No momento, a maior parte ainda está apenas com uma tradução inicial feita por IA!
Andamento da tradução
- Cerca de 300 arquivos
.mdjá foram traduzidos - Ainda estou traduzindo arquivos que não foram traduzidos automaticamente, como arquivos HTML
- Dá para entender os conceitos principais em coreano junto com os exemplos de código
- É fácil encontrar o conteúdo necessário porque a estrutura é igual à do original em inglês
Na verdade, fiquei em dúvida entre usar a categoria Show GN para apresentar a documentação traduzida do Angular ou a categoria News para apresentar a ferramenta de tradução.
Talvez não haja tanta gente usando Angular, mas escolhi Show GN porque achei que poderia ajudar quem estiver procurando material em coreano.
Ferramenta usada
Encontrei um pequeno projeto chamado "ai-markdown-translator", e o resultado foi melhor do que eu esperava.
Gostei bastante, então agora estou forkando o repositório e modificando o código para contribuir com o projeto.
Vantagens
- Projeto open source especializado na tradução de documentos Markdown
- Consegue traduzir recursivamente arquivos com extensões específicas dentro de uma pasta
- Traduz tudo de uma vez com o comando
npx ai-markdown-translator -i . -e md -l "Korean" --log - Preserva, na maior parte, a estrutura gramatical e o formato Markdown durante a tradução
- Ferramenta adequada para documentação técnica gerada a partir de conteúdo em MD
Limitações
- Em alguns casos, traduz termos técnicos de forma muito literal, como traduzir Signal por "sinal"
- Descobri um problema em que alguns caminhos de referência de arquivos eram alterados incorretamente
- Como ainda está no nível de tradução inicial, há pontos que precisam de melhorias
Processo de tradução e publicação
- Clonei o repositório oficial da documentação do Angular
- Depois de executar o comando, cerca de 300 arquivos foram traduzidos em 2 horas
- Corrigi caminhos de referência de arquivos que estavam errados
- Fiz a publicação consultando a configuração do Firebase do projeto Angular existente
Ainda há muita coisa para lapidar, então vou revisar e corrigir aos poucos, mas achei que o resultado ficou bem bom em relação ao tempo investido.
Recomendo testar para quem quiser traduzir documentação técnica escrita em formato MD!!
Muito obrigado por lerem até aqui! Tenham um ótimo dia!! ❤️🔥
4 comentários
Uau! Angular!
...! Você usa Angular?
Hoje em dia parece que quase não há usuários na Coreia, então fico muito feliz em ver seu comentário! kkkkk
Não sei usar React e só sei um pouco de Angular, mas fico feliz em ver um texto sobre Angular na comunidade coreana.
Eu só usava React e acabei migrando para Angular, então é o contrário mesmo kkk
Se algum dia tiver a oportunidade, volto a escrever sobre Angular,,, hehe