Watch-Modus: Automatische Neuübersetzung bei Dateiänderungen
Die Lingo.dev CLI unterstützt jetzt einen leistungsstarken Watch-Modus für den Befehl run, der automatische Neuübersetzungen ermöglicht, sobald sich Ihre Quelldateien ändern.
Funktionsweise
Wenn Sie die CLI mit dem Flag --watch ausführen, überwacht sie kontinuierlich Ihre konfigurierten Quelldateien (wie in Ihren i18n.json-Buckets definiert) auf Änderungen. Wenn eine Datei hinzugefügt, geändert oder gelöscht wird, löst die CLI automatisch den Übersetzungsworkflow aus und aktualisiert Ihre Zielsprachendateien und die i18n.lock nach Bedarf.
Dies ist ideal für schnelle Entwicklung, Live-Preview-Umgebungen oder jeden Workflow, bei dem Übersetzungen in Echtzeit mit Ihren Quellinhalten synchronisiert bleiben sollen.
Verwendung
npx lingo.dev@latest run --watch
- Die CLI startet im Watch-Modus und zeigt Logs für erkannte Änderungen und den Übersetzungsfortschritt an.
- Standardmäßig werden Änderungen für 5 Sekunden verzögert, um redundante Durchläufe bei schnellen Bearbeitungen zu vermeiden.
- Der Prozess läuft weiter, bis Sie ihn beenden (Strg+C).
Debounce-Option
Sie können die Verzögerungszeit (in Millisekunden) mit dem Flag --debounce anpassen:
npx lingo.dev@latest run --watch --debounce 10000
Dieses Beispiel setzt ein 10-Sekunden-Verzögerungsfenster zwischen erkannten Änderungen und dem nächsten Übersetzungsdurchlauf.
Funktionen
- Automatische Neuübersetzung: Aktualisiert Übersetzungen sofort, während Sie Ihre Quelldateien bearbeiten.
- Verzögerte Durchläufe: Verhindert übermäßige Übersetzungsanfragen während schneller Dateiänderungen.
- Fehlerbehandlung: Der Watch-Modus behandelt Fehler elegant und setzt die Überwachung nach Fehlern fort.
- Alle Dateitypen: Funktioniert mit allen Dateitypen, die von Ihrer
i18n.json-Konfiguration unterstützt werden.
Wann der Watch-Modus verwendet werden sollte
- Während der aktiven Entwicklung mehrsprachiger Funktionen
- Beim Live-Vorschau von Übersetzungsänderungen in Ihrer Anwendung
- Für kontinuierliche Integration mit lokalen oder Cloud-basierten Entwicklungsumgebungen
Tipp: Der Watch-Modus ist für die Entwicklung und schnelle Iteration konzipiert. Für Produktion oder CI/CD verwenden Sie den Standard-Befehl run ohne --watch für einmalige Übersetzungsläufe.