En esta página

Uso de lcheck

La herramienta de línea de comandos « lcheck » valida los archivos de traducción de Qt TS y genera un informe legible para el usuario. Forma parte del conjunto de herramientas Qt Linguist y está pensada para su uso por lotes o en entornos de integración continua (CI), con el fin de detectar a tiempo los problemas habituales de localización. Por defecto, « lcheck » ejecuta un conjunto de comprobaciones y devuelve un código de salida distinto de cero si falla al menos una de las comprobaciones habilitadas.

Las comprobaciones predeterminadas son:

  • Comprobaciónde aceleradores: verifica que el número de signos «&» (mnemónicos) en el texto original y en la traducción coincida.
  • Comprobación de espacios en blancoa ambos lados: comprueba que los espacios en blanco iniciales y finales del texto original y de la traducción coincidan.
  • Comprobación de la puntuaciónfinal: comprueba que el texto original y la traducción terminen con la misma puntuación.
  • Comprobaciónde marcadoresde posición: comprueba que el uso de « %1 », « %2 » y similares sea coherente entre el texto original y la traducción.

Cada comprobación se puede desactivar individualmente mediante opciones de línea de comandos.

Sintaxis de lcheck

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

Donde:

  • options significa una o varias opciones de lcheck.
  • ts-file es el archivo « TS » que se va a validar.
  • report-output-file es la ruta del archivo en el que se escribirá el informe. Si se omite, el informe se escribe en el flujo de error estándar.

Para consultar la ayuda más reciente, introduzca:

lcheck -help

opciones de lcheck

OpciónAcción
-helpMuestra información de ayuda actualizada y sale.
-no-acceleratorDesactivar la comprobación de coherencia del acelerador (símbolo «&»).
-no-punctuationDesactivar la comprobación de coherencia de la puntuación final.
-no-place-markerDesactivar la comprobación que garantiza que « %1 », « %2 », etc., se utilicen de forma coherente entre el texto original y la traducción.
-no-whitespacesDesactivar la comprobación de coherencia de los espacios en blanco circundantes.
-check-finishedComprueba también los mensajes marcados como finalizados. Por defecto, las traducciones finalizadas no se comprueban.
-o <outfile>Escribir el informe de validación en <outfile>. Si no se especifica, el informe se escribe en la salida de error estándar.
-versionMostrar la versión de lcheck y salir.

Nota: El estado de salidadel proceso es distinto de cero si falla alguna comprobación habilitada. Esto hace que lcheck sea adecuado para su uso en procesos de integración continua (CI).

Ejemplos

Escribir un informe en un archivo

lcheck -o lcheck_report.txt translations/myapp_de.ts

Desactivar las comprobaciones seleccionadas

El siguiente comando ejecuta todas las comprobaciones excepto las de aceleradores y puntuación:

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

Comprobar también las traducciones ya finalizadas

lcheck -check-finished translations/myapp_de.ts

Utiliza lcheck en un paso de CI

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

Uso de lcheck con CMake

Para llamar a lcheck al configurar o compilar tu proyecto CMake, carga el paquete Qt6LinguistTools y utiliza $<TARGET_FILE:Qt6::lcheck> para localizar el ejecutable lcheck.

El siguiente ejemplo añade un objetivo personalizado check_translations que ejecuta lcheck sobre un archivo TS y genera un informe junto con los artefactos de compilación.

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

Uso de lcheck con qmake

Puedes ejecutar lcheck directamente sobre un archivo TS sin especificar un archivo de proyecto:

lcheck translations/myapp_de.ts

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.