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:
{
/* @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.