lcheck 사용법

lcheck 명령줄 도구는 Qt TS 번역 파일을 검증하고 사람이 읽기 쉬운 보고서를 생성합니다. 이 도구는 Qt Linguist 툴체인의 일부이며, 일반적인 현지화 문제를 조기에 파악하기 위해 일괄 처리 또는 CI 환경에서 사용하도록 설계되었습니다. 기본적으로 lcheck 는 일련의 검사를 실행하며, 활성화된 검사 중 하나라도 실패할 경우 0이 아닌 종료 코드를 반환합니다.

기본 검사 항목은 다음과 같습니다:

• 액셀러레이터 검사 — 원문과 번역문의 앰퍼샌드(기호) 개수가 일치하는지 확인합니다.
• 전후 공백 검사 — 원문과 번역문의 앞뒤 공백이 일치하는지 확인합니다.
• 종료 구두점 검사 — 원문과 번역문의 마지막 구두점이 동일한지 확인합니다.
• 위치 마커 검사 — 원문과 번역문에서 %1, %2 등의 사용이 일관된지 확인합니다.

각 검사 항목은 명령줄 옵션을 사용하여 개별적으로 비활성화할 수 있습니다.

lcheck 구문

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

여기서:

• options 는 하나 이상의 lcheck 옵션을 의미합니다.
• ts-file 는 유효성 검사를 수행할 ` TS ` 파일입니다.
• report-output-file 는 보고서를 기록할 파일의 경로입니다. 생략할 경우, 보고서는 표준 오류 스트림에 기록됩니다.

최신 도움말을 보려면 다음을 입력하십시오:

lcheck -help

lcheck 옵션

예제

파일에 보고서 작성하기

lcheck -o lcheck_report.txt translations/myapp_de.ts

선택한 검사를 비활성화하기

다음 명령은 가속기 및 구두점을 제외한 모든 검사를 실행합니다:

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

완료된 번역도 확인

lcheck -check-finished translations/myapp_de.ts

CI 단계에서 lcheck을 사용하세요

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

CMake에서 lcheck 사용하기

CMake 프로젝트를 구성하거나 빌드할 때 ` lcheck `를 호출하려면, ` Qt6LinguistTools ` 패키지를 불러온 다음 ` $<TARGET_FILE:Qt6::lcheck> `를 사용하여 ` lcheck ` 실행 파일을 찾아야 합니다.

다음 예제는 TS 파일에 대해 lcheck 를 실행하고 빌드 산출물 옆에 보고서를 작성하는 사용자 정의 타깃 check_translations 를 추가합니다.

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

qmake에서 lcheck 사용하기

프로젝트 파일을 지정하지 않고도 TS 파일에 대해 lcheck 를 직접 실행할 수 있습니다:

lcheck translations/myapp_de.ts