Adicionar idiomas

Adicione novos idiomas de destino ao atualizar o array targets em i18n.json e executar a CLI. Para novos idiomas, são gerados ficheiros de tradução completos, enquanto as traduções existentes permanecem inalteradas.

Adicionar um idioma#

Atualize a configuração do seu i18n.json:

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

Execute a CLI:

npx lingo.dev@latest run

A CLI cria ficheiros 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 os idiomas existentes e os novos de forma diferente:

Variantes regionais#

A CLI suporta variantes regionais de idioma com etiquetas 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 ficheiro de tradução distinto, com terminologia, ortografia e tom adequados à região.

Geração direcionada#

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

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

Isto é útil quando adiciona um idioma de cada vez para revisão da qualidade antes de avançar para mais.

Remover idiomas#

Remova um idioma do array targets e a CLI deixa de o processar. Os ficheiros existentes não são eliminados — remova-os manualmente, se necessário.

Próximos passos#