Verifique a localização em React na revisão de código

Use a extração, as verificações de catálogo, o TypeScript e a compilação da aplicação para detectar diferentes problemas de localização antes da mesclagem.

Uma mensagem alterada em React chega aos leitores por um caminho que passa pelo código-fonte, pela extração, por um catálogo de destino e pelo carregador da aplicação. Revise esse caminho junto com o texto. Uma tradução correta associada a uma identidade desatualizada nunca é exibida; usar o texto de origem como alternativa pode ocultar uma tradução ausente sem impedir o uso da tela.

Este método se aplica ao pacote React atual com catálogos JSONC extraídos pela CLI. Combine as verificações de extração da CLI com as verificações de compilação e renderização do próprio projeto.

Inspecione primeiro a alteração no código-fonte #

Leia a nova mensagem de origem como uma instrução ou afirmação dirigida ao usuário. Depois, leia o contexto. “Botão” descreve uma forma; “Cancelar um pagamento agendado antes do envio” explica a ação cujo significado precisa ser preservado. Tanto o texto de origem quanto o contexto compõem a identidade da mensagem, por isso uma edição apenas no contexto pode exigir uma nova entrada de destino.

Revise os marcadores de posição como valores cuja finalidade deve permanecer estável. O tradutor precisa poder reposicionar o nome de uma pessoa ou um valor monetário sem alterar sua identidade. Em textos ricos, mantenha a navegação e o comportamento dos componentes no código e traduza a frase ao redor das tags nomeadas. Mensagens e Texto rico detalham as APIs exatas.

Verifique a extração antes dos catálogos de destino #

No diretório correto do projeto, com a CLI instalada:

sh
lingo extract --check
lingo check

Use as mesmas opções --src, --source-locale, --out e --types do comando de extração do projeto. O idioma de origem padrão é en; a configuração de localização não altera o padrão desse comando. Em seguida, execute a verificação de TypeScript e a compilação de produção do repositório, incluindo as declarações geradas.

Defeito a introduzir em um cenário de teste local de revisãoVerificação de bloqueio e evidência esperada
Altere uma mensagem de origem sem gerar novamente os catálogos ou as declarações.extract --check compara a saída gerada e falha quando ela está desatualizada.
Omita o contexto obrigatório de uma mensagem extraída.check aponta o problema de extração/contexto; inspecione o código-fonte para corrigir o significado.
Deixe uma entrada ausente ou vazia em um catálogo JSONC de destino existente.check aponta a tradução ausente no catálogo encontrado.
Deixe as declarações geradas desatualizadas.A extração/verificação detecta a divergência no conteúdo gerado; o TypeScript verifica separadamente o uso na aplicação.
Provoque uma falha na importação de um idioma ou na integração com o framework.A compilação real da aplicação deve revelar a falha de integração.

Use um cenário de teste local ao configurar essas verificações pela primeira vez. extract --check é concluído com sucesso mesmo quando nenhum arquivo de código-fonte é encontrado, então confirme que o diretório informado contém o código esperado. Caso contrário, um resultado positivo pode significar que a verificação não inspecionou nada.

Verifique explicitamente a cobertura dos idiomas obrigatórios #

Quando os padrões files em .lingo/config.json correspondem ao catálogo de origem (por exemplo, locales/en.jsonc), lingo check também exige o arquivo de cada idioma de destino configurado. O padrão gravado por lingo init --yes, locales/en.json, não corresponde a um catálogo .jsonc, por isso apenas as verificações do React são executadas com ele. Uma chave ausente só é apontada nos catálogos JSONC de destino existentes. Como parte da revisão, compare a lista de idiomas obrigatórios com os arquivos e as importações. Remova temporariamente uma entrada de destino em um cenário de teste local para ver como o texto de origem aparece na tela quando usado como alternativa.

Leia pares representativos de mensagens de origem e destino para avaliar o significado, especialmente quando houver mudanças em promessas e termos do produto. Uma verificação de consistência de JSONC sem erros não avalia esse significado. ARB, XML do Android, catálogos da Apple e documentos estáticos exigem suas próprias validações, em vez desta verificação de cobertura específica do React.

Resolva as diferenças sem perder o conteúdo já revisado #

Gere novamente a saída desatualizada com lingo extract, inspecione as entradas adicionadas e órfãs e traduza as alterações necessárias. Preserve o texto de destino já revisado e o arquivo de bloqueio de localização. A remoção de entradas órfãs altera os catálogos e deve ser revisada separadamente da alteração na mensagem de origem.

Defina se as traduções chegarão à branch de origem ou por um PR de tradução separado. O guia de CI explica as vantagens e desvantagens de cada forma de entrega e as diferenças do App gerenciado. Nos dois modelos, mantenha a permissão de mesclagem separada da permissão de execução e da aceitação do conteúdo.

Para finalizar, carregue a tela alterada em um idioma de destino com valores representativos. Acesse os links do texto rico, verifique o comportamento quando o texto de origem é usado como alternativa e compare a mensagem exibida com a ação pretendida. A revisão estará concluída quando tanto o caminho da mensagem no programa quanto o texto tiverem sido examinados.