CLI-v0-Referenz

Pflege ein bestehendes i18n.json-Projekt, ohne seine akzeptierten Übersetzungen oder den Ausgangsstand der Quellinhalte zu verlieren.

Dieses Handbuch behandelt das ältere Paket lingo.dev und seinen i18n.json/i18n.lock-Workflow. Die Beispiele beziehen sich auf 0.138.10. Behalte bei der Planung einer Migration die Version bei, die im Lockfile des bestehenden Projekts festgehalten ist. Die jeweils neueste Version kann sich ändern – ihre Installation ist daher keine reproduzierbare Wiederherstellung.

Starte ein neues Projekt mit der aktuellen CLI. Für ihren serverseitigen Push/Pull-Workflow gelten andere Regeln für Zustand und Auswahl.

So läuft eine bestehende v0-Installation ab #

Die Bucket-Konfiguration wählt einen Parser aus und ermittelt die Quell- und Zieldateien. Dabei wird [locale] bei Bedarf erweitert. Der Parser extrahiert die Inhalte und sondert erkannte, nicht übersetzbare Werte aus. Der Delta-Abgleich vergleicht Quellwerte, bestehende Zielwerte und frühere Prüfsummen der Quellinhalte, um neue, geänderte, entfernte oder umbenannte Einträge zu erkennen.

Der ausgewählte Text wird von einer Lokalisierungs-Engine von Lingo.dev oder einem konfigurierten direkten Anbieter verarbeitet. Aus den zurückgegebenen Übersetzungen werden die Zieldateien oder die Sprachabschnitte einer gemeinsamen Datei wieder aufgebaut. Einzelne Aufgaben können erfolgreiche Ergebnisse schreiben, bevor eine andere Aufgabe fehlschlägt. Das Projekt als Ganzes ist keine atomare Transaktion.

Den Ausgangsstand zusammen mit den Inhalten sichern #

Nimm i18n.json, die akzeptierten Sprachausgaben und i18n.lock gemeinsam in einen Commit auf. Das Lockfile hält den Zustand der Quellinhalte fest, nicht jede Änderung an Zielinhalten oder jede Sprachfreigabe. Reguläre Durchläufe aktualisieren die Prüfsummen der Quellinhalte. Durchläufe, die auf eine Zielsprache oder bestimmte Schlüssel beschränkt sind, können Ausgaben schreiben, ohne einen bestehenden Ausgangsstand zu aktualisieren.

Die Lockfile-Referenz erklärt, warum spätere reguläre Durchläufe eine Änderung am Quellinhalt nach einem eingeschränkten Durchlauf erneut aufgreifen können. Bestehende Übersetzungen beschreibt die Übernahme, ohne jeden vorhandenen Wert zu ersetzen.

Den nächsten Schritt finden #

Nutze die Anleitung für die erste Datei, um einen kleinen Durchlauf mit der älteren Version zu reproduzieren. Konfiguration und Formate zeigen, was die installierte Generation liest und schreibt.

Für die laufende Arbeit zeigt Sprachen, wie du eine Zielsprache hinzufügst. Schlüsselsteuerung unterscheidet reguläre Änderungen von Werten, die unter menschlicher Kontrolle stehen. Neuübersetzung legt den Umfang einer gezielten Aktualisierung fest. Monorepos und Parallele Verarbeitung behandeln Zuständigkeiten und Durchsatz, ohne vorauszusetzen, dass mehr Worker die Limits der Anbieter aufheben.