lconvert 사용법

lconvert 명령줄 도구는 번역 데이터 파일을 필터링하고 변환합니다.

다음 파일 형식을 지원합니다:

• pot - GNU Gettext 현지화 템플릿 파일
• qph - Qt Linguist 구문집
• ts - Qt 번역 소스
• po - GNU Gettext 현지화 파일
• qm - 컴파일된 Qt 번역
• xlf - XLIFF 현지화 파일

lconvert 구문

lconvert [options] <infile> [<infile>...]

여기서:

• options 는 하나 이상의 lconvert 옵션을 의미합니다.
• infile 는 입력 파일입니다. 여러 개의 입력 파일을 지정할 수 있습니다.

여러 개의 입력 파일을 지정하면, 파일 순서대로 번역 내용이 병합되며, 뒤에 나오는 파일의 번역 내용이 우선 적용됩니다.

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

lconvert -help

lconvert 옵션

예시

TS 파일을 XLIFF로 변환

단일 TS 파일을 XLIFF로 변환하려면 터미널에서 다음 명령을 실행하십시오:

lconvert -o myapp_de.xlf myapp_de.ts

여러 QM 파일 병합

다음 명령어는 여러 QM 파일을 ` full_de.qm` 파일로 병합합니다:

lconvert -o full_de.qm qtbase_de.qm myapp_de.qm mylib_de.qm

CMake에서 lconvert 사용하기

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

다음 예제는 단일 TS 파일을 XLIFF로 변환하는 사용자 정의 타깃 xlf_de 를 추가합니다.

find_package(Qt6 REQUIRED COMPONENTS LinguistTools)

add_custom_command(
    OUTPUT myapp_de.xlf
    COMMAND $<TARGET_FILE:Qt6::lconvert> -o myapp_de.xlf myapp_de.ts
    DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/myapp_de.ts"
    VERBATIM
)

add_custom_target(xlf_de
    DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/myapp_de.xlf"
)

PO 형식별 옵션

PO 형식으로 변환할 때, po-flags 의 추가 메타데이터 필드에 no-wrap 플래그를 설정하여 자동 줄 바꿈을 비활성화할 수 있습니다. 기본적으로 79자보다 긴 줄은 줄 바꿈됩니다. 이 필드는 소스 코드에서 //~ 메타 문자열 (예: //~ po-flags no-wrap)을 사용하여 설정하거나, TS 파일에서 <extra-po-flags> 요소를 사용하여 직접 설정할 수 있습니다.

다른 PO 플래그( GNU gettext 문서 참조)는 TS와 PO 형식 간 변환 시 유지되지만, lconvert 처리에는 영향을 미치지 않습니다.