Pular para o conteúdo principal

Tradução

nota

A partir da versão v1.20.0, o comando de tradução foi removido do @logto/cli e mantido como um pacote independente @logto/translate no monorepo do Logto. Por favor, consulte o CLI de tradução para mais detalhes.

Use CLI para gerenciar traduções i18n. Esses comandos são para desenvolvedores que desejam contribuir para o Logto. Se você apenas deseja usar o Logto com tradução personalizada, consulte este guia.

Sincronizar chaves

Digamos que fizemos algumas alterações nas chaves de tradução na pasta en do pacote phrases. Queremos sincronizar essas alterações com a pasta pt-BR. Execute o comando abaixo para sincronizar as chaves de tradução e a estrutura de arquivos:

pnpm cli translate sync-keys --target pt-BR

Este comando lerá todas as chaves de tradução da pasta do idioma de origem (en por padrão) e as sincronizará com a pasta do idioma de destino (pt-BR neste exemplo).

  • Se a pasta do idioma de destino não existir, ela será criada automaticamente;
  • Se a pasta do idioma de destino já existir, ela será atualizada com novas chaves e removida com chaves obsoletas.

Para cada chave de tradução:

  • Se uma chave estiver faltando no destino, ela será adicionada com um comentário para indicar que a frase não está traduzida (marcada com /** UNTRANSLATED */);
  • Se uma chave estiver faltando na linha de base, ela será removida do destino;
  • Se uma chave existir tanto na linha de base quanto no destino, o valor do destino será usado.

Para sincronizar chaves para todos os idiomas no pacote phrases, execute o comando abaixo:

pnpm cli translate sync-keys --target all

Assim, podemos nos concentrar em atualizar as chaves de tradução na pasta do idioma de origem, e as chaves de tradução em outros idiomas serão atualizadas automaticamente.

info

Este comando é executado para o pacote phrases por padrão. Você pode especificar o nome do pacote usando a opção --package. Por exemplo, use --package phrases-experience para sincronizar chaves para o pacote phrases-experience.

Após sincronizar as chaves, podemos traduzir as chaves usando a API do ChatGPT.

Traduzir chaves usando o ChatGPT

Execute o comando abaixo para traduzir chaves usando o ChatGPT:

pnpm cli translate sync

Este comando traduzirá todas as chaves não traduzidas (marcadas com /** UNTRANSLATED */) em todos os idiomas nos pacotes phrases e phrases-experience. Observe que uma variável de ambiente OPENAI_API_KEY é necessária para executar este comando.