Adicionar e gerenciar idiomas na CLI v0

Selecione a variante de idioma desejada, adicione um idioma de destino na versão legada e verifique o comportamento do arquivo e da aplicação.

Na v0, locale.source define o idioma original e locale.targets seleciona os idiomas de destino para traduções recorrentes. Escolha a variante de que seus leitores precisam e confira se a configuração, os nomes dos arquivos, o backend e a aplicação a usam de forma consistente.

Adicionar um idioma de destino #

Para adicionar alemão aos idiomas espanhol e francês já disponíveis, edite i18n.json:

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

Execute o binário v0 instalado para esse idioma de destino:

sh
lingo run --target-locale de

A opção substitui a lista de idiomas de destino nesta execução e permite selecionar um idioma que não esteja na configuração. Adicione-o à configuração para as próximas execuções. Um padrão de arquivos separados locales/[locale].json grava locales/de.json; confira os valores e carregue esse arquivo na aplicação antes de disponibilizar o alemão aos leitores.

Quando um idioma de destino ainda não existe, é preciso preencher todas as chaves selecionadas. Quando já existe, os valores atuais normalmente são mantidos e as chaves ausentes são preenchidas, embora alterações no conteúdo de origem ainda possam exigir uma nova tradução. Evite combinar a inclusão de um novo idioma com uma atualização forçada abrangente se os outros idiomas já aprovados precisarem permanecer inalterados.

Restringir uma execução a um idioma de destino não atualiza a referência existente da soma de verificação do conteúdo de origem. Uma execução normal posterior pode reprocessar o conteúdo de origem alterado. Por isso, consulte as regras de consolidação antes de presumir que uma revisão de escopo restrito resolve a questão de forma definitiva.

Usar região e sistema de escrita quando necessário #

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

Idiomas com indicação de região diferenciam as convenções solicitadas: color/colour em inglês, ordenador/computadora em espanhol e trem/comboio em português mostram por que escolher apenas o idioma pode não ser suficiente. O uso ainda depende do contexto; uma etiqueta não garante que todas as expressões geradas sejam adequadas ao público. O chinês também pode exigir distinções de sistema de escrita ou região, como zh-Hans ou zh-TW.

Confira as listas da versão instalada:

sh
lingo show locale sources
lingo show locale targets

Essas listas não garantem aceitação nem qualidade em todos os backends. Teste o par escolhido em uma execução pequena antes de ampliar o escopo, em vez de se basear em uma contagem histórica de idiomas.

Separar a identidade do idioma da organização dos arquivos #

O processamento legado normaliza diferentes grafias usadas pelas plataformas nas solicitações de API. Os arquivos ainda podem exigir sublinhados ou a nomenclatura de recursos do Android. Use a configuração de delimitador e a organização do formato e confira onde os arquivos foram efetivamente gravados.

A tradução não define dir, não espelha controles nem adiciona roteamento. Árabe, hebraico, persa e urdu geralmente precisam de apresentação da direita para a esquerda (RTL); confira a interface que usa o conteúdo, incluindo os números e identificadores inseridos nele. Além de carregar o conteúdo, a aplicação precisa reconhecer o novo idioma.

Remover um idioma de destino #

Remover um código de locale.targets impede que ele seja selecionado em execuções futuras. Os arquivos existentes permanecem. Decida separadamente se deseja mantê-los, deixar de disponibilizá-los ou excluí-los. Expurgar é uma operação destrutiva e pode selecionar conteúdo de origem; não equivale a remover um idioma da configuração.