JSONC

Traduza catálogos com comentários usando dicas de contexto e saiba quais comentários são mantidos no arquivo traduzido.

O JSONC permite manter cada mensagem junto de sua explicação. O processador de arquivos jsonc usa o comentário que antecede uma string como dica de tradução e traduz valores de string aninhados seguindo os mesmos caminhos usados em JSON.

Mantenha esses comentários no catálogo de origem. O arquivo de destino reconstruído usa indentação de dois espaços e termina com uma quebra de linha. Ele mantém as marcações @orphan nas mesmas entradas do catálogo de origem e descarta todos os outros comentários. Por isso, qualquer sistema que dependa de outros metadados precisa de uma forma separada de preservá-los.

Coloque o contexto junto do valor correspondente #

Este catálogo explica o que “Voltar” pede ao leitor que faça:

jsonc
{
  /* @context Button that returns to the previous checkout step */
  "back": "Back",
  "product": "Acme",
}

O comentário se aplica ao próximo valor de string, não a todos os descendentes do objeto que o contém. Se houver um número, um booleano ou um valor nulo entre o comentário e a string, a dica pendente será descartada. Coloque o comentário imediatamente antes da string que ele descreve e proteja os identificadores fixos com os controles da interface selecionada.

Com @context, a dica corresponde ao restante da linha. Sem essa marcação, o comentário inteiro vira a dica. Assim, qualquer comentário não vazio colocado antes de uma string chega ao tradutor. Quando vários comentários antecedem uma string, a última dica não vazia é usada, mesmo que um comentário anterior contenha @context. A marcação @orphan identifica metadados do catálogo; ainda assim, a string pode ser selecionada para tradução de arquivos.

Tradução de arquivos e catálogos React #

A extração de catálogos React gera catálogos JSONC sem aninhamento, com metadados associados às entradas. O leitor desses catálogos reconhece @context, @src e @orphan; a extração usa esses campos para manter as localizações no código-fonte e marcar mensagens que não são mais encontradas. Esse workflow de gerenciamento de catálogos é separado da tradução de um documento JSONC qualquer.

Consulte Catálogos e tipos do React ao fazer a manutenção de mensagens extraídas. Não exclua metadados do catálogo de origem supondo que a tradução geral de arquivos vá recriá-los na saída.

Configure a tradução de arquivos #

A CLI infere jsonc a partir de .jsonc; o GitHub App aceita o tipo de arquivo configurado. Selecione os caminhos de origem e destino em Configuração da CLI ou Configuração do GitHub.

Mantenha os valores certos #

A comparação incremental, os caminhos bloqueados, preservados e ignorados e a injeção de idioma seguem as mesmas distinções do processador de arquivos JSON. Bloquear copia os dados de origem; preservar mantém os dados de destino; ignorar remove um caminho. Consulte JSON para entender a precedência e as consequências de um escopo parcial, em vez de tratar essas opções como formas equivalentes de exclusão.

Confira as chaves e os valores protegidos no arquivo reconstruído e, em seguida, carregue o arquivo de destino pelo leitor de catálogos da aplicação. Para catálogos React, mantenha os metadados de origem disponíveis para a extração: o arquivo de destino traduzido mantém @orphan, mas não @context nem @src.

O workflow de tradução verifica as estruturas compatíveis de marcadores de posição e ICU, incluindo argumentos alterados ou ausentes. Examine os avisos ou as falhas relatados e, em seguida, renderize o modelo aceito com os valores fornecidos pela sua aplicação. Além dessas verificações estruturais, revise o significado e confira se o conteúdo está completo.