현지화 및 국제화
Localization (L10N, 현지화) 및 Internationalization (I18N, 국제화)는 "현지화"의 산물로 결합되는 두 가지 개념입니다. 하지만 그 둘은 별개의 것으로, 언리얼 엔진(UE) 에서는 다르게 처리합니다. UE의 현지화 시스템은 "텍스트" 유형을 중심으로 하는 반면, 국제화 지원은 유니코드용 국제 구성요소 (ICU) 라이브러리를 활용합니다.
그 둘은 분리되어 있지만, UE4 에서는 적합한 국제화 지원이 없으면 런타임에 현지화를 사용할 수 없습니다.
ICU 및 현지화 지원
ICU 는 오랜 기간 바탕을 둔 견고한 국제화 라이브러리로, UE에서는 이를 사용하여 문화권(컬처) 관련 데이터의 취급 또는 처리하고 있으며, 여기에는 다음과 같은 사항이 포함됩니다.
-
플랫폼/OS 의 현재 컬처를 구합니다.
-
컬처를 예비 전환하는 우선순위를 처리합니다.
-
올바른 포맷의 (백분율과 통화 포함) 숫자, (시간대 데이터 포함) 날짜와 시간을 처리합니다.
-
컬처에 따른 올바른 숫자 복수 표현을 (텍스트 포매팅 도중) 처리합니다. (역주: 한국어의 경우 종성에 따른 조사를 처리하는 명령도 (hpp) 있습니다.)
-
텍스트의 유니코드 호환 변환을 (예: ToUpper, ToLower) 처리합니다.
-
텍스트의 유니코드 호환 비교와 정렬(collation)을 처리합니다.
-
유니코드 호환 경계 분석 (글자, 단어, 줄바꿈)을 처리합니다.
-
유니코드 호환 양방향 (BiDi) 텍스트 감지를 처리합니다.
ICU 작동을 위해 필요한 컬처 관련 데이터는 ICU 자체 외부에 저장되며, UE는 프로젝트 크기를 최소화하기 위해 대략적인 데이터 세트를 제공합니다.
-
영어 (~1.77MB)
-
EFIGS - 영어, 프랑스어, 이탈리아어, 독일어, 스페인어 (~2.38MB)
-
EFIGSCJK - 영어, 프랑스어, 이탈리아어, 독일어, 스페인어, 중국어, 일본어, 한국어 (~5.99MB)
-
CJK - 중국어, 일본어, 한국어 (~5.16MB)
-
모두 (~15.3MB)
어느 것을 선택할지는 프로젝트를 현지화하려는 지역에 따라 달라지며, 이 선택은 프로젝트 세팅 에서 설정할 수 있습니다. 자세한 정보는 현지화 데이터 패키지 부분을 참고하세요.
컬처
UE의 컬처에는 특정 로케일에 대한 국제화 정보가 들어있습니다. 컬처 이름은 하이픈으로 구분된 세 부분으로 (IETF 언어 태그 로) 구성됩니다.
-
두 글자 ISO 639-1 언어 코드 (예: "zh").
-
옵션 네 글자 ISO 15924 문자 코드 (예: "Hans").
-
옵션 두 글자 ISO 3166-1 국가 코드 (예: "CN").
UE가 특정 컬처에 대한 현지화 데이터를 찾을 때, 가장 구체적인 것에서부터 처리합니다. 예:
-
zh-Hans-CN 의 처리는 "zh-Hans-CN", "zh-CN", "zh-Hans", "zh" 순서입니다.
-
en-GB 의 처리는 "en-GB", "en" 순서입니다.
특정 컬처의 가장 넓은 범위를 커버하려면 가장 구체적이지 않은 유효 컬처 코드를 사용하세요. 보통 언어 코드만 넣으면 되지만, 지역에 따라 언어가 달라질 수 있음에 유의해야 합니다.
대부분의 경우 이런 지역적 변형은 특정 국가 코드에 한정시켜, 해결하기 도록 만듭니다. 하지만 아래와 같이 좀 더 복잡한 경우가 있습니다.
중국어
중국어에는 두 가지 변형이 있는데, 간체(Simplified)와 번체(Traditional), ISO-15924 문자 코드로는 "Hans" 와 "Hant" 로 표시합니다. 간체 현지화에는 "zh-Hans" 를, 번체 현지화에는 "zh-Hant" 를 사용합니다.
스페인어
스페인어는 크게 두 가지, 유럽과 라틴 아메리카 변형이 있습니다. 하지만 그 둘을 편하게 구분할 수 있는 문자 코드가 없습니다. 라틴 아메리카 스페인어에 대한 IETF 언어 태그는 ("es-419") 있지만, 대부분의 플랫폼에 지원되지 않으며, 그 대신 실제 국가 코드를 ("es-MX") 사용합니다.
이를 해결하기 위해, 유럽 스페인어에는 "es", 라틴 아메리카 스페인어에는 "es-419" 를 사용합니다. 그래서 UE의 컬처 리매핑 기능은 라틴 아메리카 스페인어 사용 국가를 "es-419" 로 매핑합니다.
그 방법은 DefaultGame.ini 파일에 다음과 같이 추가하면 됩니다.
[Internationalization]
+CultureMappings="es-AR;es-419"
+CultureMappings="es-BO;es-419"
+CultureMappings="es-CL;es-419"
+CultureMappings="es-CO;es-419"
+CultureMappings="es-CR;es-419"
+CultureMappings="es-CU;es-419"
+CultureMappings="es-DO;es-419"
+CultureMappings="es-EC;es-419"
+CultureMappings="es-GT;es-419"
+CultureMappings="es-HN;es-419"
+CultureMappings="es-MX;es-419"
+CultureMappings="es-NI;es-419"
+CultureMappings="es-PA;es-419"
+CultureMappings="es-PE;es-419"
+CultureMappings="es-PR;es-419"
+CultureMappings="es-PY;es-419"
+CultureMappings="es-SV;es-419"
+CultureMappings="es-US;es-419"
+CultureMappings="es-UY;es-419"
+CultureMappings="es-VE;es-419"
현지화 타깃
Localization Targets (현지화 타깃)은 현지화 데이터의 독립형 모듈입니다. 현지화 타깃에는 다음과 같은 프로퍼티가 있습니다.
-
지정된 소스 세트에서 수집한 텍스트가 있습니다.
-
이 텍스트는 manifest 파일에 저장합니다.
-
그 manifest 의 번역은 컬처 별 archive 파일에 저장합니다.
-
이를 컬처 별 현지화 리소스 (locres) 파일로 컴파일하고, 시스템에서 그 locres 파일을 표시합니다.
프로젝트는 현지화 타깃을 하나만 만들어 단순하게 할 수 있지만, 여러 개로 만들어 프로젝트의 현지화 데이터를 섹션 별로 나눌 수도 있습니다. 언리얼 에디터의 현지화 타깃은 UE 나머지 부분과 분리되어 있어, 게임에 현지화 데이터를 포함시키지 않고 에디러를 현지화할 수 있습니다. 일반적으로 게임은 모든 바탕 프로젝트의 현지화 데이터에 대해 하나의 현지화 타깃이 있고, 확장되는 부분에 대해 추가 현지화 타깃을 만듭니다.
현지화 파이프라인
UE 현지화 파이프라인은 "author-at-source" (소스에 저작) 방식을 따르고 있습니다. 즉 UI 에 "Hello World!" 라는 텍스트가 필요하면, 그냥 텍스트 프로퍼티에 "Hello World!" 를 입력( 또는 C++ 의 LOCTEXT 매크로 또는 NSLOCTEXT 를 사용)하면, 현지화 수집 툴(gatherer)이 그 텍스트를 현지화할 수 있도록 갈무리합니다.
"소스에 저작" 방식은 매우 동적이라, 개발 도중 현지화 관련해서 개발자가 별로 생각할 부분이 없습니다. 하지만 프로젝트에 사용할 텍스트를 엄격히 제어하려는 팀에게는 오히려 안좋을 수도 있습니다. 이를 해결하기 위해 UE에서는 스트링 테이블 을 지원하여 "author-once-and-reference" (한 번 저작 후 참조) 현지화 방식을 사용할 수 있습니다 (내부적으로, 파이프라인은 그 스트링 테이블 자체를 또다른 "소스에 저작" 소스로 취급하기는 합니다).
네이티브 스트링 테이블이 없던 시절 이전 (더이상 지원되지 않는) 우회법은 "가짜" 네이티브 컬처(, "es-US-POSIX" 같은 것)에 ID 를 소스 텍스트로 붙인 다음, UE 4.14 이전에 있던 스트링 축소(collapse) 함수를 사용하여 이 ID 를 각 언어로 변환했었습니다. 이 방법에 대한 참고자료는 이전 기술지원 질문에서 찾을 수는 있지만, 더이상 사용되지 않습니다. 그 방법을 사용하는 프로젝트는 스트링 테이블로 이주해야 합니다.
현지화 파이프라인 자체는 현지화 타깃에서 작동하며, 현지화 타깃은 두 부분으로 이루어집니다. (Config/Localization/ 에 저장되는) 환경설정과 (Content/Localization/{TargetName}/ 에 저장되는) 그 데이터입니다.
현지화 타깃이 영어("en")와 프랑스어("fr")라 가정하면, Content/Localization/ 폴더의 레이아웃은 다음과 같습니다.
{TargetName}/
{TargetName}.manifest
{TargetName}.locmeta
en/
{TargetName}.archive
{TargetName}.po
{TargetName}.locres
fr/
{TargetName}.archive
{TargetName}.po
{TargetName}.locres
위의 모든 파일과 폴더는 현지화 파이프라인의 다양한 부분에서 생성됩니다.
| 폴더 | 설명 |
|---|---|
| {TargetName}.manifest |
|
| {TargetName}.archive |
|
| {TargetName}.po |
|
| {TargetName}.locres |
|
| {TargetName}.locmeta |
|
현지화 타깃은 "네이티브" 컬처를 지정할 수도 있으며, 콘텐츠를 저작하는 컬처로 설정해야 합니다 (일반적으로 "source text" (소스 텍스트) 또는 "source data" (소스 데이터)라 합니다).
네이티브 컬처에는 다른 컬처처럼 "translations" (번역)이 있을 수 있지만, 소스 코드나 에셋을 직접 수정하지 않고도 소스 텍스트를 복사 편집하기 쉽게 하기 위한 것입니다.
외국 컬처는 네이티브 컬처를 번역의 소스 텍스트로 사용하며, 네이티브 컬처 텍스트가 변경되면 "stale" (구버전) 상태가 됩니다 (현지화 컴파일 단계에서 구버전 번역이 필요하면 놔두는 옵션이 있습니다).
현지화 파이프라인 최적화 관련 자세한 정보는 파이프라인 최적화 문서를 참고하세요.
PO 파일 포맷
언리얼은 PO 익스포트에 사용되는 접기 모드에 따라 PO 파일에 다음과 같은 기본 포맷을 사용합니다.
- 동일한 텍스트 ID 및 소스 텍스트(Identical Text Identity and Source Text) 접기 모드를 사용할 때:
msgctxt는 항목의 언리얼 아이덴티티를 포함합니다.msgid는 소스 스트링을 포함합니다.msgstr은 번역문을 포함합니다.
- 동일한 네임스페이스 및 소스 텍스트(Identical Namespace and Source Text) 접기 모드를 사용할 때:
msgctxt는 항목의 언리얼 아이덴티티를 포함합니다.msgid는 소스 스트링을 포함합니다.msgstr은 번역문을 포함합니다.
Crowdin을 사용하여 번역을 관리하는 경우 더 나은 결과를 얻을 수 있는 대체 형식도 있지만, 이 형식은 PO 파일에서 임포트한 오래된 번역은 감지할 수 없다는 점에 유의하시기 바랍니다(번역이 이루어진 소스가 더 이상 없음).
This mode produces the same output when using the Identical Namespace and Source Text collapse mode, but for the Identical Text Identity and Source Text collapse mode it produces the following: 이 모드는 동일한 네임스페이스 및 소스 텍스트 접기 모드를 사용할 때와 동일한 출력을 생성하지만, 동일 텍스트 ID 및 소스 텍스트 접기 모드의 경우 다음과 같은 출력을 생성합니다:
msgctxt는 사용되지 않습니다.msgid는 항목의 언리얼 아이덴티티를 포함합니다.msgstr은 소스 스트링(현지 컬처) 또는 번역문(외국 컬처)을 포함합니다.X-Crowdin-SourceKey헤더 어트리뷰트는msgstr이 현지 컬처의 소스 텍스트로 사용되고 있음을 명시합니다.
현지화 데이터 패키지
프로젝트의 현지화 및 국제화 데이터를 올바르게 패키지하기 위해서는 프로젝트 세팅의 고급 패키지 섹션 아래 일부 세팅을 조정해야 합니다.
확인해야 하는 세팅은 두 가지입니다.
-
Localizations to Package 패키지할 현지화 - 현지화 데이터를 스테이지할 컬처를 선택할 수 있습니다. Show Localized (현지화만 표시) 옵션으로 목록에 필터를 적용하면
LocRes파일이 있는 대상만 표시합니다. -
Internationalization Support 국제화 지원 - 어느 ICU 국제화 데이터 세트를 스테이지할 지 선택할 수 있습니다. 이 옵션은 스테이지하려는 현지화 데이터와 겹쳐야 합니다.