Notas para tradutores na CLI v0
Adicione contexto específico de cada ocorrência junto às mensagens legadas em JSONC ou Xcode e atualize deliberadamente a tradução afetada.
Um rótulo curto nem sempre traz as informações de que o tradutor precisa. Uma nota pode esclarecer o assunto, a ação ou o registro linguístico sem acrescentar palavras visíveis à interface. No workflow legado, use comentários em JSONC ou os campos de comentário nativos do catálogo do Xcode, quando houver suporte.
Esclareça o significado que falta #
{
// Patient medical records, not music recordings
"records": "Records",
// Button that submits the form; use a short action label
"submit": "Submit",
// Visual theme, not weight
"theme.light": "Light"
}Selecione o analisador com suporte a comentários em i18n.json:
{
"buckets": {
"jsonc": { "include": ["locales/[locale].jsonc"] }
}
}“Coleção de prontuários médicos salvos” esclarece o assunto; “Texto exibido para um usuário” não. Uma nota sobre a posição na interface e o registro linguístico pode explicar por que um aviso formal difere de um rótulo de ação. Use um controle de chave para um valor exato que não deve mudar, em vez de depender de uma nota linguística para preservá-lo.
Confira o resultado afetado #
Alterar apenas a nota pode não mudar a soma de verificação do valor de origem. Solicite a retradução seletiva quando, sem isso, a versão instalada ignoraria o texto inalterado. Leia o rótulo traduzido no contexto real da interface.
Para XCStrings, use o campo de comentário nativo e preserve a estrutura de idiomas do catálogo compartilhado. Consulte os formatos legados antes de presumir que outro agrupamento lê as notas da mesma forma. Esses comentários legados não fazem parte do contrato de hash/contexto do catálogo React atual.
Mantenha a nota específica de cada ocorrência separada do glossário, das regras e da voz que se aplicam a todo o engine de localização. Tanto a nota quanto essas configurações podem ser enviadas ao backend, por isso não devem conter segredos nem conteúdo que você não tenha autorização para divulgar.