Verwendung von lcheck

Das Befehlszeilentool „ lcheck “ validiert Qt- TS -Übersetzungsdateien und erstellt einen für Menschen lesbaren Bericht. Es ist Teil der „ Qt Linguist “-Toolchain und für den Batch- oder CI-Einsatz vorgesehen, um häufige Lokalisierungsprobleme frühzeitig zu erkennen. Standardmäßig führt „ lcheck “ eine Reihe von Prüfungen durch und gibt einen Exit-Code ungleich Null zurück, wenn mindestens eine aktivierte Prüfung fehlschlägt.

Die Standardprüfungen sind:

• Accelerator-Prüfung – Überprüft, ob die Anzahl der Und-Zeichen (Mnemonics) in Quelle und Übersetzung übereinstimmt.
• Prüfung derumgebenden Leerzeichen – Überprüft, ob die führenden und nachfolgenden Leerzeichen in Quelle und Übersetzung übereinstimmen.
• Prüfung derabschließenden Interpunktion – Es wird überprüft, ob Originaltext und Übersetzung mit derselben Interpunktion enden.
• Prüfungder Platzhalter – Es wird überprüft, ob „ %1 “, „ %2 “ usw. in Originaltext und Übersetzung einheitlich verwendet werden.

Jede Prüfung kann einzeln über Befehlszeilenoptionen deaktiviert werden.

lcheck-Syntax

lcheck [options] -o report-output-file ts-file
lcheck [options] ts-file

Dabei gilt:

• options steht für eine oder mehrere lcheck-Optionen.
• ts-file ist die zu validierende „ TS “-Datei.
• report-output-file ist der Pfad der Datei, in die der Bericht geschrieben werden soll. Wird dieser weggelassen, wird der Bericht in den Standard-Fehlerstrom geschrieben.

Um die aktuelle Hilfe anzuzeigen, geben Sie Folgendes ein:

lcheck -help

lcheck options

Beispiele

Einen Bericht in eine Datei schreiben

lcheck -o lcheck_report.txt translations/myapp_de.ts

Ausgewählte Prüfungen deaktivieren

Der folgende Befehl führt alle Prüfungen außer „Beschleuniger“ und „Zeichensetzung“ durch:

lcheck -no-accelerator -no-punctuation translations/myapp_de.ts

Auch fertige Übersetzungen prüfen

lcheck -check-finished translations/myapp_de.ts

Verwenden Sie „lcheck“ in einem CI-Schritt

lcheck translations/myapp_de.ts && echo "Translations OK" || echo "Issues found"

Verwendung von lcheck mit CMake

Um „ lcheck “ beim Konfigurieren oder Erstellen Ihres CMake-Projekts aufzurufen, laden Sie das Paket „ Qt6LinguistTools “ und verwenden Sie „ $<TARGET_FILE:Qt6::lcheck> “, um die ausführbare Datei „ lcheck “ zu finden.

Das folgende Beispiel fügt ein benutzerdefiniertes Ziel „ check_translations “ hinzu, das „ lcheck “ auf eine TS-Datei anwendet und einen Bericht neben den Build-Artefakten erstellt.

find_package(Qt6 REQUIRED COMPONENTS LinguistTools)

add_custom_command(
    OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/lcheck_report.txt"
    COMMAND $<TARGET_FILE:Qt6::lcheck>
            -o "${CMAKE_CURRENT_BINARY_DIR}/lcheck_report.txt"
            "${CMAKE_CURRENT_SOURCE_DIR}/translations/myapp_de.ts"
    DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/translations/myapp_de.ts"
    VERBATIM
)

add_custom_target(check_translations
    DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/lcheck_report.txt"
)

Verwendung von `lcheck` mit `qmake`

Sie können „ lcheck “ direkt auf eine TS-Datei anwenden, ohne eine Projektdatei anzugeben:

lcheck translations/myapp_de.ts