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. Analisa chamadas TypeScript/TSX, grava localmente o JSONC de origem e as declarações e preserva os metadados que ligam cada entrada à sua origem. Não reescreve JSX arbitrário nem pede traduções.

Num componente React configurado, uma chamada suportada tem este aspeto:

tsx
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });

Execute a extração a partir da raiz do projeto:

sh
lingo extract --src src --source-locale en

Com os caminhos predefinidos, consulte locales/en.jsonc e lingo.d.ts. O catálogo de origem regista os valores das mensagens, o contexto e as localizações no código-fonte. O guia de início rápido do React fornece as importações e a configuração do fornecedor para o componente.

Opções #

OpçãoPredefinição ou efeito
--src <path>Diretório a analisar; predefinição: src.
--source-locale <locale>Idioma de origem dos ficheiros gerados; predefinição: en.
--out <path>Substitui o valor configurado de i18n.messagesPath ou, se não estiver definido, a predefinição locales.
--types <path>Substitui o valor configurado de i18n.typesPath ou, se não estiver definido, a predefinição lingo.d.ts.
--checkCompara os bytes gerados com os que estão no disco, sem gravar.

Os caminhos são resolvidos a partir da raiz do projeto mais próxima. O idioma de origem não herda o valor de sourceLocale da configuração de localização; especifique explicitamente qualquer outro idioma. As operações normais de gravação criam os diretórios das declarações.

O que o analisador reconhece #

O analisador reconhece text, rich, plural e select em variáveis às quais foi atribuído o resultado de useLingo ou createLingo, bem como os recetores convencionais l e .l. Aceita literais de texto, modelos sem expressões e objetos estáticos de formas.

As mensagens dinâmicas não têm uma origem estável que possa ser extraída. Ao desestruturar o resultado de uma função de fábrica, perde-se a estrutura do recetor acompanhada pelo analisador e é emitido um aviso. São excluídos os ficheiros de declaração, os ficheiros e diretórios cujo nome começa por um ponto e node_modules. Se não existirem ficheiros TS/TSX, a extração indica esse facto e termina sem resultado; o processo terminar com êxito não significa que tenham sido encontradas mensagens.

Rever a identidade e o comportamento de fusão #

As chaves são geradas a partir do texto de origem e do contexto. Uma alteração na redação ou no contexto pode criar uma nova identidade; os valores substituídos em tempo de execução não a alteram. As colisões fazem a extração falhar e exigem contexto que elimine a ambiguidade.

A extração combina os dados com o catálogo de origem existente: preserva os valores atuais, atualiza os metadados de contexto e de origem, adiciona novas entradas e marca como órfãs as mensagens ausentes. O resultado ordenado é determinístico. Verifique os avisos antes de interpretar uma mensagem órfã como uma remoção intencional da aplicação.

Verificar ou traduzir o catálogo #

lingo extract --check compara os bytes do catálogo e das declarações, sem gravar. lingo check analisa também o contexto, as mensagens órfãs e os destinos encontrados.

Para traduzir, adicione o caminho efetivo de .jsonc a files[], autentique-se, estabeleça a ligação e utilize lingo push --backfill-missing --wait na primeira vez. Nas alterações seguintes, utilize um envio simples. Alterar os caminhos de extração não atualiza automaticamente a configuração dos ficheiros.

Carregue o resultado com um carregador compatível com JSONC e a política de metadados do catálogo. O fornecedor espera um mapa de cadeias de texto; nem um simples caminho de ficheiro nem uma importação JSON comum bastam para concluir essa conversão.