Adicionar e gerir idiomas na CLI v0

Selecione a variante linguística pretendida, adicione um idioma de destino na versão antiga e verifique o comportamento do ficheiro e da aplicação.

Na v0, locale.source identifica o idioma original e locale.targets seleciona os idiomas de destino para traduções recorrentes. Escolha a variante de que os seus leitores precisam e confirme que a configuração, os nomes dos ficheiros, o sistema de processamento e a aplicação a utilizam de forma consistente.

Adicionar um idioma de destino #

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

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

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

sh
lingo run --target-locale de

A opção substitui a lista de idiomas de destino apenas nesta execução e permite selecionar um idioma que não consta da configuração. Adicione-o à configuração para futuras execuções. Um padrão de ficheiros separados locales/[locale].json gera locales/de.json; verifique os valores e carregue esse ficheiro na aplicação antes de disponibilizar o alemão aos leitores.

Um idioma de destino ainda não existente precisa de todas as chaves selecionadas. Se já existir, os valores são normalmente mantidos e as chaves em falta são preenchidas, embora as alterações ao conteúdo de origem possam exigir uma nova tradução. Evite combinar a adição inicial de um idioma com uma execução forçada de âmbito alargado se os restantes idiomas já aceites tiverem de permanecer inalterados.

Limitar 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 voltar a processar o conteúdo de origem alterado. Por isso, consulte as regras de resolução antes de assumir que uma revisão de âmbito limitado resolve a situação de forma definitiva.

Usar a região e o sistema de escrita quando forem relevantes #

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

Os idiomas com indicação de região distinguem as convenções pretendidas: color/colour em inglês, ordenador/computadora em espanhol e trem/comboio em português mostram por que razão escolher apenas o idioma pode não ser suficiente. O uso continua a depender 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 de região, como zh-Hans ou zh-TW.

Consulte as listas da versão instalada:

sh
lingo show locale sources
lingo show locale targets

Estas listas não garantem a aceitação nem a qualidade em todos os sistemas de processamento. Valide o par escolhido com uma pequena execução antes de alargar o âmbito, em vez de se basear numa contagem histórica de idiomas.

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

O processamento da versão antiga normaliza várias grafias específicas de plataformas nos pedidos à API. Os ficheiros podem, ainda assim, exigir sublinhados ou nomes segundo as convenções dos recursos Android. Use a definição de delimitador e a organização do formato e, em seguida, verifique onde os ficheiros são efetivamente gerados.

A tradução não define dir, não inverte os controlos nem adiciona encaminhamento. O árabe, o hebraico, o persa e o urdu precisam habitualmente de apresentação RTL; verifique a interface que utiliza o conteúdo, incluindo os números e identificadores incorporados. Além de carregar o conteúdo do novo idioma, a aplicação tem de o reconhecer.

Remover um idioma de destino #

Remover um código de locale.targets impede a sua seleção em execuções futuras. Os ficheiros existentes mantêm-se. Decida separadamente se pretende mantê-los, deixar de os disponibilizar ou eliminá-los. Purgar é uma operação destrutiva e pode selecionar conteúdo de origem; não equivale a remover um idioma configurado.