ltext2id 사용
ltext2id 명령줄 도구는 텍스트 기반 번역을 사용하는 프로젝트를 ID 기반 번역을 사용하도록 변환합니다. 프로젝트 트리를 스캔하여 ID 기반 번역 API를 호출하도록 소스 코드를 업데이트하고 관련 TS 파일을 적절히 조정합니다. 변환에 실패한 경우 소스에는 실패한 위치에 //ltext2id error: 주석이 추가됩니다.
참고: ltext2id 을 실행하기 전에 전체 백업(또는 깨끗한 Git 브랜치에서 작업)을 하세요. 이 도구는 소스 파일과 TS 파일을 제자리에서 수정합니다.
최상의 결과를 얻으려면 도구에 전달하는 프로젝트 루트에 소스 파일과 TS 파일을 모두 포함시켜 코드와 번역 간에 업데이트가 일관되게 유지되도록 하세요.
ltext2id 구문
ltext2id [options] [project-root]
Where:
options는 하나 또는 여러 개의 ltext2id 옵션을 의미합니다.project-root는 재귀적으로 처리할 디렉터리입니다.
최신 도움말을 보려면 입력합니다:
ltext2id -help
ltext2id 옵션
| 옵션 | 동작 |
|---|---|
-help | 최신 도움말 정보를 표시하고 종료합니다. |
-no-labels | ID 기반 번역에 대한 레이블을 생성하지 마세요. 기본적으로 메시지 컨텍스트가 레이블로 사용되므로 항목이 Qt Linguist 에서 유사한 시각화를 유지합니다. |
-sort-messages | TS 파일에서 컨텍스트의 메시지를 알파벳순으로 정렬합니다. |
-source-utf16 | 소스 파일을 UTF-16 인코딩된 것으로 처리합니다(기본값: false). |
-quiet | 진행률 출력을 표시하지 않습니다. |
-only-meta-id | 메타 문자열을 삽입하여 ID를 제안만 하고 실제 ID 기반 호출로 변환하지 않습니다. |
-no-auto-id | 메타 문자열 ID가 누락된 경우 ID를 자동 생성하지 않습니다. 메타 ID가 없는 번역 함수 호출은 무시됩니다. |
-version | ltext2id 버전을 표시하고 종료합니다. |
예제
프로젝트를 ID 기반 번역으로 변환하기
프로젝트 루트에서 도구를 실행합니다. 해당 디렉터리 아래의 소스 코드 및 TS 파일이 제자리에서 업데이트됩니다.
ltext2id path/to/project
ID 제안만 생성(코드 변경 없음)
-only-meta-id 을 사용하여 ID 기반 API에 대한 호출을 다시 작성하지 않고 메타 문자열 ID 제안을 삽입합니다. 그 결과 번역 호출에는 제안된 ID(메타 ID)를 지정하는 '//~ meta-id <id>'(cpp) 메타 문자열이 주석으로 추가됩니다.
ltext2id -only-meta-id path/to/project
레이블 생성 비활성화하기
컨텍스트가 Qt Linguist 에서 레이블로 미러링되지 않도록 하려면 레이블 생성을 방지하세요:
ltext2id -no-labels path/to/project
자동 생성된 ID 사용 안 함
메타 ID가 누락된 호출, 즉 메타 문자열 '//~ meta-id <id>'(cpp)를 사용하여 이미 지정된 ID에 대해서는 자동 생성을 건너뜁니다:
ltext2id -no-auto-id path/to/project
UTF-16 소스 파일로 작업
소스가 UTF-16으로 인코딩된 경우 이 옵션을 활성화하세요:
ltext2id -source-utf16 path/to/project
상태 종료
ltext2id 는 실패 시(예: 파일 변환 중 복구할 수 없는 오류가 발생한 경우) 0이 아닌 종료 코드를 반환합니다. //ltext2id error: 로 표시된 제자리 소스 주석을 검사하여 나머지 문제를 해결하세요.
© 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.