Adicionar idiomas

Adicione novos idiomas de destino atualizando o array targets em i18n.json e executando a CLI. Para novos idiomas, a CLI gera arquivos de tradução completos, enquanto as traduções existentes permanecem inalteradas.

Adicionar um idioma#

Atualize a configuração do i18n.json:

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  }
}

Execute a CLI:

npx lingo.dev@latest run

A CLI cria arquivos de tradução completos para cada novo idioma:

locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

Idiomas existentes vs. novos#

A CLI trata idiomas existentes e novos de formas diferentes:

Variantes regionais#

A CLI oferece suporte a variantes regionais de idiomas usando tags BCP 47:

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

Cada variante recebe um arquivo de tradução próprio, com terminologia, ortografia e tom adequados à região.

Geração direcionada#

Gere traduções para um idioma específico sem processar todos os targets:

npx lingo.dev@latest run --target-locale de

Isso é útil ao adicionar um idioma por vez para fazer a revisão da qualidade antes de expandir ainda mais.

Remover idiomas#

Remova um idioma do array targets e a CLI deixará de processá-lo. Os arquivos existentes não são excluídos — remova-os manualmente, se necessário.

Próximos passos#