Schutz gegen Drift der Übersetzungsschlüssel

Englische Strings als Übersetzungsschlüssel zu verwenden ist bequem, bis jemand das Englische bearbeitet. Der Schlüssel passt nicht mehr, jede Locale fällt auf den Schlüssel zurück, und die Seite rendert auf Englisch - ohne Fehler, ohne Warnung und ohne fehlschlagenden Test. Die Regression bleibt unsichtbar, bis ein Muttersprachler sie bemerkt.

Die Skill-Datei

---
name: translation-key-drift-guard
description: Nutzen Sie dies auf jeder Website, deren Übersetzungsschlüssel der englische Quelltext sind, wo das Bearbeiten einer Überschrift stillschweigend jede andere Sprache zurücksetzt.
---

# Schutz gegen Drift der Übersetzungsschlüssel

Englische Strings als Übersetzungsschlüssel zu verwenden ist bequem, bis jemand das Englische bearbeitet. Der Schlüssel passt nicht mehr, jede Locale fällt auf den Schlüssel zurück, und die Seite rendert auf Englisch - ohne Fehler, ohne Warnung und ohne fehlschlagenden Test. Die Regression bleibt unsichtbar, bis ein Muttersprachler sie bemerkt.

## Was Sie vorher brauchen

- Der Quellbaum mit den Übersetzungsaufrufen
- Die Locale-Dateien

## Methode

1. Extrahieren Sie jedes Literal, das in Templates und Anwendungscode an die Übersetzungsfunktion übergeben wird, und berücksichtigen Sie dabei beide Anführungszeichenarten.
2. Vergleichen Sie diese Menge mit den Schlüsseln in jeder Locale-Datei. Alles, was in der Quelle steht, aber in einer Locale fehlt, ist ein String, der stillschweigend auf Englisch rendert.
3. Prüfen Sie die Platzhalter-Parität in beide Richtungen: ein Schlüssel mit einem benannten Platzhalter, den die Übersetzung weggelassen hat, erzeugt zur Laufzeit einen kaputten Satz, keinen Fehler.
4. Melden Sie Schlüssel, die in einer Locale vorhanden, in der Quelle aber nicht vorhanden sind, als Waisen - gefahrlos entfernbar und ein Signal dafür, dass ein englischer String bearbeitet wurde.
5. Hängen Sie die Prüfung in den Release-Pfad, sodass sie mit einem Exit-Code ungleich null abbricht. Eine Prüfung, die niemand ausführt, ist keine Prüfung.
6. Beweisen Sie, dass sie fehlschlägt: löschen Sie einen Schlüssel, bestätigen Sie den Abbruch, und stellen Sie ihn wieder her. Eine Zusicherung, die man nie hat fehlschlagen sehen, verdient kein Vertrauen.

## Was dabei herauskommt

Ein Bericht pro Locale über fehlende Schlüssel, Platzhalter-Abweichungen und Waisen, mit einem Exit-Code ungleich null, der ein Deployment blockieren kann.

## Wo es schiefgeht

- Die Prüfung bauen, aber nie verifizieren, dass sie bei einer echten Regression tatsächlich fehlschlägt
- Die Platzhalter-Parität ignorieren, die Sätze zerstört, statt sie bloß zurückzusetzen
- Verwaiste Schlüssel als Rauschen behandeln, obwohl sie meist der Beleg dafür sind, dass englischer Text ohne Aktualisierung der Locales bearbeitet wurde

---

Aus der QuQi-Skill-Bibliothek - https://www.quqi.io/de/skills/translation-key-drift-guard

Was Sie vorher brauchen

• Der Quellbaum mit den Übersetzungsaufrufen
• Die Locale-Dateien

Methode

1. 01 Extrahieren Sie jedes Literal, das in Templates und Anwendungscode an die Übersetzungsfunktion übergeben wird, und berücksichtigen Sie dabei beide Anführungszeichenarten.
2. 02 Vergleichen Sie diese Menge mit den Schlüsseln in jeder Locale-Datei. Alles, was in der Quelle steht, aber in einer Locale fehlt, ist ein String, der stillschweigend auf Englisch rendert.
3. 03 Prüfen Sie die Platzhalter-Parität in beide Richtungen: ein Schlüssel mit einem benannten Platzhalter, den die Übersetzung weggelassen hat, erzeugt zur Laufzeit einen kaputten Satz, keinen Fehler.
4. 04 Melden Sie Schlüssel, die in einer Locale vorhanden, in der Quelle aber nicht vorhanden sind, als Waisen - gefahrlos entfernbar und ein Signal dafür, dass ein englischer String bearbeitet wurde.
5. 05 Hängen Sie die Prüfung in den Release-Pfad, sodass sie mit einem Exit-Code ungleich null abbricht. Eine Prüfung, die niemand ausführt, ist keine Prüfung.
6. 06 Beweisen Sie, dass sie fehlschlägt: löschen Sie einen Schlüssel, bestätigen Sie den Abbruch, und stellen Sie ihn wieder her. Eine Zusicherung, die man nie hat fehlschlagen sehen, verdient kein Vertrauen.

Was dabei herauskommt

Ein Bericht pro Locale über fehlende Schlüssel, Platzhalter-Abweichungen und Waisen, mit einem Exit-Code ungleich null, der ein Deployment blockieren kann.

Wo es schiefgeht

• Die Prüfung bauen, aber nie verifizieren, dass sie bei einer echten Regression tatsächlich fehlschlägt
• Die Platzhalter-Parität ignorieren, die Sätze zerstört, statt sie bloß zurückzusetzen
• Verwaiste Schlüssel als Rauschen behandeln, obwohl sie meist der Beleg dafür sind, dass englischer Text ohne Aktualisierung der Locales bearbeitet wurde

Mehr in Internationales SEO