Tradução
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.
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.