Sixth Korean l10n work for release-1.13 (#12705)
* ko: Update outdated files in dev-1.13-ko.6 (#12456) * Translate concepts/containers/runtime-class.md in Korean (#12459) * Fix ko translation consistency for commandlinetool word (#12626) * Added Korean localization guide (#12597) * Translate containers/images.md in Korean (#12549) * Translate container-lifecycle-hooks.md in Korean (#12534) * Translate tasks/run-application/horizontal-pod-autoscale in Korean (#12565) * Translate concepts/architecture/cloud-controller in Korean #11964 (#12483) * ko-trans: add setup/certificate.md #12453 (#12520) Co-authored-by: Claudia J.Kang <claudiajkang@gmail.com> Co-authored-by: June Yi <june.yi@samsung.com> Co-authored-by: Seokho <shsongist@gmail.com> Co-authored-by: Jesang Myung <jesang.myung@gmail.com> Co-authored-by: Kim Young Dae <38598117+zer0big@users.noreply.github.com> Co-authored-by: Yoon <learder@gmail.com>
This commit is contained in:
Claudia J.Kang
committed by
Kubernetes Prow Robot
Kubernetes Prow Robot
parent
8f1e5e05e8
commit
aa6564e014
@@ -0,0 +1,73 @@
|
||||
---
|
||||
content_template: templates/concept
|
||||
title: 쿠버네티스 문서에 기여하기
|
||||
linktitle: 기여
|
||||
main_menu: true
|
||||
weight: 80
|
||||
---
|
||||
|
||||
{{% capture overview %}}
|
||||
|
||||
If you would like to help contribute to the Kubernetes documentation or website,
|
||||
we're happy to have your help! Anyone can contribute, whether you're new to the
|
||||
project or you've been around a long time, and whether you self-identify as a
|
||||
developer, an end user, or someone who just can't stand seeing typos.
|
||||
|
||||
For more ways to get involved in the Kubernetes community or to learn about us, visit the [Kubernetes community site](/community/).
|
||||
For information on the Kubernetes documentation style guide, see the [style guide](/docs/contribute/style/style-guide/).
|
||||
|
||||
{{% capture body %}}
|
||||
|
||||
## Types of contributors
|
||||
|
||||
- A _member_ of the Kubernetes organization who has [signed the CLA](/docs/contribute/start#sign-the-cla)
|
||||
and contributed some time and effort to the project. See
|
||||
[Community membership](https://github.com/kubernetes/community/blob/master/community-membership.md)
|
||||
for specific criteria for membership.
|
||||
- A SIG Docs _reviewer_ is a member of the Kubernetes organization who has
|
||||
expressed interest in reviewing documentation pull requests and who has been
|
||||
added to the appropriate Github group and `OWNERS` files in the Github
|
||||
repository, by a SIG Docs Approver.
|
||||
- A SIG Docs _approver_ is a member in good standing who has shown a continued
|
||||
commitment to the project. An approver can merge pull requests
|
||||
and publish content on behalf of the Kubernetes organization.
|
||||
Approvers can also represent SIG Docs in the larger Kubernetes community.
|
||||
Some of the duties of a SIG Docs approver, such as coordinating a release,
|
||||
require a significant time commitment.
|
||||
|
||||
## Ways to contribute
|
||||
|
||||
This list is divided into things anyone can do, things Kubernetes organization
|
||||
members can do, and things that require a higher level of access and familiarity
|
||||
with SIG Docs processes. Contributing consistently over time can help you
|
||||
understand some of the tooling and organizational decisions that have already
|
||||
been made.
|
||||
|
||||
This is not an exhaustive list of ways you can contribute to the Kubernetes
|
||||
documentation, but it should help you get started.
|
||||
|
||||
- [Anyone](/docs/contribute/start/)
|
||||
- File actionable bugs
|
||||
- [Member](/docs/contribute/start/)
|
||||
- Improve existing docs
|
||||
- Bring up ideas for improvement on [Slack](http://slack.k8s.io/) or the [SIG docs mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
|
||||
- Improve docs accessibility
|
||||
- Provide non-binding feedback on PRs
|
||||
- Write a blog post or case study
|
||||
- [Reviewer](/docs/contribute/intermediate/)
|
||||
- Document new features
|
||||
- Triage and categorize issues
|
||||
- Review PRs
|
||||
- Create diagrams, graphics assets, and embeddable screencasts / videos
|
||||
- Localization
|
||||
- Contribute to other repos as a docs representative
|
||||
- Edit user-facing strings in code
|
||||
- Improve code comments, Godoc
|
||||
- [Approver](/docs/contribute/advanced/)
|
||||
- Publish contributor content by approving and merging PRs
|
||||
- Participate in a Kubernetes release team as a docs representative
|
||||
- Propose improvements to the style guide
|
||||
- Propose improvements to docs tests
|
||||
- Propose improvements to the Kubernetes website or other tooling
|
||||
|
||||
{{% /capture %}}
|
||||
@@ -0,0 +1,96 @@
|
||||
---
|
||||
title: 쿠버네티스 문서 한글화 가이드
|
||||
content_template: templates/concept
|
||||
---
|
||||
|
||||
{{% capture overview %}}
|
||||
|
||||
쿠버네티스 문서 한글화를 위한 가이드
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
|
||||
{{% capture body %}}
|
||||
|
||||
## 문체
|
||||
|
||||
### 높임말
|
||||
|
||||
평어체 사용을 원칙으로 하나, 일부 페이지(예: [https://kubernetes.io/ko](https://kubernetes.io/ko))에 한해 예외적으로
|
||||
높임말을 사용한다.
|
||||
|
||||
### 번역체 지양
|
||||
|
||||
우리글로서 자연스럽고 무리가 없도록 번역한다.
|
||||
|
||||
번역체 | 자연스러운 문장
|
||||
--- | ---
|
||||
-되어지다 (이중 피동 표현) | -되다
|
||||
짧은 다리를 가진 돼지 | 다리가 짧은 돼지
|
||||
그는 그의 손으로 숟가락을 들어 그의 밥을 먹었다 | 그는 손으로 숟가락을 들어 밥을 먹었다
|
||||
접시를 씻고 | 설거지를 하고
|
||||
가게에 배들, 사과들, 복숭아들이 있다 (과다한 복수형) | 가게에 배, 사과, 복숭아들이 있다
|
||||
|
||||
## 문서 코딩 가이드
|
||||
|
||||
### 가로폭은 원문을 따름
|
||||
|
||||
유지보수의 편의를 위해서 원문의 가로폭을 따른다.
|
||||
|
||||
즉, 원문이 한 문단을 줄바꿈하지 않고 한 행에 길게 기술했다면 한글화 시에도 한 행에 길게 기술하고, 원문이 한 문단을
|
||||
줄바꿈해서 여러 행으로 기술한 경우에는 한글화 시에도 가로폭을 원문과 비슷하게 유지한다.
|
||||
|
||||
### 리뷰어 삭제
|
||||
|
||||
일반적으로 원문 페이지의 리뷰어가 한글 페이지를 리뷰하기 어려우므로 다음과 같이 리소스 메타데이터에서 리뷰어를
|
||||
삭제한다.
|
||||
|
||||
```diff
|
||||
---
|
||||
- reviews:
|
||||
- - reviewer1
|
||||
- - reviewer2
|
||||
- title: Kubernetes Components
|
||||
+ title: 쿠버네티스 컴포넌트
|
||||
content_template: templates/concept
|
||||
weight: 10
|
||||
---
|
||||
```
|
||||
|
||||
## 용어
|
||||
|
||||
용어 선택은 다음의 우선 순위를 따르나, 자연스럽지 않은 용어를 무리하게 선택하지는 않는다.
|
||||
|
||||
|
||||
* 한글 단어
|
||||
* 순 우리말 단어
|
||||
* 한자어 (예: 운영 체제), 외래어 (예: 쿠버네티스, 파드)
|
||||
* 한영 병기 (예: 훅(hook))
|
||||
* 영어 단어 (예: Kubelet)
|
||||
|
||||
단, 자연스러움을 판단하는 기준은 주관적이므로 문서 한글화팀이 공동으로 관리하는
|
||||
[한글화팀 용어집](https://goo.gl/BDNeJ1)과 기존에 번역된 문서를 참고한다.
|
||||
|
||||
{{% note %}}
|
||||
API 오브젝트는 원 단어를
|
||||
[국립국어원 외래어 표기법](http://www.korean.go.kr/front/page/pageView.do?page_id=P000104&mn_id=97)에
|
||||
따라 한글화 한다. 예를 들면 다음과 같다.
|
||||
|
||||
원 단어 | 외래어
|
||||
--- | ---
|
||||
Deployment | 디플로이먼트
|
||||
Pod | 파드
|
||||
Service | 서비스
|
||||
{{% /note %}}
|
||||
|
||||
{{% note %}}
|
||||
API 오브젝트의 필드 이름, 파일 이름, 경로 이름과 같은 내용은 주로 코드 스타일로 기술된다. 이는 독자가 구성 파일이나
|
||||
커맨드라인에서 그대로 사용할 가능성이 높으므로 한글로 옮기지 않고 원문을 유지한다. 단, 주석은 한글로 옮길 수 있다.
|
||||
{{% /note %}}
|
||||
|
||||
{{% note %}}
|
||||
한영 병기는 페이지 내에서 해당 용어가 처음 사용되는 경우에만 적용하고 이후 부터는 한글만 표기한다.
|
||||
{{% /note %}}
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
Reference in New Issue
Block a user