React-Lokalisierung in der Code-Prüfung kontrollieren

Nutze Extraktion, Katalogprüfungen, TypeScript und den Anwendungs-Build, um unterschiedliche Lokalisierungsfehler vor dem Merge zu erkennen.

Eine geänderte React-Nachricht erreicht die Lesenden über den Quellcode, die Extraktion, einen Zielkatalog und den Lademechanismus der Anwendung. Beziehe neben dem Wortlaut auch diese gesamte Kette in die Prüfung ein. Eine korrekte Übersetzung mit veralteter Identität wird nie angezeigt. Ein Fallback auf den Quelltext kann eine fehlende Übersetzung verbergen, während die Ansicht weiterhin nutzbar bleibt.

Diese Methode gilt für das aktuelle React-Paket mit JSONC-Katalogen, die per CLI extrahiert werden. Nutze neben den Extraktionsprüfungen der CLI auch die Build- und Rendering-Prüfungen des Projekts.

Sieh dir zuerst die Quelltextänderung an #

Lies die neue Quellnachricht als Anweisung oder Aussage an die Nutzenden. Lies anschließend ihren Kontext. „Schaltfläche“ beschreibt eine Form; „Eine geplante Zahlung vor dem Absenden stornieren“ erklärt die Aktion, deren Bedeutung erhalten bleiben muss. Sowohl der Quelltext als auch der Kontext bestimmen die Identität mit. Deshalb kann selbst eine reine Kontextänderung einen neuen Zieleintrag erfordern.

Betrachte Platzhalter bei der Prüfung als Werte mit einem festen Zweck. Beim Übersetzen muss sich die Position eines Personennamens oder Betrags ändern lassen, ohne die Identität des jeweiligen Werts zu verändern. Bei Rich Text bleiben Navigation und Komponentenverhalten im Code, während der Satz um die benannten Tags herum übersetzt wird. Nachrichten und Rich Text beschreiben die genauen APIs.

Kontrolliere zuerst die Extraktion, dann die Zielkataloge #

Führe bei installierter CLI Folgendes im vorgesehenen Projektverzeichnis aus:

sh
lingo extract --check
lingo check

Verwende dieselben Optionen --src, --source-locale, --out und --types wie im Extraktionsbefehl des Projekts. Die Quellsprache ist standardmäßig en; die Lokalisierungskonfiguration ändert diesen Standardwert des Befehls nicht. Führe anschließend die TypeScript-Prüfung und den Produktions-Build des Repositorys aus und beziehe dabei die generierten Deklarationen ein.

Fehler zum Einbauen in eine lokale Testvorlage für die PrüfungFreigabebedingung und erwarteter Nachweis
Ändere eine Quellnachricht, ohne Kataloge oder Deklarationen neu zu generieren.extract --check vergleicht die generierte Ausgabe und schlägt fehl, wenn sie veraltet ist.
Lass den erforderlichen Kontext in einer extrahierten Nachricht weg.check meldet das Extraktions- oder Kontextproblem; sieh dir den Quelltext an, um die Bedeutung zu korrigieren.
Lass in einem vorhandenen JSONC-Zielkatalog einen Eintrag fehlen oder leer.check meldet die fehlende Übersetzung im gefundenen Katalog.
Lass die generierten Deklarationen veraltet.Die Extraktion bzw. die anschließende Kontrolle erkennt die Abweichung in der generierten Ausgabe; TypeScript kontrolliert unabhängig davon die Verwendung in der Anwendung.
Verursache einen Fehler in einem Sprachimport oder einer Framework-Integration.Der tatsächliche Build der Anwendung sollte den Integrationsfehler aufdecken.

Nutze eine lokale Testvorlage, wenn du diese Prüfungen zum ersten Mal einrichtest. extract --check läuft auch dann erfolgreich durch, wenn keine Quelldateien gefunden werden. Stelle deshalb sicher, dass das gemeldete Verzeichnis den vorgesehenen Code enthält. Andernfalls kann ein grünes Ergebnis bedeuten, dass die Prüfung gar nichts untersucht hat.

Kontrolliere ausdrücklich die Abdeckung der erforderlichen Sprachen #

Wenn die files-Muster in .lingo/config.json zum Quellkatalog passen (zum Beispiel locales/en.jsonc), verlangt lingo check auch eine Datei für jede konfigurierte Zielsprache. Das von lingo init --yes geschriebene Muster locales/en.json passt nicht zu einem .jsonc-Katalog. Damit laufen also nur die React-Prüfungen. Fehlende Schlüssel werden nur innerhalb vorhandener JSONC-Zielkataloge gemeldet. Vergleiche im Rahmen der Prüfung die Liste der erforderlichen Sprachen mit den Dateien und Importen. Entferne vorübergehend einen Zieleintrag in einer lokalen Testvorlage, um zu sehen, wie sich der Fallback auf den Quelltext in der Ansicht zeigt.

Lies repräsentative Paare aus Quelltext und Übersetzung und achte auf ihre Bedeutung, besonders bei geänderten Zusagen und Produktbegriffen. Eine fehlerfreie JSONC-Konsistenzprüfung sagt nichts über diese Bedeutung aus. ARB, Android-XML, Apple-Kataloge und statische Dokumente benötigen ihre jeweils eigenen Validierungsverfahren statt dieser React-spezifischen Abdeckungsprüfung.

Bereinige den Diff, ohne Ergebnisse mit abgeschlossener Prüfung zu zerstören #

Generiere veraltete Ausgaben mit lingo extract neu, sieh dir hinzugefügte und verwaiste Einträge an und übersetze die erforderlichen Änderungen. Behalte den Wortlaut der Zieltexte bei, deren Prüfung bereits abgeschlossen ist, und bewahre die Lokalisierungssperre. Das Entfernen verwaister Einträge verändert die Kataloge und sollte eine separate Prüfung erhalten, unabhängig von der Änderung der Quellnachricht.

Entscheide, ob Übersetzungen im Quell-Branch oder über einen separaten Übersetzungs-Pull Request eingehen. Der CI-Leitfaden erläutert die Vor- und Nachteile dieser Bereitstellungswege sowie die Unterschiede bei der verwalteten App. Halte bei beiden Varianten die Merge-Berechtigung, die Ausführungsberechtigung und die inhaltliche Abnahme voneinander getrennt.

Lade abschließend die geänderte Ansicht in einer Zielsprache mit repräsentativen Werten. Folge den Links im Rich Text, sieh dir das Fallback-Verhalten an und vergleiche die angezeigte Nachricht mit der beabsichtigten Aktion. Die Prüfung ist abgeschlossen, wenn sowohl der Weg der Nachricht durch das Programm als auch ihr Wortlaut untersucht wurden.