lingo extract
Quell-JSONC und TypeScript-Deklarationen aus expliziten Übersetzungsaufrufen erzeugen.
lingo extract weist expliziten React-Nachrichten eine Identität im Katalog zu. Es durchsucht TypeScript-/TSX-Aufrufe, schreibt Quell-JSONC und Deklarationen lokal und bewahrt Metadaten, die jeden Eintrag mit seiner Quelle verknüpfen. Es schreibt weder beliebiges JSX um noch fordert es Übersetzungen an.
In einer konfigurierten React-Komponente sieht ein unterstützter Aufruf so aus:
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });Starte die Extraktion im Projektstammverzeichnis:
lingo extract --src src --source-locale enWenn du die Standardpfade verwendest, sieh dir locales/en.jsonc und lingo.d.ts an. Der Quellkatalog erfasst Nachrichtenwerte, Kontext und Positionen im Quellcode. Im React-Schnellstart findest du die Imports und die Provider-Konfiguration für die Komponente.
Optionen #
| Option | Standardwert oder Wirkung |
|---|---|
--src <path> | Zu durchsuchendes Verzeichnis, standardmäßig src. |
--source-locale <locale> | Quellsprache der Ausgabe, standardmäßig en. |
--out <path> | Hat Vorrang vor dem konfigurierten Wert i18n.messagesPath und dem Standardwert locales. |
--types <path> | Hat Vorrang vor dem konfigurierten Wert i18n.typesPath und dem Standardwert lingo.d.ts. |
--check | Vergleicht die erzeugten Bytes mit denen auf dem Datenträger, ohne etwas zu schreiben. |
Pfade werden relativ zum nächstgelegenen Projektstammverzeichnis aufgelöst. Die Quellsprache übernimmt nicht den Lokalisierungswert sourceLocale; gib eine andere Sprache ausdrücklich an. Bei regulären Schreibvorgängen werden die Verzeichnisse für die Deklarationen angelegt.
Was der Scanner erkennt #
Der Scanner erkennt text, rich, plural und select bei Variablen, denen das Ergebnis von useLingo oder createLingo zugewiesen wurde, sowie bei den üblichen Empfängern l und .l. Er akzeptiert Zeichenfolgenliterale, Templates ohne Ausdrücke und statische Formobjekte.
Dynamische Nachrichten haben keine stabile, extrahierbare Quelle. Wird ein Factory-Ergebnis destrukturiert, geht die nachverfolgte Empfängerstruktur verloren und es wird eine Warnung ausgegeben. Deklarationsdateien, Dateien und Verzeichnisse mit einem Punkt am Namensanfang sowie node_modules sind ausgeschlossen. Sind keine TS-/TSX-Dateien vorhanden, meldet die Extraktion dies und endet ohne Ergebnis. Ein erfolgreicher Prozessabschluss bedeutet also nicht, dass Nachrichten gefunden wurden.
Prüfung der Identität und Merge-Verhalten #
Schlüssel werden aus Quelle und Kontext abgeleitet. Änderungen am Wortlaut oder Kontext können eine neue Identität erzeugen; zur Laufzeit eingesetzte Werte dagegen nicht. Bei Kollisionen schlägt die Extraktion fehl. Dann ist ein Kontext erforderlich, der die Nachrichten eindeutig voneinander unterscheidet.
Die Extraktion führt die Ergebnisse mit dem bestehenden Quellkatalog zusammen: Sie behält aktuelle Werte bei, aktualisiert Kontext- und Quellmetadaten, fügt neue Einträge hinzu und markiert nicht mehr vorhandene Nachrichten als verwaist. Die sortierte Ausgabe ist deterministisch. Sieh dir die Warnungen an, bevor du davon ausgehst, dass ein verwaister Eintrag absichtlich aus der Anwendung entfernt wurde.
Katalog kontrollieren oder übersetzen #
lingo extract --check vergleicht die Bytes des Katalogs und der Deklarationen, ohne etwas zu schreiben. lingo check untersucht zusätzlich den Kontext, verwaiste Einträge und erkannte Ziele.
Füge für die Übersetzung den tatsächlichen Pfad von .jsonc zu files[] hinzu, authentifiziere dich, stelle die Verknüpfung her und verwende beim ersten Mal lingo push --backfill-missing --wait. Für spätere Änderungen genügt ein einfacher Push. Änderungen an den Extraktionspfaden passen die Dateikonfiguration nicht automatisch an.
Lade das Ergebnis mit einem JSONC-kompatiblen Loader und beachte dabei die Richtlinie für Katalogmetadaten. Der Provider erwartet eine Zuordnung von Zeichenfolgen. Weder ein bloßer Dateipfad noch ein gewöhnlicher JSON-Import führt diese Konvertierung vollständig durch.