YAML
Traduza valores de texto aninhados em YAML sem alterar as chaves do catálogo e escolha outro processador quando a raiz ou o esquema tiver um significado especial.
O processador de arquivos yaml traduz valores de texto em mapeamentos e sequências aninhados. Ele preserva as chaves que o código da aplicação usa nas consultas, além dos números e booleanos. Use-o em catálogos cuja estrutura se mantém igual em todos os idiomas.
Avalie se o YAML genérico é adequado #
Por exemplo, este catálogo agrupa mensagens de finalização de compra sem um nível externo de idioma:
checkout:
title: Complete your order
steps:
- Review your items
- Confirm delivery
retries: 3O processador seleciona checkout.title e os dois textos da sequência. retries permanece numérico. Um identificador entre aspas também seria selecionado, pois é um valor de texto. Leve essa distinção em conta ao escolher quais dados devem fazer parte do catálogo.
Use YAML com idioma na raiz para um nível externo en: no estilo Rails que precisa mudar para o idioma de destino. O YAML genérico mantém en:, mesmo quando o nome do arquivo muda para es.yml. Com isso, o Rails pode ignorar o conteúdo, já que a raiz ainda indica inglês.
Use OpenAPI para uma especificação de API. O YAML genérico também selecionaria identificadores de operação, referências e exemplos com valores de texto. A extensão .yml não permite distinguir essas finalidades.
Reutilização e reconstrução #
A origem atual define a árvore de saída. Uma versão anterior da origem permite identificar se o texto em cada caminho mudou, e o destino existente fornece os valores nos caminhos correspondentes. Novas traduções substituem os textos alterados; os textos que não mudaram podem manter as traduções existentes, mesmo quando selecionados por escopo de chave ou termo.
A CLI fornece sua versão-base salva para --key, por isso essa seleção não regenera de forma confiável os textos YAML que não foram alterados. Adicionar --force ao mesmo comando não muda esse comportamento. Para fazer uma correção exata, edite o destino diretamente. Para regenerar, salve os destinos aceitos e use --force no arquivo inteiro, com escopo definido e sem --key. Revise todo o arquivo após a substituição.
A reconstrução usa uma árvore sintática YAML para preservar os comentários e a estrutura de âncoras ao substituir os valores. A serialização pode normalizar a formatação. Os comentários continuam sendo conteúdo do documento, não instruções para quem traduz. Verifique os aliases com o sistema que lê seu YAML, principalmente quando um mesmo valor aparece por meio de várias referências.
Uma execução com escopo por chave pode descartar um texto não resolvido de um mapeamento fora do escopo quando não houver um valor de destino. Os textos das sequências mantêm o valor de origem para evitar mudanças de posição. Portanto, uma execução com escopo parcial não garante que todos os textos do arquivo estejam traduzidos.
Configure e carregue o catálogo #
Defina format: "yaml" explicitamente para origens .yaml ou .yml em Configuração da CLI. A descoberta de arquivos durante o envio exclui arquivos YAML sem um formato explícito. O GitHub App tem sua própria seleção de repositórios.
Ajuste o caminho de destino ao carregador da aplicação. Uma origem como config/locales/checkout.en.yml e outra em locales/en/checkout.yml exigem formas diferentes de derivar o caminho. As posições nas sequências também identificam mensagens: mover um item pode mudar qual tradução existente corresponde a ele. Confira o catálogo carregado após alterações estruturais. Para consultas no Rails, seleção de idioma e uso de idiomas alternativos, consulte Localize uma aplicação Rails e use o processador de YAML com idioma na raiz.