JSONC

Traduza catálogos com comentários que dão contexto e saiba quais são mantidos no ficheiro traduzido.

O JSONC permite manter uma mensagem junto da respetiva explicação. O processador de ficheiros jsonc lê o comentário que precede uma cadeia de texto como uma indicação para a tradução e traduz os valores de texto aninhados seguindo os mesmos caminhos que o JSON.

Mantenha esses comentários no catálogo de origem. O ficheiro de destino reconstruído usa uma indentação de dois espaços e termina com uma mudança de linha. Mantém as marcações @orphan nas mesmas entradas que o ficheiro de origem e elimina todos os outros comentários. Por isso, um sistema que dependa de outros metadados precisa de outra forma de os conservar.

Coloque o contexto junto do valor a que se refere #

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 aplica-se ao valor de texto seguinte, não a todos os descendentes do objeto que o contém. Um número, um booleano ou um valor null entre o comentário e a cadeia de texto elimina a indicação pendente. Coloque o comentário imediatamente antes da cadeia de texto que descreve e proteja os identificadores fixos através dos controlos da interface selecionada.

Com @context, a indicação corresponde ao resto dessa linha. Sem essa marcação, todo o comentário serve de indicação, pelo que qualquer comentário não vazio colocado antes de uma cadeia de texto chega ao tradutor. Quando vários comentários precedem uma cadeia de texto, é usada a última indicação não vazia, mesmo que um comentário anterior contenha @context. @orphan assinala metadados do catálogo; a cadeia de texto continua a poder ser selecionada para tradução de ficheiros.

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

A extração de catálogos React cria catálogos JSONC planos com metadados associados às entradas. O respetivo leitor reconhece @context, @src e @orphan; a extração usa esses campos para manter as localizações no código-fonte e assinalar mensagens que já não são encontradas. Trata-se de um workflow de gestão de catálogos, distinto da tradução de um documento JSONC qualquer.

Consulte Catálogos e tipos React ao fazer a manutenção de mensagens extraídas. Não elimine metadados do catálogo de origem por assumir que a tradução geral de ficheiros os vai regenerar no resultado.

Configure a tradução de ficheiros #

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

Conserve os valores certos #

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

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

O workflow de tradução verifica as estruturas de marcadores de posição e de ICU suportadas, incluindo argumentos alterados ou em falta. Analise os avisos ou as falhas apresentados e, em seguida, renderize o modelo aceite com os valores fornecidos pela aplicação. Além destas verificações estruturais, faça uma revisão do significado e confirme que o conteúdo está completo.