Como Traduzir Automaticamente seu Blog Hugo Usando AI

Introdução

Uma vez que criamos nosso próprio blog, gostaríamos que ele suportasse múltiplos idiomas. Isso não apenas expande nosso público, mas também melhora o desempenho SEO do blog. No entanto, traduzir manualmente as postagens do blog é uma tarefa que consome muito tempo e é trabalhosa, exigindo tradutores profissionais. Mas com o desenvolvimento da AI, as coisas são diferentes agora; usando AI, você pode traduzir facilmente seu blog para qualquer idioma desejado. Para facilitar isso, criei uma ferramenta que utiliza AI para automatizar a tradução de suas postagens de blog, permitindo que você suporte facilmente múltiplos idiomas.

Você pode encontrar a ferramenta em hugo-translator.

Preparação

Antes de começar, você precisa preparar o seguinte:

1. Um blog Hugo em funcionamento
2. Ambiente Node.js e npm
3. API key da OpenAI (para tradução com AI)
4. Conhecimento básico de operações de linha de comando

Passos de Implementação

1. Obter a Ferramenta

git clone https://github.com/lxb1226/hugo-translator.git
cd hugo-translator

2. Instalar a Ferramenta de Tradução AI

Usaremos a ferramenta ai-markdown-translator para traduzir arquivos Markdown. Primeiro, instale-a globalmente:

npm install -g ai-markdown-translator

3. Configurar Variáveis de Ambiente

Configure a API key da OpenAI:

export OPENAI_API_KEY='your-api-key'

Se você não tiver uma API key da OpenAI, também pode usar uma API de terceiros. Você pode comprar uma API key de terceiros através deste link. Depois, você pode configurar:

export OPENAI_URL='your api url'
export API_KEY='your-api-key'

Você também pode adicionar esta configuração ao seu arquivo .bashrc ou .zshrc para que tenha efeito permanente.

4. Criar o Script de Tradução

Crie um arquivo de script chamado translate-posts.sh para automatizar o processo de tradução. Este script:

• Detectará automaticamente as postagens do blog
• Suportará tradução multilíngue
• Omitirá as postagens já traduzidas
• Fornecerá progresso detalhado de tradução e estatísticas

Características principais incluem:

1. Suporte Multilíngue: Suporte padrão para múltiplos idiomas, incluindo inglês, japonês e coreano.
2. Detecção Inteligente: Identifica automaticamente idiomas de origem e destino.
3. Atualizações Incrementais: Traduz apenas conteúdo novo ou modificado.
4. Tratamento de Erros: Tratamento completo de erros e registro.
5. Exibição de Progresso: Exibição em tempo real do progresso e status da tradução.

5. Uso

Uso básico:

./translate-posts.sh

Idiomas de destino personalizados:

TARGET_LANGS="en ja ko" ./translate-posts.sh

6. Regras de Nomenclatura de Arquivos

Os arquivos traduzidos serão nomeados automaticamente de acordo com a convenção de nomenclatura de internacionalização do Hugo:

• Versão em inglês: post-name.en.md
• Versão em japonês: post-name.ja.md
• Versão em coreano: post-name.ko.md

Referências

• Documentação Oficial de Suporte Multilíngue do Hugo
• Documentação da API OpenAI
• Guia de Uso do ai-markdown-translator
• hugo-translator