Einen einzelnen Schlüssel oder Begriff sicher aktualisieren

Einen ausgewählten Abschnitt neu übersetzen, benachbarte Inhalte beibehalten und sowohl die gewünschte Korrektur als auch die unveränderten Inhalte kontrollieren.

Eine gezielte Korrektur gelingt, wenn zwei Dinge zusammenkommen: Der ausgewählte Inhalt wird besser, und nicht betroffene, bereits akzeptierte Inhalte bleiben unverändert. Sichere die vorhandene Zielversion und die zugehörige Quellrevision, damit du beides kontrollieren kannst.

Nutze diese Anleitung für einen bekannten Schlüssel oder Begriff. Für reguläre Quelltextänderungen nutze Inhalte bei Aktualisierungen beibehalten. Sieh dir bei bereits eingereichten Aufträgen zuerst den Wiederherstellungsstatus an, bevor du weitere anforderst.

Bereits akzeptierte benachbarte Inhalte in den Vergleich einbeziehen #

Ein Beispielkatalog könnte Folgendes enthalten:

json
{
  "account": {
    "invitation": "Approval is required before access is granted.",
    "support": "Contact support"
  }
}

Angenommen, nur die Übersetzung von account.invitation muss korrigiert werden. Sichere die Zielversion und die Quellrevision – einschließlich der akzeptierten Formulierung von account.support, die du beibehalten möchtest.

Den passenden Weg zur Korrektur wählen #

Für eine präzise, einmalige Korrektur bearbeitest du den Zielwert direkt, kontrollierst ihn in der Anwendung und erstellst nach der Prüfung einen Commit des Katalogs. Reguläre Quelltextaktualisierungen können diese Änderung beibehalten, solange der Quelltext der Nachricht unverändert bleibt.

Gib der Übersetzung vor einer Neugenerierung zunächst die Informationen, die sie für ein anderes Ergebnis braucht. Füge dem Glossar der Engine einen freigegebenen Begriff hinzu, korrigiere eine wiederkehrende Anweisung in ihren Regeln oder präzisiere den JSONC-Kontext einer Nachricht. Aktualisiere anschließend die betroffenen Schlüssel. Bleiben Quelltext und Vorgaben unverändert, kann die Neugenerierung dieselbe Formulierung liefern.

Die Begriffsauswahl nach Bedeutung eingrenzen #

Definiere die Bedeutung des Begriffs, bevor du Nachrichten auswählst. So kann „Workspace“ in einem Produkt einen gemeinsamen Projektbereich bezeichnen, während eine andere Passage einen physischen Arbeitsplatz beschreibt. Halte die beabsichtigte Produktbedeutung und den vom Team freigegebenen Zielbegriff im Glossar fest. Wähle anschließend nur die Nachrichten aus, die den Begriff in dieser Bedeutung verwenden. Begriffsabgrenzung erläutert diese Entscheidung näher.

Einen vorhandenen Zielschlüssel mit der CLI auswählen #

In einem konfigurierten Projekt, das diese JSON-Quelle unter locales/en/account.json verwendet:

bash
lingo push "locales/en/account.json" --key "account.invitation" --wait

Bei JSON generiert --key ausgewählte Einheiten neu, auch wenn der Quelltext unverändert ist. Dabei werden diese Schlüssel in jeder konfigurierten Sprache aktualisiert, für die bereits eine Zieldatei vorhanden ist. Die neuen Werte werden in die jeweilige Zieldatei eingefügt.

Sichere vorhandene Korrekturen vor der Aktualisierung: Die von diesem Push erfassten Zielwerte können für die ausgewählten Schlüssel ersetzt werden. Um Änderungen an der Zielversion zu erkennen, die nach der Einreichung vorgenommen wurden, lass --wait weg und sieh dir vor dem Abrufen lingo pull --dry-run an. Hinweise zur Konfliktbehandlung findest du unter Klassifizierung lokaler Änderungen beim Pull.

Eine Schlüsselaktualisierung lässt die Vergleichsbasis der gesamten Quelle unverändert – unabhängig davon, ob push --wait oder ein separater Pull das Ergebnis abruft. Ausstehende reguläre Quelltextänderungen werden daher weiterhin bei einem späteren einfachen Push übermittelt.

Schlüsselmuster unterstützen exakte Schlüssel, Objektpräfixe und *-Platzhalter für ganze Segmente. auth.login kann auth.login.title einschließen, ohne auf auth.login_url zu passen. Setze Platzhalter in Anführungszeichen und wiederhole --key, wenn du mehrere gewünschte Muster angeben möchtest.

JSONC, TypeScript und PHP verhalten sich bei gezielten Aktualisierungen genauso. YAML und YAML mit Sprachen auf der obersten Ebene können ausgewählte Übersetzungen unverändert beibehalten. Bearbeite für eine präzise Korrektur die Zielversion direkt oder sichere akzeptierte Zielversionen, bevor du die gesamte Datei neu generierst. CLI-Geltungsbereiche beschreibt das Verhalten der Formate und definiert die Schreibweise der Schlüssel.

Die von einem Begriff betroffenen Schlüssel oder Dateien finden #

Finde Quellnachrichten, die den Begriff in der beabsichtigten Bedeutung verwenden, und sieh dir ihren Kontext an. Wähle die unterstützten Schlüssel mit --key im obigen Befehl aus. Sichere bei Formaten, die eine Neugenerierung der gesamten Datei erfordern, die akzeptierten Zielversionen und aktualisiere die betroffenen Quelldateien, zum Beispiel:

sh
lingo push 'docs/en/workspaces.md' --force --wait

Verwende einen Quellpfad, der bereits in deiner Konfiguration ausgewählt ist. Dadurch werden die Übersetzungen dieser Datei für die konfigurierten Zielsprachen ersetzt. Vergleiche die gesamte neu formulierte Nachricht oder Datei, einschließlich des Textes rund um den Begriff.

Änderungen, unveränderte Inhalte und Verwendung kontrollieren #

Vergleiche jeden geänderten Zielpfad mit der gespeicherten Version. Im Beispiel muss die Einladung weiterhin deutlich machen, dass vor dem Zugriff eine Genehmigung erforderlich ist. Die Supportnachricht muss ihrer akzeptierten Vergleichsbasis entsprechen. Fehlen benachbarte Inhalte oder wurden Inhalte unerwartet neu formuliert, kontrolliere vor der Annahme den Geltungsbereich und die Vergleichsbasis.

Kontrolliere Variablen und Steuerungsoptionen für Schlüssel: Eine Sperre kopiert den Quelltext, die Beibehaltung erhält einen Zielwert, und das Ignorieren entfernt Inhalte aus der Ausgabe eines Formats, das diese Funktion unterstützt.

Lade die Ausgabe in die Laufzeitumgebung, die sie verwendet. Sieh dir bei Dokumenten die geänderte Passage, Links und Komponenten an. Löse Pull-Konflikte, bevor du lokale Änderungen ersetzt. Erstelle anschließend einen Commit der akzeptierten Zielversionen zusammen mit ihrer Quellrevision und dem Lockfile.