hugo-translator: script Python para tradução automática do conteúdo do blog do Hugo

Introdução geral

O hugo-translator é uma ferramenta de tradução automática projetada para o construtor de sites estáticos do Hugo, hospedada no GitHub e criada pelo desenvolvedor Rico00121. A ferramenta foi projetada para ajudar os usuários do Hugo a traduzir rapidamente o conteúdo de seus blogs para vários idiomas, utilizando a API do Google Translate para suporte multilíngue eficiente. Quer você seja um blogueiro individual ou um webmaster que precise internacionalizar seu conteúdo, essa ferramenta simplifica o processo de tradução. Ela é de código aberto e permite que os usuários façam download, modifiquem e contribuam livremente com o código, o que a torna ideal para uma comunidade de desenvolvedores que busca eficiência e personalização. Atualmente, o projeto ainda está em fase de desenvolvimento, com funções relativamente básicas, mas com certo grau de praticidade e potencial.

Lista de funções

• Tradução automatizada do conteúdo do blogTradução: Traduzir os arquivos Markdown do Hugo (por exemplo, index.en.md) para o idioma especificado.
• Suporte à API do Google TranslateTradução de conteúdo rápida e precisa por meio dos serviços de tradução do Google.
• saída multilíngueNo momento, está codificado para suportar francês, alemão e espanhol, com mais idiomas planejados para o futuro.
• Digitalização e processamento de documentosMarkdown: examina um diretório especificado, identifica e traduz arquivos Markdown qualificados.
• Código aberto e extensívelO código está disponível publicamente no GitHub e pode ser desenvolvido por usuários sob demanda.

Usando a Ajuda

O hugo-translator é uma ferramenta de linha de comando baseada em Go, usada principalmente para traduzir o conteúdo do blog Hugo. Aqui está um guia detalhado de instalação e uso para ajudá-lo a começar.

Processo de instalação

1. Preparação do ambiente
   • Certifique-se de ter a linguagem de programação Go instalada em seu computador (versão recomendada 1.16 ou superior). Isso pode ser feito com o comando versão go Verifique se a instalação foi bem-sucedida.
   • Você precisará de uma conta do Google Cloud com a API do Google Translate ativada. Faça login no Console do Google Cloud, crie um projeto, ative a API do Translate e gere o arquivo de chave da API (geralmente no formato JSON, por exemplo google-secret.json).
2. Download do código do projeto
   • Abra um terminal e digite o seguinte comando para clonar o projeto localmente:

     git clone https://github.com/Rico00121/hugo-translator.git
     

   • Vá para o catálogo de projetos:

     cd hugo-translator
     

3. Configuração da API do Google Translate
   • Adicione o download google-secret.json no diretório raiz do projeto hugo-translator. Esse é o arquivo de credenciais para chamar a API do Google Translate, portanto, verifique se o caminho está correto e se o nome do arquivo não foi alterado.
4. compilador
   • Execute o seguinte comando no diretório do projeto para obter as dependências e compilar o executável:

     go get
     go build translate.go
     

   • Quando a compilação é concluída, ele gera um arquivo chamado traduzir executável (Windows translate.exe).
5. Verificar a instalação
   • importação . /translate -h(Windows translate.exe -h), se a mensagem de ajuda for exibida, a instalação foi bem-sucedida.

Uso

A função principal do hugo-translator é traduzir arquivos Markdown em inglês do blog Hugo para outros idiomas. Aqui estão as etapas para fazer isso:

Preparar os arquivos do blog do Hugo

• Certifique-se de que o conteúdo do seu blog Hugo comece com index.en.md Formate os nomes para indicar o conteúdo em inglês. Exemplo:

content/posts/my-blog/index.en.md

• O conteúdo do arquivo deve estar no formato Markdown padrão, contendo a capa do Hugo (por exemplo, título, data etc.) e o corpo do texto.

Execute o comando de tradução

1. Operações básicas de tradução

• No terminal, execute o seguinte comando para especificar o caminho do arquivo a ser traduzido:

  . /translate
  

  Exemplo:

  . /translate content/posts/my-blog/index.en.md
  

• A versão atual traduz automaticamente o arquivo para o francês (fr), alemão (de) e espanhol (es) e gera o arquivo correspondente, por exemplo. index.fr.mdeindex.de.mdeindex.es.md.

2. Verificação do arquivo de saída

• Quando a tradução estiver concluída, o arquivo do novo idioma aparecerá no mesmo diretório que o arquivo original. Exemplo:

  content/posts/my-blog/
  index.en.md
  index.fr.md
  index.de.md
  ├── index.es.md
  

• Abra esses arquivos e verifique os resultados da tradução. A seção de capa geralmente permanece inalterada, e o corpo do texto é traduzido para o idioma de destino.

advertência

• Convenções de nomenclatura de arquivosA ferramenta atualmente só reconhece index.en.md outras convenções de nomenclatura (por exemplo index.md) não é suportado no momento.
• Restrições de traduçãoIdioma: Atualmente, o suporte a idiomas é codificado (francês, alemão, espanhol) e não é possível especificar outros idiomas por meio da linha de comando. A seleção de idioma pode ser adicionada em versões futuras.
• requisito de redeÉ necessário ter acesso à Internet para executá-lo, pois a tradução depende da API do Google Translate.
• detecção de errosSe a tradução falhar, verifique o google-secret.json Eles estão posicionados corretamente ou verifique se a conexão de rede está funcionando corretamente.

Operação da função em destaque

Suporte multilíngue automatizado

• O destaque do hugo-translator é que ele gera versões em vários idiomas de um arquivo de uma só vez. Por exemplo, se você digitar um arquivo de blog em inglês, ele gerará automaticamente traduções em três idiomas, poupando-lhe o trabalho de traduzi-los manualmente, um por um.
• Exemplo de operação:

. /translate content/posts/my-blog/index.en.md

• Resultados de saída:
  • index.fr.mdVersão em francês
  • index.de.md: Versão em alemão
  • index.es.md: Versão em espanhol

Extensões de código aberto

• Se precisar traduzir para outro idioma, você pode modificar o código-fonte. Por exemplo, abra o arquivo translate.go encontre a parte lógica da tradução (geralmente envolvendo o translateTextWithModel ), adicione o código do idioma de destino (por exemplo "isso" (indica italiano).
• Modificar e recompilar:

go build translate.go

• Essa flexibilidade é ideal para usuários com habilidades de programação.

Exemplo de cenários de uso

Digamos que você tenha uma postagem no blog index.en.mdO conteúdo é o seguinte:

---
título: "Meu primeiro blog"
data: 2023-01-01
---
Olá, esta é minha primeira postagem no blog!

Executar comando:

. /translate content/posts/my-blog/index.en.md

Após a tradução.index.fr.md Pode ser o seguinte:

---
título: "Meu primeiro blog"
data: 2023-01-01
---date: 2023-01-01
Salut, ceci est mon premier article de blog !

Os arquivos de outros idiomas são semelhantes e podem ser usados diretamente no projeto Hugo para implementar um blog multilíngue.

Orientações para melhorias futuras

• A versão atual é simples, mas o desenvolvedor Rico00121 mencionou no GitHub sobre os aprimoramentos planejados, como suporte a idiomas específicos, processamento em lote de todos os arquivos em um diretório e muito mais. Os usuários podem acompanhar as atualizações do projeto ou contribuir.

Com as etapas acima, você pode usar facilmente o hugo-translator para traduzir o conteúdo do seu blog para vários idiomas, melhorando a acessibilidade e a internacionalização do seu site.