ltext2id 사용법

ltext2id 명령줄 도구는 텍스트 기반 번역을 사용하는 프로젝트를 ID 기반 번역이 사용되도록 변환합니다. 이 도구는 프로젝트 트리를 스캔하여 소스 코드를 업데이트해 ID 기반 번역 API를 호출하도록 하고, 관련 ` TS ` 파일을 그에 맞게 조정합니다. 변환에 실패한 경우, 소스 코드의 해당 위치에 ` //ltext2id error: ` 주석이 추가됩니다.

최상의 결과를 얻으려면, 코드와 번역 간의 일관성을 유지하기 위해 소스 파일과 TS 파일을 모두 도구에 전달하는 프로젝트 루트에 포함시키십시오.

ltext2id 구문

ltext2id [options] [project-root]

여기서:

• options 는 하나 이상의 ltext2id 옵션을 의미합니다.
• project-root 재귀적으로 처리할 디렉터리입니다.

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

ltext2id -help

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>' 메타 문자열을 사용하여 이미 지정된 ID(cpp)에 대해서는 자동 생성을 건너뛰십시오:

ltext2id -no-auto-id path/to/project

UTF-16 소스 파일 처리

소스 파일이 UTF-16으로 인코딩된 경우, 다음 옵션을 활성화하십시오:

ltext2id -source-utf16 path/to/project

종료 상태

ltext2id 실패 시(예: 파일 변환 중 복구 불가능한 오류가 발생한 경우) 0이 아닌 종료 코드를 반환합니다. //ltext2id error: 로 표시된 인플레이스 소스 주석을 확인하여 남아 있는 문제를 해결하십시오.