lingo extract
Genera JSONC de origen y declaraciones de TypeScript a partir de llamadas explícitas de traducción.
lingo extract asigna a los mensajes explícitos de React una identidad en el catálogo. Analiza las llamadas de TypeScript/TSX, escribe el JSONC de origen y las declaraciones en local, y conserva los metadatos que vinculan cada entrada con su origen. No reescribe JSX arbitrario ni solicita traducciones.
En un componente de React configurado, una llamada compatible tiene este aspecto:
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });Ejecuta la extracción desde la raíz del proyecto:
lingo extract --src src --source-locale enSi usas las rutas predeterminadas, revisa locales/en.jsonc y lingo.d.ts. El catálogo de origen registra los valores de los mensajes, el contexto y las ubicaciones en el código fuente. La guía de inicio rápido de React incluye las importaciones y la configuración del proveedor para el componente.
Opciones #
| Opción | Valor predeterminado o efecto |
|---|---|
--src <path> | Directorio que se analiza; por defecto, src. |
--source-locale <locale> | Idioma de origen de la salida; por defecto, en. |
--out <path> | Tiene prioridad sobre el valor configurado de i18n.messagesPath y, en su defecto, sobre locales. |
--types <path> | Tiene prioridad sobre el valor configurado de i18n.typesPath y, en su defecto, sobre lingo.d.ts. |
--check | Compara los bytes generados con los del disco sin escribir. |
Las rutas se resuelven a partir de la raíz del proyecto más cercana. El idioma de origen no hereda sourceLocale de la configuración de localización; si quieres usar otro idioma, especifícalo de forma explícita. Las operaciones de escritura normales crean los directorios de las declaraciones.
Qué reconoce el escáner #
El analizador reconoce text, rich, plural y select en variables asignadas a partir de useLingo o createLingo, además de los receptores convencionales l y .l. Acepta literales de cadena, plantillas sin expresiones y objetos de formulario estáticos.
Los mensajes dinámicos no tienen un origen estable que se pueda extraer. Al desestructurar el resultado de una función de fábrica, se pierde la estructura del receptor que se estaba rastreando y se genera una advertencia. Se excluyen los archivos de declaraciones, los archivos y directorios cuyo nombre empieza por un punto, y node_modules. Si no hay archivos TS/TSX, la extracción lo indica y termina sin devolver ningún resultado; que el proceso termine correctamente no demuestra que se hayan encontrado mensajes.
Revisa la identidad y el comportamiento de la combinación #
Las claves se derivan del texto de origen y del contexto. Un cambio en la redacción o en el contexto puede crear una nueva identidad; los valores sustituidos en tiempo de ejecución no. Las colisiones hacen que la extracción falle y requieren un contexto que permita distinguir los mensajes.
La extracción combina los datos con el catálogo de origen existente: conserva los valores actuales, actualiza los metadatos de contexto y origen, añade nuevas entradas y marca como huérfanos los mensajes ausentes. La salida ordenada es determinista. Revisa las advertencias antes de dar por hecho que un mensaje huérfano se ha eliminado intencionadamente de la aplicación.
Comprueba o traduce el catálogo #
lingo extract --check compara los bytes tanto del catálogo como de las declaraciones sin escribir. lingo check también examina el contexto, los mensajes huérfanos y los destinos detectados.
Para traducir, añade la ruta real de .jsonc a files[], autentícate, establece el vínculo y usa lingo push --backfill-missing --wait la primera vez. Para los cambios posteriores, usa push sin opciones adicionales. Cambiar las rutas de extracción no modifica automáticamente la configuración de los archivos.
Carga el resultado con un cargador compatible con JSONC y la política de metadatos del catálogo. El proveedor espera un mapa de cadenas; ni una ruta de archivo sin procesar ni una importación JSON convencional completan esa conversión.