CLI v0: Schlüsselsteuerung und manuelle Änderungen
Unterscheide in älteren Katalogen klar zwischen quellgesteuerten Werten, manuell verwalteten Übersetzungen und normalen Korrekturen.
Eine normale manuelle Korrektur und ein zur Beibehaltung markierter Schlüssel haben unterschiedliche Lebenszyklen. V0 behält einen vorhandenen Zielwert normalerweise bei, solange die Quelle unverändert bleibt. Ein zur Beibehaltung markierter Schlüssel reserviert den Wert dagegen für die manuelle Pflege – auch wenn sich der Quelltext ändert.
Korrigiere eine normale Übersetzung #
Bearbeite den Zielwert direkt und halte die akzeptierte Formulierung in einem Commit fest. Bleibt die Quelle unverändert, kann der normale Delta-Abgleich den Wert beibehalten. Ändert sich die Prüfsumme der Quelle, kommt der Schlüssel wieder für eine Übersetzung infrage. Ein erzwungener Durchlauf kann den Wert auch bei unveränderter Quelle ersetzen.
Nutze dieses Vorgehen für Korrekturen, deren Bedeutung bei einer Änderung der Quelle neu betrachtet werden sollte. Für Inhalte, die dauerhaft manuell verwaltet werden müssen, wähle die Beibehaltung und lege einen Prozess zur Prüfung von Quelländerungen fest.
Lege die Zuständigkeit ausdrücklich fest #
| Steuerung | Ausgabeverhalten in der älteren Version |
|---|---|
lockedKeys | Kopiert den Quellwert und kann dabei eine Änderung am Zielwert überschreiben. |
ignoredKeys | Schließt ausgewählte Inhalte von der Übersetzung und Ausgabe aus. |
preservedKeys | Füllt einen fehlenden Wert zunächst mit dem Quellwert und behält den Zielwert anschließend zur manuellen Pflege bei. |
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
}
}
}Hier bleibt der Markenname unverändert, interne Einträge verschwinden und rechtliche Begriffe bleiben in menschlicher Verantwortung. Ein neu zur Beibehaltung markierter Platzhalter in der Quellsprache muss vor der Veröffentlichung noch übersetzt werden. Erwartet die Anwendung einen ignorierten Schlüssel, stelle einen Ersatzwert bereit oder passe die Anwendung so an, dass sie diesen Schlüssel nicht mehr erwartet.
Untersuche sich überschneidende Steuerungsmuster, statt eine nicht dokumentierte Rangfolge vorauszusetzen. Dieses Verhalten von v0 unterscheidet sich von den aktuellen Steuerungsmöglichkeiten zur Beibehaltung von Zielwerten.
Sprich verschachtelte und wörtliche Schlüssel an #
In älteren Pfaden dienen Schrägstriche zur Navigation durch die Struktur. brand/name wählt name innerhalb von brand aus; modules/ai.translation wählt einen wörtlichen Schlüssel mit Punkten innerhalb von modules aus. Platzhalter folgen der älteren Abgleichslogik und sollten auf der vorgesehenen Verschachtelungstiefe getestet werden. Die aktuelle Punkt- und Klammersyntax lässt sich nicht als Ersatz dafür verwenden.
Verwende Übersetzungen beim Umbenennen wieder #
Der alte Delta-Abgleich kann den Hash des Quellwerts eines neuen Schlüssels mit dem vorherigen Hash eines entfernten Schlüssels im selben verarbeiteten Pfadkontext abgleichen. Bleibt der Text identisch, kann ein vorhandener Zielwert ohne erneute Übersetzung auf den umbenannten Schlüssel übertragen werden.
Änderst du sowohl den Schlüssel als auch die Quelle, entsteht neue Arbeit. Wechsel zwischen unabhängigen Pfaden oder mehrfach vorkommende identische Zeichenfolgen erfordern eine genauere Untersuchung: Der Abgleich ist kein uneingeschränkt nutzbares Translation Memory. Aktuelle JSON-Identitäten sind pfadbasiert und übernehmen dieses Verhalten nicht.
Nutze Erneute Übersetzung zum gezielten Ersetzen und Übersetzerhinweise für kontextbezogene Hinweise. Beides ersetzt nicht die Entscheidung, wer einen Ausgabewert verwaltet.