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-fileDonde:
optionssignifica una o varias opciones de lcheck.ts-filees el archivo «TS» que se va a validar.report-output-filees 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 -helpopciones de lcheck
| Opción | Acción |
|---|---|
-help | Muestra información de ayuda actualizada y sale. |
-no-accelerator | Desactivar la comprobación de coherencia del acelerador (símbolo «&»). |
-no-punctuation | Desactivar la comprobación de coherencia de la puntuación final. |
-no-place-marker | Desactivar la comprobación que garantiza que « %1 », « %2 », etc., se utilicen de forma coherente entre el texto original y la traducción. |
-no-whitespaces | Desactivar la comprobación de coherencia de los espacios en blanco circundantes. |
-check-finished | Comprueba 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. |
-version | Mostrar 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.tsDesactivar 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.tsComprobar también las traducciones ya finalizadas
lcheck -check-finished translations/myapp_de.tsUtiliza 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.