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:
{
"locale": { "source": "en", "targets": ["es", "fr", "de"] }
}Execute o binário instalado da v0 para esse idioma de destino:
lingo run --target-locale deA 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 #
{
"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:
lingo show locale sources
lingo show locale targetsEstas 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.