Chki18n

Über dieses Projekt

Chki18n ist ein Kommandozeilenwerkzeug, das Übersetzungsdateien gegen die Konventionen prüft, auf die ein internationalisiertes Projekt angewiesen ist. Es liest die Sprachdateien, die ein Projekt ohnehin hat, und meldet, was daran nicht stimmt — eine Prüfung, die sonst erst stattfindet, wenn ein fehlender Text auf dem Bildschirm auftaucht.

Es führt fünfundzwanzig Prüfungen aus und stuft jeden Befund nach dem Schaden ein, den er anrichtet. Als Fehler gilt, was die Oberfläche zerlegt: eine Datei, die sich nicht lesen oder nicht parsen lässt, ein doppelt definierter Schlüssel, eine Sprache, die in einer Gruppe fehlt, ein Schlüssel, der in einer Sprache vorhanden und in einer anderen verschwunden ist, und Interpolationsplatzhalter, die im Namen oder in der Anzahl nicht zur Ausgangssprache passen. Als Warnung gilt, was lediglich peinlich ist: ein leerer Wert, zwei Schlüssel mit demselben Text, ein Wert, der mit der Ausgangssprache identisch und damit unübersetzt ist, Ziffern, die beim Übersetzen weggefallen oder verändert worden sind, verlorenes Markup, ein Ausgangstext mit zwei verschiedenen Übersetzungen, ein unsichtbares Zeichen, eine fehlende Pluralform und ein Schlüssel, den keine andere Sprache mehr verwendet. Richtet man es zusätzlich auf den Quellcode, meldet es Schlüssel, auf die nichts verweist, und Schlüssel, nach denen der Code fragt, die aber in keiner Datei definiert sind.

Es läuft als Befehl, in einem CI-Job oder aus eigenem Code heraus und erscheint für JavaScript, Dart und Python, wobei alle drei dieselben Prüfungen in derselben Reihenfolge ausführen und denselben Bericht ausgeben. Es liest heute Übersetzungsdateien im JSON-Format, und es prüft statt zu übersetzen: Ein Lauf schreibt nichts in einer Datei um.

Funktionen

• Dokumentationsseite

• TypeScript-Typen

• Mehrsprachig

• Durch Tests geprüft

• Plattformübergreifend

• Kommandozeile