Utilisation de lcheck

L'outil en ligne de commande « lcheck » valide les fichiers de traduction d'TS s Qt XML et génère un rapport lisible par l'utilisateur. Il fait partie de la chaîne d'outils « Qt Linguist » et est destiné à une utilisation par lots ou dans le cadre d'un processus d'intégration continue (CI) afin de détecter rapidement les problèmes courants de localisation. Par défaut, « lcheck » exécute une série de vérifications et renvoie un code de sortie différent de zéro si au moins une vérification activée échoue.

Les contrôles par défaut sont les suivants :

• Contrôledes accélérateurs — Vérifie que le nombre d’ampères (mnémoniques) dans le texte source et la traduction correspond.
• Vérification des espacesde début et de fin — Vérifie que les espaces de début et de fin du texte source et de la traduction correspondent.
• Vérification de la ponctuationfinale — Vérifie que le texte source et la traduction se terminent par la même ponctuation.
• Vérification des marqueursde position — Vérifie la cohérence dans l’utilisation de %1, %2, etc., entre le texte source et la traduction.

Chaque vérification peut être désactivée individuellement à l’aide d’options de 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 correspond au fichier « TS » à valider.
• report-output-file correspond au chemin d'accès du fichier dans lequel le rapport doit être écrit. S'il est omis, le rapport est écrit dans le flux d'erreurs standard.

Pour consulter l'aide la plus récente, saisissez :

lcheck -help

lcheck options

Exemples

Écrire un rapport dans un fichier

lcheck -o lcheck_report.txt translations/myapp_de.ts

Désactiver les contrôles sélectionnés

La commande suivante exécute toutes les vérifications, à l'exception de celles concernant les accélérateurs et 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

Utilisez lcheck dans une étape de CI

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

Utilisation de lcheck avec CMake

Pour appeler lcheck lors de la configuration ou de la compilation de votre projet CMake, chargez le paquet 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 génère un rapport à côté des artefacts de compilation.

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 de projet :

lcheck translations/myapp_de.ts