Vorhandene Übersetzungen in CLI v0 übernehmen
Ergänze fehlende Schlüssel in älteren Katalogen, behalte vorhandene Werte bei und schaffe eine verlässliche Ausgangsbasis für den Quelltext.
V0 kann mit Katalogen arbeiten, die mit anderen Werkzeugen erstellt wurden. Der reguläre Delta-Abgleich vergleicht die Schlüssel in Quelle und Ziel und ergänzt fehlende Einträge, ohne vorhandene Werte neu zu generieren. Das unterscheidet sich vom Ergänzen fehlender Dateien in der aktuellen CLI.
Bestehende Arbeit erhalten #
Konfiguriere den Bucket des Katalogs in i18n.json und lege eine wiederherstellbare Sicherungskopie der akzeptierten Zielübersetzungen an. Stelle sicher, dass vorhandene Werte tatsächlich Übersetzungen sind: Platzhalter in der Ausgangssprache können genau die Lücken verdecken, die du schließen möchtest.
Diese Quelle enthält zum Beispiel drei Schlüssel:
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}Eine vorhandene spanische Zielübersetzung enthält zwei:
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}Der reguläre Lauf zum Ergänzen fehlender Einträge fügt button.cancel hinzu und behält vorhandene Werte bei – es sei denn, frühere Prüfsummen weisen auf eine Quelltextänderung hin, die eine erneute Übersetzung erfordert.
Eine einzelne Sprache verarbeiten und den Diff ansehen #
lingo run --target-locale esKontrolliere die Ergänzungen, die Entfernung von Schlüsseln, die nicht mehr in der Quelle vorkommen, und alle neu generierten Werte für geänderte Schlüssel. Sieh dir die sprachliche Qualität an und kontrolliere, ob die Inhalte in der Anwendung geladen werden. Erstelle anschließend einen Commit mit der akzeptierten Ausgabe und dem zugehörigen Lockfile-Stand.
Ein Lauf mit eingeschränktem Umfang aktualisiert eine bestehende Ausgangsbasis der Quelltext-Prüfsummen nicht. Ein unverändertes Lockfile belegt also nicht, dass alle Sprachen dem aktuellen Quelltext entsprechen. Ein späterer regulärer Lauf kann geänderte Quelltexte erneut verarbeiten; folge dazu der Anleitung zum Abgleich der Ausgangsbasis.
Wenn für einen vorhandenen Schlüssel keine frühere Prüfsumme vorliegt, kennzeichnet 0.138.10 ihn nicht allein deshalb als aktualisiert. Ein fehlendes Lockfile erzwingt daher keine erneute Übersetzung aller Inhalte und belegt auch nicht, dass vorhandene Zielübersetzungen aktuell sind. Sieh dir unklare Quell-Ziel-Paare an, bevor du die neue Ausgangsbasis als maßgeblich ansiehst.
Bekannte Probleme separat beheben #
Ist ein vorhandener Wert falsch, nimm eine manuelle Korrektur vor oder fordere eine gezielte Aktualisierung an:
lingo run --force --target-locale es --key button.cancelEine erzwungene Neugenerierung kann manuelle Arbeit überschreiben. Verwende geschützte Schlüssel, wenn ein Wert unter menschlicher Kontrolle bleiben muss. Zu dieser Verantwortung gehört auch die Prüfung späterer Quelltextänderungen.