YAML

Traduza valores de texto em estruturas YAML aninhadas sem alterar as chaves do catálogo e escolha outro processador quando a raiz ou o esquema tiver um significado específico.

O processador de ficheiros yaml traduz valores de texto em mapeamentos e sequências aninhados. Preserva as chaves que o código da aplicação utiliza para procurar valores, bem como os números e os valores booleanos. Utilize-o para catálogos cuja estrutura se mantém igual em todos os idiomas.

Decida se o YAML genérico é adequado #

Por exemplo, este catálogo agrupa mensagens de finalização de compra sem um elemento de idioma na raiz:

yaml
checkout:
  title: Complete your order
  steps:
    - Review your items
    - Confirm delivery
  retries: 3

O processador seleciona checkout.title e as duas cadeias de texto da sequência. retries mantém-se numérico. Um identificador entre aspas também seria selecionado, por ser uma cadeia de texto. Tenha esta distinção em conta ao escolher os dados a incluir no catálogo.

Utilize YAML com idioma na raiz para um elemento en: ao estilo Rails que tenha de passar a indicar o idioma de destino. O YAML genérico mantém en:, mesmo quando o nome do ficheiro muda para es.yml. Nesse caso, o Rails pode ignorar o conteúdo porque a raiz continua a indicar inglês.

Utilize OpenAPI para uma especificação de API. O YAML genérico também selecionaria identificadores de operações, referências e exemplos com valores de texto. A extensão .yml não permite distinguir estas finalidades.

Reutilização e reconstrução #

A origem atual define a árvore de saída. Uma versão anterior da origem permite determinar se a cadeia de texto em cada caminho foi alterada, e o destino existente fornece os valores nos caminhos correspondentes. As novas traduções substituem as cadeias alteradas; as cadeias inalteradas podem manter as traduções existentes, mesmo quando são selecionadas por um âmbito definido por chave ou termo.

A CLI fornece a versão de referência guardada para --key, pelo que essa seleção não permite regenerar de forma fiável o texto YAML inalterado. Adicionar --force ao mesmo comando não muda este comportamento. Para fazer uma correção exata, edite diretamente o destino. Para regenerar o conteúdo, guarde os destinos aceites e utilize --force para o ficheiro completo, com o âmbito pretendido e sem --key. Reveja todo o ficheiro após a substituição.

A reconstrução utiliza 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 a ser conteúdo do documento, não instruções de tradução. Verifique as referências a âncoras com o programa que lê o YAML, sobretudo quando um valor aparece através de várias referências.

Uma execução com âmbito limitado por chave pode eliminar uma cadeia de texto de um mapeamento que esteja fora do âmbito e por resolver, caso não exista um valor de destino. As cadeias de texto das sequências mantêm o valor de origem para evitar deslocar as posições. Por isso, um âmbito parcial não garante que todas as cadeias de texto do ficheiro estejam traduzidas.

Configure e carregue o catálogo #

Defina explicitamente format: "yaml" para origens .yaml ou .yml em Configuração da CLI. A deteção durante o envio exclui ficheiros YAML sem um formato explícito. A GitHub App tem a 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 determinar o caminho. As posições nas sequências também identificam mensagens: mover um item de uma sequência pode alterar a tradução existente que lhe corresponde. Verifique o catálogo carregado após alterações estruturais. Para a procura de valores no Rails, a seleção de idioma e o recurso a um idioma alternativo, consulte Localizar uma aplicação Rails e utilize o processador com idioma na raiz.