Localizar uma aplicação Rails

Traduza ficheiros YAML do Rails com o idioma na raiz e verifique a pesquisa de mensagens, a interpolação, as formas de plural e a seleção do idioma em cada pedido.

O Rails já atribui nomes estáveis às mensagens através de t e I18n.t. O Lingo.dev pode traduzir o YAML associado a esses nomes, enquanto o Rails continua a tratar da pesquisa de mensagens, da interpolação e da seleção do idioma. Comece por uma saudação e uma contagem de notificações e verifique-as com as mesmas funções auxiliares que a aplicação utiliza.

Coloque as mensagens de origem num ficheiro de idioma do Rails #

Crie ou acrescente conteúdo a config/locales/en.yml:

yaml
en:
  home:
    index:
      welcome: "Welcome, %{name}!"
      cta: "Create an account"
  notifications:
    unread:
      one: "One unread notification"
      other: "%{count} unread notifications"

Em app/views/home/index.html.erb, a saudação pode usar a pesquisa relativa à vista:

erb
<h1><%= t(".welcome", name: @user_name) %></h1>
<p><%= t("notifications.unread", count: @unread_count) %></p>

O caminho da vista dá a .welcome a chave completa home.index.welcome. O código que faz a chamada fornece name e count; a tradução tem de preservar esses nomes de interpolação. As chaves de plural, como one e other, identificam variantes e mantêm-se inalteradas.

À medida que alarga a cobertura, transfira as restantes etiquetas definidas diretamente no código das vistas, os textos de correio eletrónico e as mensagens de erro dos modelos para os espaços de nomes dos idiomas adequados. Traduzir um ficheiro só afeta o código que carrega as suas mensagens.

Selecione YAML com o idioma na raiz #

O Rails lê o idioma a partir da raiz do YAML. Se mudar o nome de en.yml para es.yml, mas mantiver en:, as mensagens continuam a estar definidas como inglesas. Use o processador yaml-root-key para traduzir os valores e mudar o nome da raiz na mesma operação.

Instale e associe a CLI a partir da raiz do projeto:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'config/locales/en.yml' --yes
lingo link

Mantenha os IDs da organização e do motor de localização gravados em .lingo/config.json. Preencha a matriz files com as entradas de origem que o projeto utiliza:

json
[
  { "pattern": "config/locales/en.yml", "format": "yaml-root-key" },
  { "pattern": "config/locales/*.en.yml", "format": "yaml-root-key" }
]

A segunda entrada abrange ficheiros separados por área funcional, como mailers.en.yml, sem selecionar os ficheiros de tradução correspondentes. Remova-a se o projeto não tiver ficheiros deste tipo. Defina o formato explicitamente: o YAML genérico mantém todas as raízes, enquanto a deteção pela CLI exige uma escolha explícita para as origens YAML. YAML com o idioma na raiz descreve o requisito de mapeamento com uma única raiz e o comportamento de reconstrução.

Traduza e inspecione os valores carregados #

Para gerar os ficheiros de destino em falta, execute:

sh
lingo push --backfill-missing --wait

Quando a execução terminar, abra config/locales/es.yml e confirme que a raiz é es:. Verifique se as chaves aninhadas e os nomes de interpolação correspondem aos da origem. Inspecione os comentários, as âncoras e os aliases após a serialização. Uma estrutura de origem diferente pode exigir um caminho de destino explícito.

Carregue o resultado na consola do Rails ou nos testes da aplicação, selecionando explicitamente o idioma:

ruby
I18n.with_locale(:es) do
  puts I18n.t("home.index.welcome", name: "Alex", raise: true)
  [0, 1, 2, 20].each do |count|
    puts I18n.t("notifications.unread", count: count, raise: true)
  end
end

Configure :en, :es e :fr como idiomas disponíveis antes desta verificação. O exemplo testa a pesquisa de mensagens e a interpolação; leia o texto para confirmar que transmite a saudação e a contagem de notificações pretendidas. Os idiomas de destino podem exigir regras e variantes de plural que vão além das formas inglesas da origem. Repita a verificação para francês e para os espaços de nomes de correio eletrónico e de validação da aplicação, à medida que forem adicionados.

Garanta que os pedidos selecionam o mesmo idioma #

Declare os idiomas suportados e um idioma predefinido na configuração do Rails. Envolva o processamento de cada pedido em I18n.with_locale, com um valor escolhido entre os idiomas suportados, para que o estado do idioma não passe para outro pedido.

Para URLs como /es, configure tanto o âmbito das rotas como o controlador que lê params[:locale]. Preserve o idioma nas ligações geradas. Se a aplicação também negociar Accept-Language, analise os pesos de qualidade e as etiquetas regionais, em vez de extrair uma subcadeia de duas letras. Quando a aplicação permitir uma escolha explícita do utilizador, essa escolha deve ter prioridade.

Defina de forma consciente o comportamento de recurso a outro idioma. Este mecanismo pode manter uma página utilizável, mas ocultar a falta de uma mensagem em espanhol. Por isso, verifique as entradas de destino obrigatórias sem depender dele. Quando adequado, utilize a função auxiliar l do Rails para localizar datas e horas, em vez de traduzir uma data já formatada como texto.

Abra uma página no idioma de destino, tanto diretamente como através da navegação. Confirme que o Rails seleciona o espaço de nomes de destino, apresenta os valores interpolados esperados e acomoda textos mais longos. lingo check não verifica se o YAML do Rails está completo; mantenha no processo de aceitação as verificações de carregamento e apresentação pelo Rails, bem como a revisão linguística.

Mantenha as traduções a par das alterações à origem #

Mantenha juntos os ficheiros de origem, as traduções de destino aceites, a configuração e .lingo/lock.json. Depois de alterar uma mensagem, execute lingo push --wait para processar as diferenças habituais e compare a mensagem alterada com uma mensagem adjacente que não tenha mudado. Para fazer uma correção pontual numa formulação cuja origem não mudou, edite diretamente o destino: o âmbito por chave YAML pode reutilizar a tradução existente. Para voltar a gerar as traduções após uma alteração às orientações, guarde as traduções de destino aceites antes de substituir integralmente os ficheiros no âmbito selecionado, conforme descrito em âmbitos de tradução.

Se as correções locais nas traduções de destino precisarem de proteção contra divergências, submeta sem --wait, inspecione lingo pull --dry-run e obtenha o resultado no checkout a partir do qual fez a submissão. A gravação dos resultados no modo de espera não faz essa nova verificação de conflitos. Os outros checkouts recebem as traduções registadas através do controlo de versões. Consulte Preservar traduções revistas.

Quando o ciclo local estiver a funcionar, escolha a GitHub App ou a automatização de CI. Execute as mesmas verificações do Rails nos recursos gerados antes de integrar as alterações de tradução.