YAML com raiz de idioma

Traduza os valores sob uma única raiz de idioma e altere o nome dessa raiz para o idioma de destino.

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

A raiz de idioma e os caminhos das mensagens #

Um catálogo de origem pode conter tanto interpolação como 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. Não incluem en, o que permite que a origem em inglês e o destino em espanhol partilhem os mesmos identificadores de mensagem. A raiz de destino passa a ser es; checkout, one e other mantêm-se como 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 acrescenta todas as categorias exigidas pelo idioma de destino. Teste a apresentação das quantidades e variáveis relevantes na aplicação antes de aceitar os recursos.

O analisador exige um único par chave-valor na raiz, com uma chave escalar e um mapeamento sob essa chave. O conteúdo de um idioma pode estar vazio, mas uma mensagem escalar ou uma lista diretamente sob a raiz é rejeitada. Divida um ficheiro YAML com vários idiomas em ficheiros individuais por idioma ou utilize YAML genérico se pretender manter todas as raízes inalteradas. Não selecione este processador para uma especificação OpenAPI.

Atualizações e âmbito parcial #

Os valores de texto aninhados são comparados pelos caminhos sob a raiz de idioma. A origem atual fornece a estrutura; a origem anterior e o destino existente permitem preservar os valores inalterados. Os comentários e as âncoras passam pela serialização da árvore YAML, que pode normalizar a formatação.

Mesmo com um âmbito limitado por chave ou termo, é possível reutilizar traduções inalteradas quando se fornece uma origem anterior. O --key da CLI utiliza a referência guardada, e acrescentar --force não impede essa reutilização. Para corrigir uma formulação específica, edite diretamente o destino. Para voltar a gerar o ficheiro depois de alterar as orientações, guarde os destinos aceites e utilize um --force de ficheiro completo com âmbito definido, sem --key. Em seguida, verifique cada mensagem alterada.

Quando o âmbito é definido por chave, os valores de texto em mapeamentos fora desse âmbito que não tenham sido resolvidos podem ser omitidos. Os elementos de sequência mantêm os valores de origem em vez de mudarem de posição. Verifique se o conteúdo está completo, independentemente de a análise ter sido bem-sucedida, sobretudo ao criar um novo idioma a partir de um âmbito restrito.

Configurar o idioma e o destino #

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

A reconstrução exige um idioma de destino e falha se este não estiver definido. O localeFormat da CLI altera a escrita do caminho, não o idioma indicado no YAML. Verifique o destino e a respetiva raiz e, em seguida, carregue uma saudação e uma mensagem no plural através do Rails. Localizar uma aplicação Rails explica como associar estes ficheiros à seleção do idioma do pedido, às funções auxiliares e ao comportamento de recurso a alternativas.