lingo extract
Générez le JSONC source et les déclarations TypeScript à partir d’appels de traduction explicites.
lingo extract attribue une identité dans le catalogue aux messages React explicites. Il analyse les appels TypeScript/TSX, écrit localement le JSONC source et les déclarations, et conserve les métadonnées qui relient chaque entrée à sa source. Il ne réécrit pas de JSX arbitraire et ne demande aucune traduction.
Dans un composant React configuré, voici à quoi ressemble un appel pris en charge :
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });Lancez l’extraction depuis la racine du projet :
lingo extract --src src --source-locale enAvec les chemins par défaut, examinez locales/en.jsonc et lingo.d.ts. Le catalogue source enregistre les valeurs des messages, leur contexte et leurs emplacements dans le code source. Le guide de démarrage rapide React fournit les imports et la configuration du fournisseur pour le composant.
Options #
| Option | Valeur par défaut ou effet |
|---|---|
--src <path> | Répertoire à analyser, src par défaut. |
--source-locale <locale> | Langue source en sortie, en par défaut. |
--out <path> | Remplace la valeur configurée de i18n.messagesPath ou, à défaut, la valeur par défaut locales. |
--types <path> | Remplace la valeur configurée de i18n.typesPath ou, à défaut, la valeur par défaut lingo.d.ts. |
--check | Compare les octets générés à ceux présents sur disque, sans rien écrire. |
Les chemins sont résolus à partir de la racine de projet la plus proche. La langue source n’hérite pas du paramètre de localisation sourceLocale ; indiquez explicitement toute autre langue. Les écritures normales créent les répertoires de déclarations.
Ce que l’analyseur reconnaît #
L’analyseur reconnaît text, rich, plural et select sur les variables affectées à partir de useLingo ou de createLingo, ainsi que les récepteurs conventionnels l et .l. Il accepte les chaînes littérales, les littéraux de gabarit sans expressions et les objets de formes statiques.
Les messages dynamiques n’ont pas de source stable à extraire. Déstructurer le résultat d’une fabrique fait perdre la structure du récepteur suivie par l’analyseur et déclenche un avertissement. Les fichiers de déclarations, les fichiers et répertoires dont le nom commence par un point, ainsi que node_modules, sont exclus. En l’absence de fichiers TS/TSX, l’extraction le signale et se termine sans résultat ; un processus qui se termine avec succès ne prouve pas que des messages ont été trouvés.
Relecture : identité et comportement de fusion #
Les clés sont dérivées de la source et du contexte. Une modification du texte ou du contexte peut créer une nouvelle identité, contrairement aux valeurs substituées à l’exécution. Les collisions font échouer l’extraction et nécessitent un contexte qui lève l’ambiguïté.
L’extraction fusionne les données avec le catalogue source existant : elle conserve les valeurs actuelles, met à jour les métadonnées de contexte et de source, ajoute de nouvelles entrées et marque les messages absents comme orphelins. La sortie triée est déterministe. Examinez les avertissements avant de considérer qu’un message orphelin a été volontairement supprimé de l’application.
Vérifier ou traduire le catalogue #
lingo extract --check compare les octets du catalogue et des déclarations sans rien écrire. lingo check examine aussi le contexte, les messages orphelins et les cibles détectées.
Pour traduire le catalogue, ajoutez le chemin réel de .jsonc à files[], authentifiez-vous, établissez le lien et utilisez lingo push --backfill-missing --wait pour l’envoi initial. Pour les modifications suivantes, utilisez un simple push. Modifier les chemins d’extraction ne met pas automatiquement à jour la configuration des fichiers.
Chargez le résultat avec un chargeur compatible JSONC et la politique relative aux métadonnées du catalogue. Le fournisseur attend une table de correspondance de chaînes ; ni un chemin de fichier brut ni un import JSON ordinaire ne suffisent à effectuer cette conversion.