문구 번역
번역을 위해 Qt Linguist 에서 번역 소스(TS) 파일을 엽니다. TS 파일은 원문 문구와 해당 번역이 포함된 사람이 읽을 수 있는 XML 파일입니다. TS 파일은 일반적으로 lupdate 에서 생성 및 업데이트됩니다. TS 파일이 없는 경우, ‘번역 파일 생성’을 참조하여 파일을 생성하는 방법을 알아보세요.
Qt Linguist 를 사용하여 다른 프로그램에서 생성된 국제 XML 현지화 교환 파일 형식(XLIFF) 파일도 번역할 수 있습니다. 그러나 표준 Qt 프로젝트의 경우 TS 파일 형식만 사용됩니다. 현재는 XLIFF 버전 1.1 및 1.2만 지원됩니다.
Qt Linguist 번역 영역에 대상 언어를 표시하고, 복수형에 따라 입력 필드의 수를 적절히 조정합니다. 여러 TS 파일을 동시에 열어 번역할 경우, 각 언어별로 ‘ Translator ’ 및 ‘ Translator comment ’ 필드가 표시됩니다. 위치 정보 설정에 대한 자세한 내용은 ‘대상 로케일 변경’을 참조하십시오.
개발자가 의미 구분을 위한 주석을 제공한 경우, ‘ Developer comments ’ 필드에서 이를 확인할 수 있습니다.
문구를 번역하려면:
- ' File ' > ' Open '을 선택하여 TS 파일을 불러옵니다.
- ' Context ' 보국에서 컨텍스트를 선택하면 ' Strings ' 보국에 번역 가능한 문자열이 표시됩니다.

- 문구를 선택하면 번역 영역의 ‘ Source text ’ 필드에 해당 문구가 표시됩니다. 원본 텍스트 내의 공백이 시각적으로 표시됩니다.
- ' Translation ' 필드에 현재 문자열의 번역문을 입력합니다.
Phrases and guesses 필드에서 기존 번역을 더블 클릭하면 해당 번역을 현재 문자열의 번역으로 사용할 수 있습니다. Qt Linguist 은 구문집에서 구문을 읽어들이고, TS 파일에 있는 유사한 구문의 기존 번역을 바탕으로 추측을 수행합니다.
- 원하는 경우, ‘ Translator comment ’ 필드에 다른 번역가들을 위한 코멘트를 입력할 수 있습니다.
- 번역을 수락하려면 Ctrl+Enter를 누르거나, ‘
’를 선택하거나, 문자열 목록에서 선택한 원문 문자열 왼쪽에 있는 아이콘을 클릭하십시오. - File > Save 을 선택하여 작업 내용을 저장하십시오.
문자열 목록의 모든 문자열에 ‘
’(Accepted/Correct) 또는 ‘
’(Accepted/Warnings)가 표시될 때까지 이 과정을 반복합니다. 그런 다음 다음 컨텍스트를 선택하고 계속 진행합니다.
원문과 번역문의 단어 수 및 문자 수를 보려면, ‘ View ’ > ‘ Statistics ’을 선택하십시오.
File > Release 을 선택하여 현재 번역 원본 파일과 동일한 기본 이름을 가진 QM 파일을 생성합니다. lrelease 도구는 애플리케이션의 모든 번역 원본 파일에 대해 동일한 기능을 수행합니다.
번역 원본과 번역 결과를 인쇄하려면 ‘ File ’ > ‘ Print ’을 선택하십시오.
Qt Linguist 를 종료하려면 ‘ File ’ > ‘ Exit ’을 선택하십시오.
번역 가능한 문자열 간 이동
다음 미완성 번역으로 이동하려면 ‘
’(‘Next Unfinished ’)를 선택하거나 Ctrl+J를 누르십시오.
다음 원문으로 이동하려면, ‘
’을 선택하거나, Ctrl+Shift+J를 누르거나, ‘ Translation ’ > ‘ Next ’을 선택하십시오.
문맥에 따라 여러 가지 번역이 필요한 구문
동일한 구문이 서로 충돌하지 않는 여러 문맥에서 나타날 수 있습니다. 번역된 구문이 다시 나타날 때, ‘ Qt Linguist ’는 ‘ Phrases and guesses ’ 보기에서 이전 번역을 가능한 번역으로 제공합니다.
특정 문맥 내에서 문구가 두 번 이상 나타나는 경우, ‘ Context ’ 보기에는 한 번만 표시되며, 해당 번역은 문맥 내의 모든 발생 위치에 적용됩니다. 동일한 문구가 같은 문맥 내에서 서로 다른 의미를 지닐 경우, 개발자는 해당 문구가 나타나는 각 위치에 대해 주석을 제공해야 합니다. 중복된 문구는 ‘ Context ’ 보기에 표시됩니다. 개발자의 주석은 연한 파란색 배경의 번역 영역에 표시됩니다.
키보드 단축키 변경
키보드 단축키는 특정 동작을 수행하는 키 조합입니다.
Alt 키 단축키
메뉴 항목 및 버튼 텍스트에서 니모닉 문자(밑줄로 표시됨)는 밑줄이 그어진 문자와 함께 Alt 또는 Ctrl 키를 누르면 메뉴 항목을 클릭하거나 버튼을 누르는 것과 동일한 동작이 수행됨을 나타냅니다.
예를 들어, 응용 프로그램에서는 종종 ‘ File ’ 메뉴에서 F를 니모닉 문자로 사용하므로, 메뉴 항목을 클릭하거나 Alt+F를 눌러 메뉴를 열 수 있습니다. 번역 가능한 문자열 내의 니모닉 문자는 앰퍼샌드(&)로 시작합니다: \&File. 이 문자열의 번역본에도 앰퍼샌드가 포함되어야 하며, 가급적이면 동일한 문자 앞에 위치해야 합니다.
앰퍼샌드가 포함된 문구를 통해 Alt 키 단축키의 의미를 파악할 수 있습니다. 번역된 문구에 현재 니모닉 문자가 포함되어 있지 않거나, 해당 문맥에서 다른 단축키 번역에 이미 사용된 경우 다른 니모닉 문자를 사용할 수 있습니다. 일부 키 단축키(주로 메뉴 바에 있는 것들)는 다른 문맥에서도 적용될 수 있습니다.
Ctrl 키 단축키
Ctrl 키 단축키는 어떤 시각적 제어 요소와도 독립적으로 존재할 수 있습니다. 일반적으로 이 단축키들은 여러 번의 키 입력이나 마우스 클릭이 필요한 메뉴 내의 동작을 호출하거나, 어떤 메뉴나 버튼에도 나타나지 않는 동작을 호출합니다. 예를 들어, ‘ File ’ 메뉴에는 New Ctrl+NFile 메뉴가 닫혀 있는 상태에서도 Ctrl+N을 눌러 호출할 수 있는 항목이 포함될 수 있습니다.
각 Ctrl 키 단축키는 ‘ Strings ’ 보기에 별도의 문자열로 표시됩니다. 예를 들어, Ctrl+Enter와 같습니다. 이 문자열에는 Alt 키 단축키가 나타나는 문구의 맥락과 같이 의미를 부여해 줄 맥락이 없으므로, Ctrl 키 단축키가 수행하는 동작을 설명하는 disambiguation comment 를 개발자가 포함하도록 해야 합니다. 이 주석은 ‘ Source text ’ 필드 아래의 번역 영역에서 ‘ Developer comments ’ 항목 아래에 표시됩니다.
이상적으로는 ‘ Translation ’ > ‘ Copy from source text ’을 선택하여 Ctrl 키 단축키의 번역을 복사할 수 있습니다. 그러나 대상 언어에서 해당 문자가 적합하지 않은 경우 변경하십시오. 어떤 문자(영문자 또는 숫자)를 선택하든, ‘Ctrl+’ 뒤에 대문자 문자를 붙이는 형식을 사용하십시오. Qt는 실행 시 올바른 이름을 자동으로 표시합니다. Alt 키 단축키와 마찬가지로, 문자를 변경할 경우 다른 Ctrl 키 단축키와 충돌하지 않는지 확인하십시오.
참고: 단축키의 Alt, Ctrl 또는 Shift 부분은 번역하지마십시오 . Qt가 이를 인식하여 지원되는 언어에 대해 자동으로 변환합니다.
번호가 매겨진 인자와 복수형 처리
번호가 매겨진 인수는 런타임에 텍스트로 대체될 자리 표시자입니다. 소스 문자열에서는 퍼센트 기호 뒤에 숫자가 오는 형태로 나타납니다. 예를 들어, After processing file %1, file %2 is next in line 문자열에서 %1 및 %2 는 런타임에 첫 번째 및 두 번째 파일 이름으로 대체되는 번호가 매겨진 인수입니다. 번역본에도 동일한 번호가 매겨진 인수가 나타나야 하지만, 반드시 같은 순서일 필요는 없습니다. 이 문자열의 독일어 번역에서는 문구 순서가 반대로 바뀔 수 있습니다. 예를 들어, Datei %2 wird bearbeitet, wenn Datei %1 fertig ist 와 같이 말이죠. 두 번호가 매겨진 인수가 모두 번역본에 나타나지만, 순서는 반대로 됩니다. 번호가 매겨진 인수는 원본 문자열 내 인수 순서와 관계없이 번역본에서는 항상 동일한 텍스트로 대체됩니다.
번호가 매겨진 인수를 사용할 때는 원본 텍스트에서 복수형이 함께 사용되는 경우가 많습니다. 많은 언어에서 텍스트의 형태는 표시되는 값에 따라 달라지므로, 하나 이상의 번역이 필요합니다. 개발자가 원본 텍스트를 올바른 방식으로 마크업했다면, 번역 영역에서 가능한 각 복수형에 해당하는 필드를 사용할 수 있습니다. 자세한 내용은 ‘번역을 위한 소스 코드 작성’을 참조하십시오.
번역에서 숫자 문자 참조(NCR) 처리
'숫자 문자 참조 표시( NCR mode )'를 선택하면 원본 텍스트와 번역 필드 모두에서 숫자 문자 참조의 표시 방식을 전환할 수 있습니다. 이 옵션을 선택하면 텍스트 내 특수 문자가 해당 NCR로 표시됩니다(예: 비분리 공백의 경우   ). 반대로, 이 옵션이 선택되지 않은 경우 문자는 표준 시각적 형태로 표시됩니다. 이 기능은 원본 텍스트와 번역본 모두에서 동일한 특수 문자(이모티콘, 특수 공백 등)를 일관되게 유지하는 데 유용합니다.
대상 로케일 변경
Edit > Translation File Settings 에서 로케일 정보를 명시적으로 설정할 수 있습니다. 번역 원본 파일을 열 때 대상 언어와 국가가 명시적으로 설정되지 않은 경우, Qt Linguist 는 번역 원본 파일 이름에서 이를 추론하려고 시도합니다. 이를 위해서는 번역 파일이 다음 파일 이름 규칙을 준수해야 합니다: appname_language[_country].ts, 여기서:
language는 소문자로 표기된 ISO 639 언어 코드입니다.country는 대문자로 표기된 ISO 3166 두 글자 국가 코드입니다.
대상 언어 및 국가를 파악하는 데 실패하면 ‘ Translation File Settings ’ 창이 열립니다.
예를 들어, app_de.ts 는 대상 언어를 독일어로 설정하고, app_de_CH.ts 는 대상 언어를 독일어로, 대상 국가를 스위스로 설정합니다. 이는 또한 현재 로켈에 대한 번역을 자동으로 불러오는 데 도움이 됩니다. 자세한 내용은 ‘번역 활성화’를 참조하십시오.

© 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.