lingo extract
Gere JSONC de origem e declarações TypeScript a partir de chamadas explícitas de tradução.
lingo extract atribui uma identidade no catálogo às mensagens explícitas do React. Examina chamadas TypeScript/TSX, grava o JSONC de origem e as declarações localmente e preserva os metadados que vinculam cada entrada à sua origem. Não reescreve JSX arbitrário nem solicita traduções.
Em um componente React configurado, uma chamada compatível tem este formato:
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });Execute a extração a partir da raiz do projeto:
lingo extract --src src --source-locale enCom os caminhos padrão, confira locales/en.jsonc e lingo.d.ts. O catálogo de origem registra os valores das mensagens, o contexto e as localizações no código-fonte. O guia de início rápido do React apresenta as importações e a configuração do provedor para o componente.
Opções #
| Opção | Padrão ou efeito |
|---|---|
--src <path> | Diretório a examinar; padrão: src. |
--source-locale <locale> | Idioma de origem da saída; padrão: en. |
--out <path> | Ordem de precedência: esta opção, i18n.messagesPath configurado e, por fim, o padrão locales. |
--types <path> | Ordem de precedência: esta opção, i18n.typesPath configurado e, por fim, o padrão lingo.d.ts. |
--check | Compara os bytes gerados com os que estão em disco, sem gravar. |
Os caminhos são resolvidos a partir da raiz de projeto mais próxima. O idioma de origem não herda sourceLocale da configuração de localização; para usar outro idioma, especifique-o explicitamente. As gravações normais criam os diretórios de declarações.
O que o analisador reconhece #
O analisador reconhece text, rich, plural e select em variáveis que recebem o resultado de useLingo ou createLingo, além dos receptores convencionais l e .l. Aceita literais de string, templates sem expressões e objetos de formulário estáticos.
Mensagens dinâmicas não têm uma origem estável que possa ser extraída. Desestruturar o resultado de uma função fábrica faz com que o analisador perca a estrutura rastreada do receptor e emita um aviso. Arquivos de declaração, arquivos e diretórios com nomes iniciados por ponto e node_modules são excluídos. Quando não há arquivos TS/TSX, a extração informa isso e retorna sem resultado; o encerramento bem-sucedido do processo não comprova que mensagens foram encontradas.
Revise a identidade e o comportamento da mesclagem #
As chaves são derivadas da origem e do contexto. Uma mudança no texto ou no contexto pode criar uma nova identidade; valores substituídos em tempo de execução, não. Colisões fazem a extração falhar e exigem um contexto que elimine a ambiguidade.
A extração mescla os dados com o catálogo de origem existente: preserva os valores atuais, atualiza os metadados de contexto e origem, adiciona novas entradas e marca as mensagens ausentes como órfãs. A saída ordenada é determinística. Confira os avisos antes de considerar que uma entrada órfã foi removida intencionalmente da aplicação.
Verifique ou traduza o catálogo #
lingo extract --check compara os bytes do catálogo e das declarações sem gravar. lingo check também examina o contexto, as entradas órfãs e os destinos encontrados.
Para traduzir, adicione o caminho real de .jsonc a files[], autentique-se, faça a vinculação e use lingo push --backfill-missing --wait no primeiro envio. Nas alterações seguintes, use o envio simples. Alterar os caminhos de extração não atualiza automaticamente a configuração de arquivos.
Carregue o resultado com um carregador compatível com JSONC e a política de metadados do catálogo. O provedor espera um mapa de strings; nem um simples caminho de arquivo nem uma importação JSON comum fazem essa conversão por completo.