Update Korean localization guide (#19004)
rev1-Update Korean localization guide
This commit is contained in:
Seokho Son
GitHub
parent
e80f1f7da8
commit
35017d3bce
|
|
@ -12,23 +12,23 @@ content_template: templates/concept
|
|||
|
||||
{{% capture body %}}
|
||||
|
||||
## 문체
|
||||
## 문체 가이드
|
||||
|
||||
### 높임말
|
||||
|
||||
평어체 사용을 원칙으로 하나, 일부 페이지(예: [https://kubernetes.io/ko](https://kubernetes.io/ko))에 한해 예외적으로
|
||||
평어체 사용을 원칙으로 하나, 일부 페이지(예: [https://kubernetes.io/ko](https://kubernetes.io/ko))에 한해 예외적으로
|
||||
높임말을 사용한다.
|
||||
|
||||
### 명령형
|
||||
|
||||
어떤 일을 하도록 청자에게 요구하는 명령형 표현은 간결하고 부드러운 표현으로 정확한 의미를 전달하기 위해
|
||||
어떤 일을 하도록 청자에게 요구하는 명령형 표현은 간결하고 부드러운 표현으로 정확한 의미를 전달하기 위해
|
||||
어떤 일을 함께 하기를 요청하는 청유형 또는 객관적으로 진술하는 평어체로 번역한다.
|
||||
|
||||
명령형 문장 | 번역체
|
||||
--- | ---
|
||||
사이트를 방문하라 | 사이트를 방문하자 (청유형)
|
||||
가이드를 참고하라 | 가이드를 참고한다 (평어체)
|
||||
|
||||
|
||||
|
||||
### 번역체 지양
|
||||
|
||||
|
|
@ -42,9 +42,40 @@ content_template: templates/concept
|
|||
접시를 씻고 | 설거지를 하고
|
||||
가게에 배들, 사과들, 복숭아들이 있다 (과다한 복수형) | 가게에 배, 사과, 복숭아들이 있다
|
||||
|
||||
### 한글과 영어 혼용에 관련한 원칙
|
||||
## 문서 코딩 가이드
|
||||
|
||||
한글과 영어 단어 중 선택은 다음의 우선 순위를 따르나, 자연스럽지 않은 용어를 무리하게 선택하지는 않는다.
|
||||
### 가로폭은 원문을 따름
|
||||
|
||||
유지보수의 편의를 위해서 원문의 가로폭을 따른다.
|
||||
|
||||
즉, 원문이 한 문단을 줄바꿈하지 않고 한 행에 길게 기술했다면 한글화 시에도 한 행에 길게 기술하고, 원문이 한 문단을
|
||||
줄바꿈해서 여러 행으로 기술한 경우에는 한글화 시에도 가로폭을 원문과 비슷하게 유지한다.
|
||||
|
||||
### 리뷰어 삭제
|
||||
|
||||
때때로 원문의 코드 상단에 리뷰어가 명시되어 있는 경우가 있다. 일반적으로 원문 페이지의 리뷰어가 한글화 된 페이지를 리뷰하기 어려우므로 리소스 메타데이터에서 리뷰어 관련 코드를
|
||||
삭제한다.
|
||||
|
||||
아래는 리뷰어 관련 코드를 삭제하는 예시를 보여준다.
|
||||
|
||||
```diff
|
||||
- reviews:
|
||||
- - reviewer1
|
||||
- - reviewer
|
||||
- title: Kubernetes Components
|
||||
+
|
||||
+
|
||||
+
|
||||
+ title: 쿠버네티스 컴포넌트
|
||||
content_template: templates/concept
|
||||
weight: 10
|
||||
```
|
||||
|
||||
## 용어 한글화 가이드
|
||||
|
||||
### 용어 한글화의 일반적 방침
|
||||
|
||||
영문 용어를 한글화할 때는 다음의 우선 순위를 따르나, 자연스럽지 않은 용어를 무리하게 선택하지는 않는다.
|
||||
|
||||
* 한글 단어
|
||||
* 순 우리말 단어
|
||||
|
|
@ -52,13 +83,16 @@ content_template: templates/concept
|
|||
* 한영 병기 (예: 훅(hook))
|
||||
* 영어 단어 (예: Kubelet)
|
||||
|
||||
단, 자연스러움을 판단하는 기준은 주관적이므로 다음의 [용어집](#용어집)과 기존에 번역된 문서를 참고한다.
|
||||
단, 자연스러움을 판단하는 기준은 주관적이므로 [한글화 용어집](#한글화-용어집)을 준용하고
|
||||
기존에 번역된 문서를 참고한다.
|
||||
|
||||
{{% note %}}
|
||||
한영 병기는 페이지 내에서 해당 용어가 처음 사용되는 경우에만 적용하고 이후 부터는 한글만 표기한다.
|
||||
{{% /note %}}
|
||||
|
||||
#### API 오브젝트는 외래어 표기법에 따라 한글 표기
|
||||
### API 오브젝트 용어 한글화 관련 방침
|
||||
|
||||
API 오브젝트는 외래어 표기법에 따라 한글 표기한다.
|
||||
|
||||
쿠버네티스 API 오브젝트는 원 단어를
|
||||
[국립국어원 외래어 표기법](http://kornorms.korean.go.kr/regltn/regltnView.do?regltn_code=0003#a)에
|
||||
|
|
@ -70,125 +104,131 @@ Deployment | 디플로이먼트
|
|||
Pod | 파드
|
||||
Service | 서비스
|
||||
|
||||
{{% note %}}
|
||||
단, API 오브젝트 한글화 원칙에 예외가 있을 수 있으며, 이 경우에는 가능한
|
||||
[한글화 용어집](#한글화-용어집)을 준용한다. (예를 들면, Horizontal Pod Autoscaler
|
||||
는 API 오브젝트에 대해 외래어 표기법 적용하지 않고 원문 그대로 표기한다.)
|
||||
{{% /note %}}
|
||||
|
||||
{{% note %}}
|
||||
API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독자가 구성 파일이나
|
||||
커맨드라인에서 그대로 사용할 가능성이 높으므로 한글로 옮기지 않고 원문을 유지한다.
|
||||
단, 주석에 포함된 내용은 한글로 옮길 수 있다.
|
||||
{{% /note %}}
|
||||
|
||||
## 문서 코딩 가이드
|
||||
### 한글화 용어집 정보
|
||||
|
||||
### 가로폭은 원문을 따름
|
||||
쿠버네티스 [한글화 용어집](#한글화-용어집)은 한글화된 쿠버네티스 문서의 일관성을 위해서
|
||||
각 영문 용어에 대한 한글화 방법을 제시한다.
|
||||
한글화 용어집에 포함된 용어는 쿠버네티스 문서 한글화팀 회의를 통해 결정되었으며,
|
||||
본 문서에 대한 ISSUE 및 PR을 통해서 개선한다.
|
||||
|
||||
유지보수의 편의를 위해서 원문의 가로폭을 따른다.
|
||||
#### 한글화 용어집 개선 가이드
|
||||
|
||||
즉, 원문이 한 문단을 줄바꿈하지 않고 한 행에 길게 기술했다면 한글화 시에도 한 행에 길게 기술하고, 원문이 한 문단을
|
||||
줄바꿈해서 여러 행으로 기술한 경우에는 한글화 시에도 가로폭을 원문과 비슷하게 유지한다.
|
||||
한글화 용어집의 개선(추가, 수정, 삭제 등)을 위한 과정은 다음과 같다.
|
||||
|
||||
### 리뷰어 삭제
|
||||
1. 컨트리뷰터가 개선이 필요한 용어을 파악하면, ISSUE를 생성하여 개선 필요성을 공유하거나 `master` 브랜치에
|
||||
PR을 생성하여 개선된 용어를 제안한다.
|
||||
|
||||
일반적으로 원문 페이지의 리뷰어가 한글 페이지를 리뷰하기 어려우므로 다음과 같이 리소스 메타데이터에서 리뷰어를
|
||||
삭제한다.
|
||||
1. 개선 제안에 대한 논의는 ISSUE 및 PR을 통해서 이루어지며, 한글화팀 회의를 통해 확정한다.
|
||||
|
||||
```diff
|
||||
- reviews:
|
||||
- - reviewer1
|
||||
- - reviewer2
|
||||
- title: Kubernetes Components
|
||||
+ title: 쿠버네티스 컴포넌트
|
||||
content_template: templates/concept
|
||||
weight: 10
|
||||
```
|
||||
1. 리뷰어 및 승인자는 작업 중인 한글화 작업 브랜치(예: dev-1.17-ko.3)에 영향을 최소화 하기 위해서,
|
||||
신규 한글화 작업 브랜치(예: dev-1.17-ko.4) 생성 시점에 맞춰 확정된 PR을 승인한다.
|
||||
개선된 한글화 용어집은 신규 한글화 작업 브랜치부터 적용한다.
|
||||
|
||||
1. 개선된 한글화 용어집에 따라 기존의 한글 문서에 대한 업데이트가 필요하며,
|
||||
컨트리뷰션을 통해서 업데이트를 진행한다.
|
||||
|
||||
#### 한글화 용어집
|
||||
|
||||
## 용어집
|
||||
|
||||
English | 한글 | 비고
|
||||
--- | --- | ---
|
||||
Access | 접근 |
|
||||
Active | Active | 잡의 상태
|
||||
Active Job | 액티브 잡 |
|
||||
Addons | 애드온 |
|
||||
admission controller | 어드미션 컨트롤러 |
|
||||
Age | 기간 |
|
||||
Allocation | 할당량
|
||||
Annotation | 어노테이션 |
|
||||
App | 앱 |
|
||||
Appendix | 부록 |
|
||||
Application | 애플리케이션 |
|
||||
Access | 접근 |
|
||||
Active | Active | 잡의 상태
|
||||
Active Job | 액티브 잡 |
|
||||
Addons | 애드온 |
|
||||
admission controller | 어드미션 컨트롤러 |
|
||||
Age | 기간 |
|
||||
Allocation | 할당량
|
||||
Annotation | 어노테이션 |
|
||||
App | 앱 |
|
||||
Appendix | 부록 |
|
||||
Application | 애플리케이션 |
|
||||
Args | Args | 약어의 형태이므로 한글화하지 않고 영문 표기
|
||||
array | 배열 |
|
||||
array | 배열 |
|
||||
autoscaler | 오토스케일러
|
||||
availability zone | 가용성 영역(availability zone) |
|
||||
bare pod | 베어(bare) 파드 |
|
||||
bare pod | 베어(bare) 파드 |
|
||||
beta | 베타 |
|
||||
boilerplate | 상용구 |
|
||||
Boot | 부트 |
|
||||
boilerplate | 상용구 |
|
||||
Boot | 부트 |
|
||||
Build | 빌드 |
|
||||
Cache | 캐시 |
|
||||
Cache | 캐시 |
|
||||
canary | 카나리(canary) | 릴리스 방식에 관련한 용어인 경우에 한함
|
||||
cascading | 캐스케이딩(cascading) |
|
||||
character set | 캐릭터 셋 |
|
||||
Charts | 차트 |
|
||||
checkpoint | 체크포인트 |
|
||||
CLI | CLI |
|
||||
Cluster | 클러스터 |
|
||||
CLI | CLI |
|
||||
Cluster | 클러스터 |
|
||||
Command Line Tool | 커맨드라인 툴 |
|
||||
Config Map | 컨피그 맵 |
|
||||
Config Map | 컨피그 맵 |
|
||||
configuration | 구성, 설정 |
|
||||
Connection | 연결 |
|
||||
Connection | 연결 |
|
||||
containerized | 컨테이너화 된 |
|
||||
Context | 컨텍스트 |
|
||||
Control Plane | 컨트롤 플레인 |
|
||||
Context | 컨텍스트 |
|
||||
Control Plane | 컨트롤 플레인 |
|
||||
controller | 컨트롤러 |
|
||||
Cron Job | 크론 잡 |
|
||||
custom metrics | 사용자 정의 메트릭 |
|
||||
Cron Job | 크론 잡 |
|
||||
custom metrics | 사용자 정의 메트릭 |
|
||||
Custom resource | 사용자 정의 리소스 |
|
||||
CustomResourceDefinition | 커스텀 리소스 데피니션 |
|
||||
CustomResourceDefinition | 커스텀 리소스 데피니션 |
|
||||
Daemon | 데몬 |
|
||||
Daemon Set | 데몬 셋 |
|
||||
Dashboard | 대시보드 |
|
||||
Data Plane | 데이터 플레인 |
|
||||
Default Limit | 기본 상한 |
|
||||
Default Request | 기본 요청량 |
|
||||
Deployment | 디플로이먼트 |
|
||||
Dashboard | 대시보드 |
|
||||
Data Plane | 데이터 플레인 |
|
||||
Default Limit | 기본 상한 |
|
||||
Default Request | 기본 요청량 |
|
||||
Deployment | 디플로이먼트 |
|
||||
deprecated | 사용 중단(deprecated) |
|
||||
descriptor | 디스크립터, 식별자 |
|
||||
Desired number of pods | 의도한 파드의 수 |
|
||||
Desired State | 의도한 상태 |
|
||||
disruption | 중단(disruption) |
|
||||
Desired number of pods | 의도한 파드의 수 |
|
||||
Desired State | 의도한 상태 |
|
||||
disruption | 중단(disruption) |
|
||||
distros | 배포판 |
|
||||
Docker | 도커 |
|
||||
Dockerfile | Dockerfile |
|
||||
Dockerfile | Dockerfile |
|
||||
Downward API | 다운워드(Downward) API |
|
||||
Endpoint | 엔드포인트 |
|
||||
entry point | 진입점 |
|
||||
Event | 이벤트 |
|
||||
entry point | 진입점 |
|
||||
Event | 이벤트 |
|
||||
Exec | Exec |
|
||||
expose | 노출시키다 |
|
||||
extension | 익스텐션(extension) |
|
||||
Failed | Failed | 파드의 상태에 한함
|
||||
Failed | Failed | 파드의 상태에 한함
|
||||
Federation | 페더레이션 |
|
||||
field | 필드 |
|
||||
field | 필드 |
|
||||
Flannel | Flannel |
|
||||
form | 형식 |
|
||||
Google Compute Engine | Google Compute Engine |
|
||||
Google Compute Engine | Google Compute Engine |
|
||||
hash | 해시 |
|
||||
headless | 헤드리스 |
|
||||
health check | 헬스 체크 |
|
||||
Heapster | 힙스터(Heapster) |
|
||||
Heartbeat | 하트비트 |
|
||||
Homebrew | Homebrew |
|
||||
hook | 훅(hook) |
|
||||
Homebrew | Homebrew |
|
||||
hook | 훅(hook) |
|
||||
Horizontal Pod Autoscaler | Horizontal Pod Autoscaler | 예외적으로 API 오브젝트에 대해 외래어 표기법 적용하지 않고 원문 그대로 표기
|
||||
hosted zone | 호스팅 영역 |
|
||||
hosted zone | 호스팅 영역 |
|
||||
hostname | 호스트네임 |
|
||||
Huge page | Huge page |
|
||||
Hypervisor | 하이퍼바이저 |
|
||||
idempotent | 멱등성 |
|
||||
Image | 이미지 |
|
||||
Image Pull Secrets | 이미지 풀(Pull) 시크릿 |
|
||||
Ingress | 인그레스 |
|
||||
Init Container | 초기화 컨테이너 |
|
||||
Image | 이미지 |
|
||||
Image Pull Secrets | 이미지 풀(Pull) 시크릿 |
|
||||
Ingress | 인그레스 |
|
||||
Init Container | 초기화 컨테이너 |
|
||||
Instance group | 인스턴스 그룹 |
|
||||
introspection | 인트로스펙션(introspection) |
|
||||
Istio | 이스티오(Istio) |
|
||||
|
|
@ -196,112 +236,111 @@ Job | 잡 |
|
|||
kube-proxy | kube-proxy |
|
||||
Kubelet | Kubelet |
|
||||
Kubernetes | 쿠버네티스 |
|
||||
label | 레이블 |
|
||||
label | 레이블 |
|
||||
lifecycle | 라이프사이클 |
|
||||
Linux | 리눅스 |
|
||||
load | 부하 |
|
||||
Log | 로그 |
|
||||
Lost | Lost | 클레임의 상태에 한함
|
||||
Machine | 머신 |
|
||||
manifest | 매니페스트 |
|
||||
Master | 마스터 |
|
||||
max limit/request ratio | 최대 상한/요청량 비율 |
|
||||
Linux | 리눅스 |
|
||||
load | 부하 |
|
||||
Log | 로그 |
|
||||
Lost | Lost | 클레임의 상태에 한함
|
||||
Machine | 머신 |
|
||||
manifest | 매니페스트 |
|
||||
Master | 마스터 |
|
||||
max limit/request ratio | 최대 상한/요청량 비율 |
|
||||
metadata | 메타데이터 |
|
||||
metric | 메트릭 |
|
||||
Minikube | Minikube |
|
||||
Minikube | Minikube |
|
||||
Mirror pod | 미러 파드(mirror pod) |
|
||||
monitoring | 모니터링 |
|
||||
monitoring | 모니터링 |
|
||||
naked pod | 네이키드(naked) 파드 |
|
||||
Namespace | 네임스페이스 |
|
||||
Namespace | 네임스페이스 |
|
||||
Network Policy | 네트워크 폴리시 |
|
||||
Node | 노드 |
|
||||
Node | 노드 |
|
||||
node lease | 노드 리스(lease)
|
||||
Object | 오브젝트 |
|
||||
Object | 오브젝트 |
|
||||
Orchestrate | 오케스트레이션하다 |
|
||||
Output | 출력 |
|
||||
Output | 출력 |
|
||||
parameter | 파라미터 |
|
||||
patch | 패치 |
|
||||
Pending | Pending | 파드, 클레임의 상태에 한함
|
||||
Persistent Volume | 퍼시스턴트 볼륨 |
|
||||
Persistent Volume Claim | 퍼시스턴트 볼륨 클레임 |
|
||||
pipeline | 파이프라인 |
|
||||
placeholder pod | 플레이스홀더(placeholder) 파드 |
|
||||
Pending | Pending | 파드, 클레임의 상태에 한함
|
||||
Persistent Volume | 퍼시스턴트 볼륨 |
|
||||
Persistent Volume Claim | 퍼시스턴트 볼륨 클레임 |
|
||||
pipeline | 파이프라인 |
|
||||
placeholder pod | 플레이스홀더(placeholder) 파드 |
|
||||
Pod(파드) | 파드 |
|
||||
Pod Preset | 파드 프리셋 |
|
||||
PodAntiAffinity | 파드안티어피니티(PodAntiAffinity) |
|
||||
Pod Preset | 파드 프리셋 |
|
||||
PodAntiAffinity | 파드안티어피니티(PodAntiAffinity) |
|
||||
PodDisruptionBudget | PodDisruptionBudget |
|
||||
postfix | 접미사 |
|
||||
postfix | 접미사 |
|
||||
prefix | 접두사 |
|
||||
Privileged | 특권을 가진(privileged) |
|
||||
Prometheus | 프로메테우스 |
|
||||
proof of concept | 개념 증명 |
|
||||
proof of concept | 개념 증명 |
|
||||
Pull Request | 풀 리퀘스트 |
|
||||
Pull Secret Credentials | 풀(Pull) 시크릿 자격증명 |
|
||||
QoS Class | QoS 클래스 |
|
||||
Quota | 쿼터 |
|
||||
QoS Class | QoS 클래스 |
|
||||
Quota | 쿼터 |
|
||||
Ready | Ready |
|
||||
Reclaim Policy | 반환 정책 |
|
||||
Registry | 레지스트리 |
|
||||
Release | 릴리스 |
|
||||
Replica Set | 레플리카 셋 |
|
||||
Reclaim Policy | 반환 정책 |
|
||||
Registry | 레지스트리 |
|
||||
Release | 릴리스 |
|
||||
Replica Set | 레플리카 셋 |
|
||||
replicas | 레플리카 |
|
||||
Replication Controller | 레플리케이션 컨트롤러 |
|
||||
Replication Controller | 레플리케이션 컨트롤러 |
|
||||
repository | 리포지터리 |
|
||||
resource | 리소스 |
|
||||
resource | 리소스 |
|
||||
Resource Limit | 리소스 상한 |
|
||||
Resource Quota | 리소스 쿼터 |
|
||||
return | 반환하다 |
|
||||
return | 반환하다 |
|
||||
revision | 리비전 |
|
||||
Role | 롤 |
|
||||
rollback | 롤백 |
|
||||
rollback | 롤백 |
|
||||
rolling update | 롤링 업데이트 |
|
||||
rollout | 롤아웃 |
|
||||
Running | Running | 파드의 상태에 한함
|
||||
Running | Running | 파드의 상태에 한함
|
||||
runtime | 런타임 |
|
||||
Scale | 스케일 |
|
||||
Secret | 시크릿 |
|
||||
Scale | 스케일 |
|
||||
Secret | 시크릿 |
|
||||
segment | 세그먼트 |
|
||||
Selector | 셀렉터 |
|
||||
Selector | 셀렉터 |
|
||||
Self-healing | 자가 치유 |
|
||||
Service | 서비스 |
|
||||
Service Account | 서비스 어카운트 |
|
||||
service discovery | 서비스 디스커버리 |
|
||||
Service | 서비스 |
|
||||
Service Account | 서비스 어카운트 |
|
||||
service discovery | 서비스 디스커버리 |
|
||||
service mesh | 서비스 메시 |
|
||||
Session | 세션 |
|
||||
Session | 세션 |
|
||||
Session Affinity | 세션 어피니티(Affinity) |
|
||||
Setting | 세팅 |
|
||||
Setting | 세팅 |
|
||||
Shell | 셸 |
|
||||
Sign In | 로그인 |
|
||||
Sign In | 로그인 |
|
||||
Sign Out | 로그아웃 |
|
||||
skew | 차이(skew) |
|
||||
Stateful Set | 스테이트풀 셋 |
|
||||
stateless | 스테이트리스 |
|
||||
Stateful Set | 스테이트풀 셋 |
|
||||
stateless | 스테이트리스 |
|
||||
Static pod | 스태틱(static) 파드 |
|
||||
Storage Class | 스토리지 클래스 |
|
||||
Sub-Object | 서브-오브젝트 |
|
||||
Storage Class | 스토리지 클래스 |
|
||||
Sub-Object | 서브-오브젝트 |
|
||||
support | 지원 |
|
||||
Surge | 증가율 | 롤링업데이트 전략에 한함
|
||||
System | 시스템 |
|
||||
System | 시스템 |
|
||||
taint | 테인트(taint) |
|
||||
Task | 태스크 |
|
||||
Terminated | Terminated | 파드의 상태에 한함
|
||||
Terminated | Terminated | 파드의 상태에 한함
|
||||
tolerations | 톨러레이션(toleration) |
|
||||
Topology spread constraints | 토폴로지 분배 제약 조건 |
|
||||
Tools | 도구 |
|
||||
traffic | 트래픽 |
|
||||
Type | 타입 |
|
||||
ubuntu | 우분투 |
|
||||
use case | 유스케이스 |
|
||||
Type | 타입 |
|
||||
ubuntu | 우분투 |
|
||||
use case | 유스케이스 |
|
||||
Utilization | 사용량, 사용률 |
|
||||
verbosity | 로그 상세 레벨(verbosity) |
|
||||
virtualization | 가상화 |
|
||||
Volume | 볼륨 |
|
||||
Waiting | Waiting | 파드의 상태에 한함
|
||||
Walkthrough | 연습 |
|
||||
Windows | 윈도우 |
|
||||
Worker | 워커 | 노드의 형태에 한함
|
||||
Workload | 워크로드 |
|
||||
YAML | YAML |
|
||||
Volume | 볼륨 |
|
||||
Waiting | Waiting | 파드의 상태에 한함
|
||||
Walkthrough | 연습 |
|
||||
Windows | 윈도우 |
|
||||
Worker | 워커 | 노드의 형태에 한함
|
||||
Workload | 워크로드 |
|
||||
YAML | YAML |
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue