Utilisation de lcheck

L'outil de ligne de commande lcheck valide les fichiers de traduction de Qt TS et produit un rapport lisible par l'homme. Il fait partie de la chaîne d'outils Qt Linguist et est destiné à une utilisation par lots ou en CI afin de détecter rapidement les problèmes de localisation les plus courants. Par défaut, lcheck exécute un ensemble de vérifications et renvoie un code de sortie non nul si au moins une des vérifications activées échoue.

Les vérifications par défaut sont les suivantes :

• Vérification de l'accélérateur - Vérifie que le nombre d'esperluettes (mnémoniques) dans la source et la traduction correspondent.
• Vérification des espaces blancsenvironnants - Vérifie que les espaces blancs d'entrée et de sortie de la source et de la traduction correspondent.
• Vérification de la ponctuationfinale - Vérifie que la source et la traduction se terminent par la même ponctuation.
• Vérification des marqueurs delieu - Vérifie l'utilisation cohérente de %1, %2, et ainsi de suite, entre la source et la traduction.

Chaque vérification peut être désactivée individuellement à l'aide des options de la ligne de commande.

Syntaxe de lcheck

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

Où :

• options désigne une ou plusieurs options de lcheck.
• ts-file est le fichier TS à valider.
• report-output-file est le chemin du fichier dans lequel le rapport doit être écrit. S'il est omis, le rapport est écrit dans le flux d'erreur standard.

Pour afficher l'aide la plus récente, entrez :

lcheck -help

lcheck options

Exemples d'utilisation

Écrire un rapport dans un fichier

lcheck -o lcheck_report.txt translations/myapp_de.ts

Désactiver certains contrôles

La commande suivante exécute toutes les vérifications à l'exception de l'accélérateur et de la ponctuation :

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

Vérifier également les traductions terminées

lcheck -check-finished translations/myapp_de.ts

Utiliser lcheck dans une étape de CI

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

Utiliser lcheck avec CMake

Pour appeler lcheck lors de la configuration ou de la construction de votre projet CMake, chargez le paquetage Qt6LinguistTools et utilisez $<TARGET_FILE:Qt6::lcheck> pour localiser l'exécutable lcheck.

L'exemple suivant ajoute une cible personnalisée check_translations qui exécute lcheck sur un fichier TS et écrit un rapport à côté des artefacts de construction.

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"
)

Utilisation de lcheck avec qmake

Vous pouvez exécuter lcheck directement sur un fichier TS sans spécifier de fichier projet :

lcheck translations/myapp_de.ts