Update ko localization guide

Update ko localization guide-rev1
This commit is contained in:
seokho-son 2020-06-08 15:05:50 +09:00
parent 87cb0c3c82
commit f3549c1458
1 changed files with 59 additions and 11 deletions

View File

@ -87,22 +87,39 @@ weight: 10
기존에 번역된 문서를 참고한다.
{{% note %}}
한영 병기는 페이지 내에서 해당 용어가 처음 사용되는 경우에만 적용하고 이후 부터는 한글만 표기한다.
한영 병기는 페이지 내에서 해당 용어가 처음 사용되는 경우에만 1회 적용하고 이후에는 한글만 표기한다.
한영 병기의 대상에는 제목도 포함되므로 제목에 한영 병기가 제공된 경우, 문서 내부에는
한글만 표기한다.
{{% /note %}}
### API 오브젝트 용어 한글화 관련 방침
### API 오브젝트 용어 한글화 방침
API 오브젝트는 외래어 표기법에 따라 한글 표기한다.
쿠버네티스 API 오브젝트는 원 단어를
API 오브젝트 중 `kubectl api-resources` 결과의 `kind`에 해당하는 오브젝트는
[국립국어원 외래어 표기법](http://kornorms.korean.go.kr/regltn/regltnView.do?regltn_code=0003#a)에
따라 한글 한다. 예를 들면 다음과 같다.
따라 한글 표기한다. 예를 들면 다음과 같다.
원 단어 | 외래어 표기
--- | ---
Deployment | 디플로이먼트
Pod | 파드
Service | 서비스
API 오브젝트(kind) | 한글화(외래어 표기)
--- | ---
ClusterRoleBinding | 클러스터롤바인딩
ConfigMap | 컨피그맵
Deployment | 디플로이먼트
Pod | 파드
PersistentVolumeClaim | 퍼시스턴트볼륨클레임
Service | 서비스
... | ...
그 이외의 API 오브젝트는, [한글화 용어집](#한글화-용어집)에 등록된 용어인 경우를 제외하고,
모두 원문 그대로 표기한다. 예를 들면 다음과 같다.
API 오브젝트(kind가 아닌 경우) | 한글화(원문 유지)
--- | ---
ClusterRoleBindingList | ClusterRoleBindingList
ClusterRoleList | ClusterRoleList
ConfigMapEnvSource | ConfigMapEnvSource
ConfigMapKeySelector | ConfigMapKeySelector
PersistentVolumeClaimList | PersistentVolumeClaimList
PersistentVolumeClaimSpec | PersistentVolumeClaimSpec
... | ...
{{% note %}}
단, API 오브젝트 한글화 원칙에 예외가 있을 수 있으며, 이 경우에는 가능한
@ -110,12 +127,43 @@ Service | 서비스
는 API 오브젝트에 대해 외래어 표기법 적용하지 않고 원문 그대로 표기한다.)
{{% /note %}}
{{% note %}}
원문에서는 API 오브젝트를 camelCase(예: configMap)로 표기하는 것을 가이드하고 있다.
그러나 한글에는 대소문자 구분이 없으므로 이를 띄어쓰기 없이 붙여서 처리한다.
(예: configMap -> 컨피그맵, config Map -> 컨피그맵)
{{% /note %}}
{{% note %}}
API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독자가 구성 파일이나
커맨드라인에서 그대로 사용할 가능성이 높으므로 한글로 옮기지 않고 원문을 유지한다.
단, 주석에 포함된 내용은 한글로 옮길 수 있다.
{{% /note %}}
### 기능 게이트(feature gate) 한글화 방침
쿠버네티스의 [기능 게이트](/docs/reference/command-line-tools-reference/feature-gates/)를
의미하는 용어는 한글화하지 않고 원문 형태를 유지한다.
기능 게이트의 예시는 다음과 같다.
- Accelerators
- AdvancedAuditing
- AffinityInAnnotations
- AllowExtTrafficLocalEndpoints
- ...
전체 기능 게이트 목록은
[여기](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates)를 참고한다.
{{% note %}}
단, 해당 원칙에는 예외가 있을 수 있으며, 이 경우에는 가능한
[한글화 용어집](#한글화-용어집)을 준용한다.
{{% /note %}}
{{% note %}}
기능 게이트는 쿠버네티스 버전에 따라 변경될 수 있으므로,
쿠버네티스 및 쿠버네티스 문서의 버전에 맞는 기능 게이트 목록을 적용하여 한글화를 진행한다.
{{% /note %}}
### 한글화 용어집 정보
쿠버네티스 [한글화 용어집](#한글화-용어집)은 한글화된 쿠버네티스 문서의 일관성을 위해서