UnrealEngineUWP/Engine/Documentation/Source/Gameplay/Localization/Commandlets/Commandlets.KOR.udn

INTSourceChangelist:2343745
Availability:Public
Title: 커맨드렛
Crumbs:%ROOT%, Gameplay, Gameplay/Localization
Description:프로젝트 현지화시 사용되는 커맨드렛과 그 인수에 대한 설명입니다.


[TOC (start:2)]

## GatherText
다른 현지화 커맨드렛의 환경설정 및 실행을 위해 실행해야 하는 마스터 커맨드렛입니다. 인수는 `Config` 하나만 받으며, 실행할 커맨드렛과 그 [환경설정](Gameplay/Localization/Setup) 이 나열된 INI 포맷 파일 경로를 지정합니다.
커맨드렛은 지정된 파일을 읽고, 0 부터 시작되는 인덱스 수치 접미사가 붙는 `GatherTextStep` 라는 이름의 섹션을 찾습니다. 각 단계는 실행할 커맨드렛 이름을 나타내는 `CommandletClass` 키에 대한 값을 제공합니다. 
커맨드렛에 대한 부가 환경설정은 `CommonSettings` 섹션에 제공할 수 있습니다.

모든 경로는 다른 식으로 지정하지 않는 한 프로젝트의 루트 디렉토리에 상대적으로 제공해 줘야 합니다.

다른 모든 커맨드렛은 `Config` 과 `Section` 명령줄 파라미터를 받아, 지정된 INI 파일의 지정된 섹션과 `CommonSettings` 섹션에서 읽어올 수 있도록 합니다.


## 수집용

### GatherTextFromSource

이 커맨드렛은 지정된 필터를 통과한 디렉토리를 탐색한 뒤, 일치하는 파일에서 LOCTEXT_NAMESPACE, LOCTEXT, NSLOCTEXT 및 기타 현지화와 특수한 연관성이 있는 매크로같은 마크업을 파싱한 다음, 
그 텍스트를 처리용으로 수집합니다.

| 세팅 | 설명 |
| --------| ------------| 
| ManifestDependencies | 지정된 manifest 에서 찾은 텍스트는 수집하지 않습니다. |
| IncludePaths | 탐색 대상 경로입니다. |
| ExcludePaths | 이 패턴에 일치하는 경로는 탐색에서 제외됩니다. |
| SourceFileSearchFilters | 이 필터에 일치하는 파일을 파싱합니다. |

### GatherTextFromAssets

지정된 필터를 통과한 디렉토리를 탐색하여 찾은 패키지를 로드하고 반복처리하여 처리할 텍스트를 수집하는 커맨드렛입니다.
| 세팅 | 설명 |
| --------| ------------| 
|ManifestDependencies | 지정된 manifest 에서 찾은 텍스트는 수집하지 않습니다.|
|ModulesToPreload | 로드된 패키지를 대상으로 반복처리하기 전 로드해야 하는 모듈 이름입니다. 발견된 패키지가 로드되지 않은 모듈에 의존할 경우 사용해야 합니다.|
| IncludePaths | 탐색 대상 경로입니다. |
| ExcludePaths | 이 패턴에 일치하는 경로는 탐색에서 제외됩니다. |
|PackageExtensions  | 이 확장자의 패키지는 반복처리 대상이 됩니다. |
|ExcludeClasses | 패키지 내 이 클래스의 오브젝트는 수집을 위한 검사를 하지 않습니다.|
|bFixBroken | 애셋 내 텍스트에 키가 없거나 다른 텍스트와 충돌을 일으키는 경우를 수리합니다. |

### GatherTextFromMetadata

필터를 통과하는 디렉토리를 탐색하여, 클래스가 그 디렉토리에서 오는 오브젝트의 메타데이터를 대상으로 반복처리하여, 지정된 메타데이터 키에 대한 메타데이터 값에서 텍스트를 생성하는 커맨드렛입니다. 
어떤 메타데이터를 읽을지, 생성된 텍스트의 네임스페이스와 키는 어찌해야할지 지정하는 데는 세팅을 사용해야 합니다. 키는 다음과 같은 인수를 사용할 수 있습니다:

| 인수 | 설명 |
| --------| ------------| 
|FieldPath | 이 메타데이터를 구해올 자격이 되는 오브젝트 경로입니다.
|MetaDataValue | 메타데이터 키의 스트링 값입니다.

| 세팅 | 설명 |
| --------| ------------| 
|ManifestDependencies | 지정된 manifest 에서 찾은 텍스트는 수집하지 않습니다.|
|ModulesToPreload | 로드된 패키지를 대상으로 반복처리하기 전 로드해야 하는 모듈 이름입니다. 발견된 패키지가 로드되지 않은 모듈에 의존할 경우 사용해야 합니다.|
| IncludePaths | 탐색 대상 경로입니다. |
| ExcludePaths | 이 패턴에 일치하는 경로는 탐색에서 제외됩니다. |
|InputKeys | 텍스트 생성용으로 사용할 메타데이터 키입니다.|
|OutputNamespaces | 생성된 텍스트에 사용할 네임스페이스입니다.|
|OutputKeys | 생성되는 텍스트 키의 포맷 및 사용에 쓰이는 패턴 스트링입니다. |


## 생성용
### GenerateGatherManifest

지금까지 다른 수집 커맨드렛으로 수집된 데이터를 사용하여 지정된 디렉토리에 지정된 이름의 manifest 파일을 작성하는 커맨드렛입니다.

| 세팅 | 설명 |
| --------| ------------|
| ManifestDependencies | 지정된 manifest 에서 찾은 텍스트는 새로운 manifest 에 쓰지 않습니다.|
|DestinationPath | manifest 파일을 작성할 디렉토리 경로입니다.|
|ManifestName | 작성할 manifest 파일의 전체 이름이며, 전형적으로 타겟과 같은 이름에 확장자는 "manifest" 입니다.|

### GenerateGatherArchive

지정된 manifest 를 사용하여 지정된 디렉토리 아래 지정된 컬처 이름으로 된 서브 디렉토리에다 지정된 이름의 archive 파일을 작성하는 커맨드렛입니다. 아카이브가 이미 존재하면 업데이트시킵니다.

| 세팅 | 설명 |
| --------| ------------|
|DestinationPath | manifest 와 작성할 archive 에 대한 컬처 서브디렉토리가 들어있는 디렉토리 경로입니다.|
|ManifestName | 읽어올 manifest 파일의 전체 이름이며, 전형적으로 타겟과 같은 이름에 확장자는 "manifest" 입니다.|
|ArchiveName | 작성할 archive 파일의 전체 이름이며, 전형적으로 타겟과 같은 이름에 확장자는 "archive" 입니다.|
|SourceCulture | 네이티브 소스 텍스트가 속하는 컬처 이름입니다. 이 컬처에 대한 archive 에는 단순히 그 소스 스트링이 번역 스트링으로 포함됩니다. |
|CulturesToGenerate | 토막 archive 를 생성할 컬처 이름입니다. |
|bPurgeOldEmptyEntries | _true_ 면 기존 archive 파일 내 번역이 없는 항목은 archive 업데이트 전 제거하고 manifest 에서 새 항목으로 업데이트합니다. manifest 에 더이상 존재하지 않고 번역되어있지 않은 항목은 사라집니다. |


### GenerateTextLocalizationResource

지정된 manift 파일과 발견된 모든 archive 파일을 사용하여 지정된 디렉토리의 지정된 컬처 이름으로 된 서브디렉토리에 지정된 이름의 LocRes 파일을 작성하는 커맨드렛입니다.

| 세팅 | 설명 |
| --------| ------------|
|SourcePath | 작성하려는 archive 에 대한 manifest 와 컬처 서브디렉토리가 들어있는 디렉토리 경로입니다. |
|ManifestName | 읽어올 manifest 파일 전체 이름이며, 전형적으로 타겟과 같은 이름에 확장자는 "manifest" 입니다.|
|CulturesToGenerate | LocRes 파일을 생성할 컬처 이름입니다.|
|DestinationPath | 작성하려는 LocRes 파일에 대한 컬처 서브디렉토리가 들어있는 디렉토리 경로입니다. |
|ResourceName | 작성하려는 LocRes 파일의 전체 이름이며, 전형적으로 타겟과 같은 이름에 확장자는 "locres" 입니다. |

## 유지관리용
### RepairLocalizationData

각기 다른 버전의 현지화 데이터를 수리하고 업데이트하는 커맨드렛입니다. manifest 와 archive 를 배타적으로 수리합니다. LocRes 파일은 평소처럼 수리/업데이트된 manifest 와 archive 에서 재생성 가능합니다.

| 세팅 | 설명 |
| --------| ------------|
|DestinationPath  | manifest 및 읽고 쓰려는 archive 가 들어있는 컬처 서브디렉토리가 들어있는 디렉토리 경로입니다. |
|ManifestName | 읽고 쓸 manifest 파일 전체 이름이며, 보통 타겟과 같은 이름에 확장자는 "manifest" 입니다. |
|ArchiveName | 읽고 쓸 archive 파일 전체 이름이며, 보통 타겟과 같은 이름에 확장자는 "archive" 입니다. |
|CulturesToGenerate | 수리/업데이트할 archive 에 대한 컬처 이름입니다. |

### GenerateTextLocalizationReport

단어 수와 텍스트 충돌과 같은 리포트를 생성하고 업데이트하는 커맨드렛입니다.

| 세팅 | 설명 |
| --------| ------------|
|DestinationPath | 리포트를 작성할 디렉토리 경로입니다. |
|bWordCountReport | _true_ 면, 단어 수 리포트가 생성됩니다. |
|SourcePath | manifest 와 읽으려는 archive 에 대한 컬처 서브디렉토리가 들어있는 디렉토리 경로입니다. |
|ManifestName | 읽어올 manifest 파일 전체 이름이며, 보통 타겟과 같은 이름에 확장자는 "manifest" 입니다.|
|CulturesToGenerate | 읽어오려는 archive 에 대한 컬처 이름입니다.|
|WordCountReportName | 읽고 쓸 CSV (쉼표 구분 값) 파일에 대한 전체 이름으로, 시간에 따른 각 컬처에 대한 단어 수 표가 들어있습니다.|
|bConflictReport | _true_ 면, 충돌 보고서가 생성됩니다.|
|ConflictReportName | 작성할 텍스트 파일 전체 이름으로, 충돌하는 네임스페이스/키/텍스트 항목이 전부 들어있는 목록입니다. |