YAML com raiz de idioma

Traduza os valores abaixo de uma raiz de idioma e renomeie essa raiz para o idioma de destino.

O Rails lê o idioma na raiz de um arquivo YAML. Um arquivo chamado checkout.es.yml continua definindo recursos em inglês se a raiz for en:. O processador yaml-root-key traduz as mensagens abaixo dessa raiz e a altera para o idioma de destino, mantendo os caminhos de consulta consistentes entre os idiomas.

O nó de idioma e os caminhos das mensagens #

Um catálogo de origem pode conter tanto interpolação quanto ramificações de plural:

yaml
en:
  checkout:
    greeting: Hello, %{name}
    items:
      one: One item
      other: "%{count} items"

Os caminhos das mensagens são checkout.greeting, checkout.items.one e checkout.items.other. Eles não incluem en, o que permite que a origem em inglês e o destino em espanhol usem os mesmos identificadores de mensagem. O nó de destino passa a ser es; checkout, one e other continuam sendo chaves.

A sintaxe de interpolação e os nomes das categorias de plural fazem parte do contrato da aplicação. Traduzir as palavras não configura as regras de plural do Rails nem adiciona todas as categorias exigidas pelo idioma de destino. Renderize as quantidades e variáveis relevantes na aplicação antes de aceitar os recursos.

O analisador exige um único par de chave e valor na raiz, com uma chave escalar e um mapeamento abaixo dela. O conteúdo do idioma pode estar vazio, mas uma mensagem escalar ou uma lista diretamente abaixo da raiz é rejeitada. Divida um arquivo YAML com vários idiomas em arquivos separados por idioma ou use YAML genérico se quiser manter todas as raízes inalteradas. Não selecione este processador para uma especificação OpenAPI.

Atualizações e escopo parcial #

Os valores de texto aninhados são comparados pelos caminhos abaixo do nó de idioma. A origem atual fornece a estrutura; a origem anterior e o destino existente permitem reaproveitar os valores que não mudaram. Comentários e âncoras passam pela serialização da árvore YAML, que pode normalizar a formatação.

Mesmo com escopo por chave ou termo, traduções inalteradas podem ser reaproveitadas quando uma origem anterior é fornecida. O --key da CLI usa a base de referência salva, e adicionar --force não impede esse reaproveitamento. Para fazer uma correção pontual de redação, edite o destino diretamente. Para gerar o arquivo novamente após alterar as orientações, salve os destinos aceitos e use um --force de arquivo inteiro com escopo definido, sem --key. Depois, confira cada mensagem alterada.

Ao usar o escopo por chave, os valores de texto em mapeamentos fora do escopo que não forem resolvidos podem ser omitidos. Os elementos de sequência mantêm os valores de origem em vez de mudar de posição. Verifique se o conteúdo está completo, independentemente de a análise ter sido bem-sucedida, principalmente ao criar um novo idioma a partir de um escopo restrito.

Configure o idioma e o destino #

Defina format: "yaml-root-key" explicitamente para origens .yml ou .yaml. A extensão não permite identificar o nó de idioma. Configuração da CLI e GitHub explicam os padrões de arquivos e as estruturas de destino.

A reconstrução exige um idioma de destino e falha se ele não for informado. O localeFormat da CLI altera a escrita do caminho, não o idioma definido dentro do YAML. Confira tanto o destino quanto sua raiz e, em seguida, carregue uma saudação e uma mensagem no plural pelo Rails. Localize uma aplicação Rails mostra como esses arquivos se relacionam com a seleção de idioma por requisição, as funções auxiliares e o comportamento de uso de idiomas alternativos.