lcheck 사용

lcheck 명령줄 도구는 Qt TS 번역 파일의 유효성을 검사하고 사람이 읽을 수 있는 보고서를 생성합니다. 이 도구는 Qt Linguist 툴체인의 일부이며 일반적인 로컬라이제이션 문제를 조기에 발견하기 위한 배치 또는 CI 용도로 사용됩니다. 기본적으로 lcheck 은 일련의 검사를 실행하고 하나 이상의 활성화된 검사에 실패할 경우 0이 아닌 종료 코드를 반환합니다.

기본 검사는 다음과 같습니다:

• 가속기 검사 - 소스 및 번역의 앰퍼샌드(니모닉) 수가 일치하는지 확인합니다.
• 주변 공백 검사 - 소스 및 번역의 선행 공백과 후행 공백이 일치하는지 확인합니다.
• 끝 문장 부호 검사 - 소스 및 번역이 동일한 문장 부호로 끝나는지 확인합니다.
• 플레이스 마커 검사 - 소스 및 번역 간에 %1, %2 등이 일관되게 사용되는지 확인합니다.

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

lcheck 구문

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

Where:

• options 는 하나 또는 여러 개의 lcheck 옵션을 의미합니다.
• ts-file 는 유효성을 검사할 TS 파일입니다.
• report-output-file 는 보고서를 작성할 파일 경로입니다. 생략하면 보고서가 표준 오류 스트림에 기록됩니다.

최신 도움말을 보려면 입력합니다:

lcheck -help

l확인 옵션

예제

파일에 보고서 쓰기

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