Seventh Korean l10n work for release 1.18
- Translate reference/command-line-tools-reference/feature-gates.md int… (#22240) - Fix issue of broken links to translated docs (#22105) - Fix issue of document link in some ko documents (#22379) - Translate tasks/administer-cluster/access-cluster-services.md into Ko… (#21776) - Fix issue with 'Linux' and 'Windows' notation in Korean docs (#22362) - Fix issue of broken links to translated docs #2 (#22270) - Fix issue with k8s.io/ko/docs/concepts/overview/kubernetes-api.md (#22261) - Fix issue with k8s.io/ko/docs/concepts/overview/working-with-objects/ (#22263) - Fix incorrect notation of 'directory' into Korean (#22155) - Fix issue with k8s.io/ko/docs/concepts/overview/components.md (#22232) - Update outdated files in dev-1.18-ko.7 (#22128) - Modify spacing term ReplicaSet in Korean (#22148) - Translate tasks/administer-cluster/extended-resource-node.md into Korean (#21849) - Translate tasks/administer-cluster/access-cluster-api.md into Korean (#21730) Co-authored-by: Jerry Park <jaehwa@gmail.com> Co-authored-by: woopyoung <ywp041@gmail.com> Co-authored-by: coolguyhong <podolsmith@naver.com> Co-authored-by: PyungHo Yoon <learder@gmail.com> Co-authored-by: Seokho Son <shsongist@gmail.com> Co-authored-by: jmyung <jesang.myung@gmail.com> Co-authored-by: Ian Y. Choi <ianyrchoi@gmail.com>
This commit is contained in:
@@ -12,7 +12,7 @@ card:
|
||||
|
||||
<!-- overview -->
|
||||
|
||||
이 웹사이트는 [쿠버네티스 SIG Docs](/docs/contribute/#get-involved-with-sig-docs)에 의해서 관리됩니다.
|
||||
이 웹사이트는 [쿠버네티스 SIG Docs](/ko/docs/contribute/#sig-docs에-참여)에 의해서 관리됩니다.
|
||||
|
||||
쿠버네티스 문서 기여자들은
|
||||
|
||||
@@ -35,7 +35,7 @@ card:
|
||||
|
||||
1. CNCF [Contributor License Agreement](https://github.com/kubernetes/community/blob/master/CLA.md)에 서명합니다.
|
||||
2. [문서 리포지터리](https://github.com/kubernetes/website) 와 웹사이트의 [정적 사이트 생성기](https://gohugo.io)를 숙지합니다.
|
||||
3. [풀 리퀘스트 열기](/docs/contribute/new-content/new-content/)와 [변경 검토](/docs/contribute/review/reviewing-prs/)의 기본 프로세스를 이해하도록 합니다.
|
||||
3. [풀 리퀘스트 열기](/ko/docs/contribute/new-content/new-content/)와 [변경 검토](/ko/docs/contribute/review/reviewing-prs/)의 기본 프로세스를 이해하도록 합니다.
|
||||
|
||||
일부 작업에는 쿠버네티스 조직에서 더 많은 신뢰와 더 많은 접근이 필요할 수 있습니다.
|
||||
역할과 권한에 대한 자세한 내용은
|
||||
@@ -43,16 +43,16 @@ card:
|
||||
|
||||
## 첫 번째 기여
|
||||
|
||||
- [기여 개요](/docs/contribute/new-content/overview/)를 읽고 기여할 수 있는 다양한 방법에 대해 알아봅니다.
|
||||
- [기여 개요](/ko/docs/contribute/new-content/overview/)를 읽고 기여할 수 있는 다양한 방법에 대해 알아봅니다.
|
||||
- [kubernetes/website에 기여하기](https://github.com/kubernetes/website/contribute)를 참조하여 좋은 진입점이 되는 이슈를 찾을 수 있습니다.
|
||||
- 기존 문서에 대해 [GitHub을 사용해서 풀 리퀘스트 열거나](/docs/contribute/new-content/new-content/#changes-using-github) GitHub에서의 이슈 제기에 대해 자세히 알아봅니다.
|
||||
- 정확성과 언어에 대해 다른 쿠버네티스 커뮤니티 맴버의 [풀 리퀘스트 검토](/docs/contribute/review/reviewing-prs/)를 합니다.
|
||||
- 기존 문서에 대해 [GitHub을 사용해서 풀 리퀘스트 열거나](/ko/docs/contribute/new-content/new-content/#github을-사용하여-변경하기) GitHub에서의 이슈 제기에 대해 자세히 알아봅니다.
|
||||
- 정확성과 언어에 대해 다른 쿠버네티스 커뮤니티 맴버의 [풀 리퀘스트 검토](/ko/docs/contribute/review/reviewing-prs/)를 합니다.
|
||||
- 쿠버네티스 [콘텐츠](/docs/contribute/style/content-guide/)와 [스타일 가이드](/docs/contribute/style/style-guide/)를 읽고 정보에 대한 코멘트를 남길 수 있습니다.
|
||||
- [페이지 템플릿 사용](/docs/contribute/style/page-content-types/)과 [휴고(Hugo) 단축코드(shortcodes)](/docs/contribute/style/hugo-shortcodes/)를 사용해서 큰 변경을 하는 방법에 대해 배워봅니다.
|
||||
|
||||
## 다음 단계
|
||||
|
||||
- 리포지터리의 [로컬 복제본에서 작업](/docs/contribute/new-content/new-content/#fork-the-repo)하는 방법을 배워봅니다.
|
||||
- 리포지터리의 [로컬 복제본에서 작업](/ko/docs/contribute/new-content/new-content/#fork-the-repo)하는 방법을 배워봅니다.
|
||||
- [릴리스된 기능](/docs/contribute/new-content/new-features/)을 문서화 합니다.
|
||||
- [SIG Docs](/ko/docs/contribute/participating/)에 참여하고, [멤버 또는 검토자](/ko/docs/contribute/participating/#역할과-책임)가 되어봅니다.
|
||||
- [현지화](/ko/docs/contribute/localization_ko/)를 시작하거나 도와줍니다.
|
||||
|
||||
@@ -39,6 +39,7 @@ PR 랭글러의 임무는 다음과 같다.
|
||||
- 리뷰가 진행되었고, 병합하기 전에 추가 입력이나 조치가 필요한 PR에 `Doc Review: Open Issues` 나 `Tech Review: Open Issues` 를 할당한다.
|
||||
- 병합할 수 있는 PR에 `/lgtm` 과 `/approve` 를 할당한다.
|
||||
- PR이 준비가 되면 병합하거나, 수락해서는 안되는 PR을 닫는다.
|
||||
- 콘텐츠가 문서의 [스타일 가이드라인](/docs/contribute/style/style-guide/) 중 일부만 충족하더라도 정확한 기술 콘텐츠를 수락하는 것이 좋다. 스타일 문제를 해결하기 위해 `good first issue` 라는 레이블로 새로운 이슈를 연다.
|
||||
- 새로운 이슈를 매일 심사하고 태그를 지정한다. SIG Docs가 메타데이터를 사용하는 방법에 대한 지침은 [이슈 심사 및 분류](/ko/docs/contribute/review/for-approvers/#이슈-심사와-분류)를 참고한다.
|
||||
|
||||
## 랭글러에게 유용한 GitHub 쿼리
|
||||
|
||||
@@ -217,21 +217,39 @@ git에 익숙하거나, 변경 사항이 몇 줄보다 클 경우,
|
||||
|
||||
변경 사항을 푸시하거나 풀 리퀘스트를 열기 전에 변경 사항을 로컬에서 미리 보는 것이 좋다. 미리보기를 사용하면 빌드 오류나 마크다운 형식 문제를 알아낼 수 있다.
|
||||
|
||||
website의 도커 이미지를 만들거나 Hugo를 로컬에서 실행할 수 있다. 도커 이미지 빌드는 느리지만 [Hugo 단축코드](/docs/contribute/style/hugo-shortcodes/)를 표시하므로, 디버깅에 유용할 수 있다.
|
||||
website의 컨테이너 이미지를 만들거나 Hugo를 로컬에서 실행할 수 있다. 도커 이미지 빌드는 느리지만 [Hugo 단축코드](/docs/contribute/style/hugo-shortcodes/)를 표시하므로, 디버깅에 유용할 수 있다.
|
||||
|
||||
{{< tabs name="tab_with_hugo" >}}
|
||||
{{% tab name="Hugo 컨테이너" %}}
|
||||
|
||||
{{< note >}}
|
||||
아래 명령은 도커를 기본 컨테이너 엔진으로 사용한다. 이 동작을 무시하려면 `CONTAINER_ENGINE` 환경변수를 설정한다.
|
||||
{{< /note >}}
|
||||
|
||||
1. 로컬에서 이미지를 빌드한다.
|
||||
|
||||
```bash
|
||||
make docker-image
|
||||
# docker 사용(기본값)
|
||||
make container-image
|
||||
|
||||
### 또는 ###
|
||||
|
||||
# podman 사용
|
||||
CONTAINER_ENGINE=podman make container-image
|
||||
```
|
||||
|
||||
2. 로컬에서 `kubernetes-hugo` 이미지를 빌드한 후, 사이트를 빌드하고 서비스한다.
|
||||
|
||||
```bash
|
||||
make docker-serve
|
||||
# docker 사용(기본값)
|
||||
make container-serve
|
||||
|
||||
### 또는 ###
|
||||
|
||||
# podman 사용
|
||||
CONTAINER_ENGINE=podman make container-serve
|
||||
```
|
||||
|
||||
3. 웹 브라우저에서 `https://localhost:1313` 로 이동한다. Hugo는
|
||||
@@ -286,7 +304,7 @@ PR을 연 후, GitHub는 자동 테스트를 실행하고 [Netlify](https://www.
|
||||
- Netlify 빌드가 실패하면, 자세한 정보를 위해 **Details** 를 선택한다.
|
||||
- Netlify 빌드가 성공하면, **Details** 를 선택하면 변경 사항이 적용된 쿠버네티스 website의 커밋하기 직전의 버전(staged version)이 열린다. 리뷰어가 변경 사항을 확인하는 방법이다.
|
||||
|
||||
또한 GitHub는 리뷰어에게 도움을 주기 위해 PR에 레이블을 자동으로 할당한다. 필요한 경우 직접 추가할 수도 있다. 자세한 내용은 [이슈 레이블 추가와 제거](/docs/contribute/review/for-approvers/#adding-and-removing-issue-labels)를 참고한다.
|
||||
또한 GitHub는 리뷰어에게 도움을 주기 위해 PR에 레이블을 자동으로 할당한다. 필요한 경우 직접 추가할 수도 있다. 자세한 내용은 [이슈 레이블 추가와 제거](/ko/docs/contribute/review/for-approvers/#이슈-레이블-추가와-제거)를 참고한다.
|
||||
|
||||
### 로컬에서 피드백 해결
|
||||
|
||||
@@ -481,5 +499,3 @@ PR에 여러 커밋이 있는 경우, PR을 병합하기 전에 해당 커밋을
|
||||
|
||||
|
||||
- 리뷰 프로세스에 대한 자세한 내용은 [리뷰하기](/ko/docs/contribute/reviewing/revewing-prs)를 읽어본다.
|
||||
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ SIG Docs는 모든 컨트리뷰터의 콘텐츠와 리뷰를 환영한다.
|
||||
|
||||
## 역할과 책임
|
||||
|
||||
- **모든 사람** 은 쿠버네티스 문서에 기여할 수 있다. 기여 시 [CLA에 서명](/docs/contribute/new-content/overview/#sign-the-cla)하고 GitHub 계정을 가지고 있어야 한다.
|
||||
- **모든 사람** 은 쿠버네티스 문서에 기여할 수 있다. 기여 시 [CLA에 서명](/ko/docs/contribute/new-content/overview/#sign-the-cla)하고 GitHub 계정을 가지고 있어야 한다.
|
||||
- 쿠버네티스 조직의 **멤버** 는 쿠버네티스 프로젝트에 시간과 노력을 투자한 기여자이다. 일반적으로 승인되는 변경이 되는 풀 리퀘스트를 연다. 멤버십 기준은 [커뮤니티 멤버십](https://github.com/kubernetes/community/blob/master/community-membership.md)을 참조한다.
|
||||
- SIG Docs의 **리뷰어** 는 쿠버네티스 조직의 일원으로
|
||||
문서 풀 리퀘스트에 관심을 표명했고, SIG Docs 승인자에
|
||||
@@ -62,7 +62,7 @@ SIG Docs는 모든 컨트리뷰터의 콘텐츠와 리뷰를 환영한다.
|
||||
만약 쿠버네티스 조직의 멤버가 아니라면, `/lgtm` 을 사용하는 것은 자동화된 시스템에 아무런 영향을 주지 않는다.
|
||||
{{< /note >}}
|
||||
|
||||
[CLA에 서명](/docs/contribute/new-content/overview/#sign-the-cla)) 후에 누구나 다음을 할 수 있다.
|
||||
[CLA에 서명](/ko/docs/contribute/new-content/overview/#sign-the-cla) 후에 누구나 다음을 할 수 있다.
|
||||
- 기존 콘텐츠를 개선하거나, 새 콘텐츠를 추가하거나, 블로그 게시물 또는 사례연구 작성을 위해 풀 리퀘스트를 연다.
|
||||
|
||||
## 멤버
|
||||
@@ -224,7 +224,7 @@ GitHub 그룹에 당신을 추가하기를 요청한다. `kubernetes-website-adm
|
||||
- 승인 전에 PR에 대한 Netlify 프리뷰 페이지를 방문하여, 제대로 보이는지 확인한다.
|
||||
|
||||
- 주간 로테이션을 위해 [PR Wrangler 로테이션 스케줄](https://github.com/kubernetes/website/wiki/PR-Wranglers)에 참여한다. SIG Docs는 모든 승인자들이 이 로테이션에 참여할
|
||||
것으로 기대한다. [일주일 간 PR Wrangler 되기](/docs/contribute/advanced#be-the-pr-wrangler-for-a-week)
|
||||
것으로 기대한다. [일주일 간 PR Wrangler 되기](/ko/docs/contribute/advanced/#일주일-동안-pr-랭글러-wrangler-되기)
|
||||
문서를 참고한다.
|
||||
|
||||
## SIG Docs 의장
|
||||
@@ -299,7 +299,7 @@ PR 소유자에게 조언하는데 활용된다.
|
||||
- 모든 쿠버네티스 멤버는 코멘트에 `/lgtm` 을 추가해서 `lgtm` 레이블을 추가할 수 있다.
|
||||
- SIG Docs 승인자들만이 코멘트에 `/approve` 를
|
||||
추가해서 풀 리퀘스트를 병합할 수 있다. 일부 승인자들은
|
||||
[PR Wrangler](/docs/contribute/advanced#be-the-pr-wrangler-for-a-week) 또는 [SIG Docs 의장](#sig-docs-의장)과
|
||||
[PR Wrangler](/ko/docs/contribute/advanced/#일주일-동안-pr-랭글러-wrangler-되기) 또는 [SIG Docs 의장](#sig-docs-의장)과
|
||||
같은 특정 역할도 수행한다.
|
||||
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@ weight: 10
|
||||
|
||||
- 적합한 코멘트를 남길 수 있도록 [콘텐츠 가이드](/docs/contribute/style/content-guide/)와
|
||||
[스타일 가이드](/docs/contribute/style/style-guide/)를 읽는다.
|
||||
- 쿠버네티스 문서화 커뮤니티의 다양한 [역할과 책임](/docs/contribute/participating/#roles-and-responsibilities)을 이해한다.
|
||||
- 쿠버네티스 문서화 커뮤니티의 다양한 [역할과 책임](/ko/docs/contribute/participating/#역할과-책임)을 이해한다.
|
||||
|
||||
|
||||
|
||||
@@ -44,7 +44,7 @@ weight: 10
|
||||
표시된다.
|
||||
|
||||
2. 다음 레이블 중 하나 또는 모두를 사용하여 열린 PR을 필터링한다.
|
||||
- `cncf-cla: yes`(권장): CLA에 서명하지 않은 기여자가 제출한 PR은 병합할 수 없다. 자세한 내용은 [CLA 서명](/docs/contribute/new-content/overview/#sign-the-cla)을 참고한다.
|
||||
- `cncf-cla: yes`(권장): CLA에 서명하지 않은 기여자가 제출한 PR은 병합할 수 없다. 자세한 내용은 [CLA 서명](/ko/docs/contribute/new-content/overview/#sign-the-cla)을 참고한다.
|
||||
- `language/en`(권장): 영어 문서에 대한 PR 전용 필터이다.
|
||||
- `size/<size>`: 특정 크기의 PR을 필터링한다. 새로 시작하는 사람이라면, 더 작은 PR로 시작한다.
|
||||
|
||||
@@ -94,5 +94,3 @@ weight: 10
|
||||
### 기타
|
||||
|
||||
오타나 공백과 같은 작은 이슈의 PR인 경우, 코멘트 앞에 `nit:` 를 추가한다. 이를 통해 문서의 저자는 이슈가 긴급하지 않다는 것을 알 수 있다.
|
||||
|
||||
|
||||
|
||||
@@ -55,30 +55,30 @@ YAML 블록이다. 여기 예시가 있다.
|
||||
title: HTTP 프록시를 사용하여 쿠버네티스 API에 접근
|
||||
---
|
||||
|
||||
## 디렉토리 선택
|
||||
## 디렉터리 선택
|
||||
|
||||
페이지 타입에 따라 새로운 파일을 다음 중 하나의 하위 디렉토리에 넣자.
|
||||
페이지 타입에 따라 새로운 파일을 다음 중 하나의 하위 디렉터리에 넣자.
|
||||
|
||||
* /content/en/docs/tasks/
|
||||
* /content/en/docs/tutorials/
|
||||
* /content/en/docs/concepts/
|
||||
|
||||
파일을 기존 하위 디렉토리에 넣거나 새 하위 디렉토리에
|
||||
파일을 기존 하위 디렉터리에 넣거나 새 하위 디렉터리에
|
||||
넣을 수 있다.
|
||||
|
||||
## 목차에 항목 배치
|
||||
|
||||
목차는 문서 소스의 디렉토리 구조를 사용하여
|
||||
동적으로 작성된다. `/content/en/docs/` 아래의 최상위 디렉토리는 최상위 레벨 탐색 기능을
|
||||
생성하고, 하위 디렉토리는 각각 목차에 항목을
|
||||
목차는 문서 소스의 디렉터리 구조를 사용하여
|
||||
동적으로 작성된다. `/content/en/docs/` 아래의 최상위 디렉터리는 최상위 레벨 탐색 기능을
|
||||
생성하고, 하위 디렉터리는 각각 목차에 항목을
|
||||
갖는다.
|
||||
|
||||
각 하위 디렉토리에는 `_index.md` 파일이 있으며 이는 해당 하위 디렉토리의 컨텐츠에 대한
|
||||
각 하위 디렉터리에는 `_index.md` 파일이 있으며 이는 해당 하위 디렉터리의 컨텐츠에 대한
|
||||
"홈" 페이지를 나타낸다. `_index.md`에는 템플릿이 필요없다. 그것은
|
||||
하위 디렉토리의 항목에 대한 개요 내용을 포함할 수 있다.
|
||||
하위 디렉터리의 항목에 대한 개요 내용을 포함할 수 있다.
|
||||
|
||||
디렉토리의 다른 파일들은 기본적으로 알파벳순으로 정렬된다. 이것은 거의
|
||||
최적의 순서가 아니다. 하위 디렉토리에서 항목의 상대적 정렬을 제어하려면
|
||||
디렉터리의 다른 파일들은 기본적으로 알파벳순으로 정렬된다. 이것은 거의
|
||||
최적의 순서가 아니다. 하위 디렉터리에서 항목의 상대적 정렬을 제어하려면
|
||||
`가중치:` 전문의 키를 정수로 설정하자. 일반적으로 우리는
|
||||
나중에 항목을 추가하기 위해 10의 배수를 사용한다. 예를 들어 가중치가
|
||||
`10`인 항목은 가중치가 `20`인 항목보다 우선한다.
|
||||
@@ -112,13 +112,13 @@ YAML 블록이다. 여기 예시가 있다.
|
||||
샘플 YAML 파일을 포함시키려면 이 방법을 사용하자.
|
||||
|
||||
YAML 파일과 같은 새로운 독립형 샘플 파일을 추가할 때
|
||||
`<LANG>/examples/` 의 하위 디렉토리 중 하나에 코드를 배치하자. 여기서 `<LANG>`은
|
||||
`<LANG>/examples/` 의 하위 디렉터리 중 하나에 코드를 배치하자. 여기서 `<LANG>`은
|
||||
주제에 관한 언어이다. 문서 파일에서 `codenew` 단축 코드(shortcode)를 사용하자.
|
||||
|
||||
```none
|
||||
{{</* codenew file="<RELPATH>/my-example-yaml>" */>}}
|
||||
```
|
||||
여기서 `<RELPATH>` 는 `examples` 디렉토리와 관련하여 포함될
|
||||
여기서 `<RELPATH>` 는 `examples` 디렉터리와 관련하여 포함될
|
||||
파일의 경로이다. 다음 Hugo 단축 코드(shortcode)는 `/content/en/examples/pods/storage/gce-volume.yaml`
|
||||
에 있는 YAML 파일을 참조한다.
|
||||
|
||||
@@ -135,7 +135,7 @@ YAML 파일과 같은 새로운 독립형 샘플 파일을 추가할 때
|
||||
## 구성 파일에서 API 오브젝트를 작성하는 방법 표시
|
||||
|
||||
구성 파일을 기반으로 API 오브젝트를 생성하는 방법을 보여주려면
|
||||
`<LANG>/examples` 아래의 하위 디렉토리 중 하나에
|
||||
`<LANG>/examples` 아래의 하위 디렉터리 중 하나에
|
||||
구성 파일을 배치하자.
|
||||
|
||||
문서에서 이 명령을 띄워보자.
|
||||
@@ -145,18 +145,18 @@ kubectl create -f https://k8s.io/examples/pods/storage/gce-volume.yaml
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
`<LANG>/examples` 디렉토리에 새 YAMl 파일을 추가할 때 파일이
|
||||
`<LANG>/examples` 디렉터리에 새 YAMl 파일을 추가할 때 파일이
|
||||
`<LANG>/examples_test.go` 파일에도 포함되어 있는지 확인하자.
|
||||
웹 사이트의 Travis CI 는 PR이 제출될 때 이 예제를 자동으로
|
||||
실행하여 모든 예제가 테스트를 통과하도록 한다.
|
||||
{{< /note >}}
|
||||
|
||||
이 기술을 사용하는 문서의 예로
|
||||
[단일 인스턴스 스테이트풀 어플리케이션 실행](/docs/tutorials/stateful-application/run-stateful-application/)을 참조하자.
|
||||
[단일 인스턴스 스테이트풀 어플리케이션 실행](/ko/docs/tasks/run-application/run-single-instance-stateful-application/)을 참조하자.
|
||||
|
||||
## 문서에 이미지 추가
|
||||
|
||||
이미지 파일을 `/images` 디렉토리에 넣는다. 기본
|
||||
이미지 파일을 `/images` 디렉터리에 넣는다. 기본
|
||||
이미지 형식은 SVG 이다.
|
||||
|
||||
|
||||
@@ -164,5 +164,4 @@ kubectl create -f https://k8s.io/examples/pods/storage/gce-volume.yaml
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
* [페이지 콘텐츠 타입 사용](/docs/contribute/style/page-content-types/)에 대해 알아보기.
|
||||
* [풀 리퀘스트 작성](/docs/contribute/new-content/open-a-pr/)에 대해 알아보기.
|
||||
|
||||
* [풀 리퀘스트 작성](/ko/docs/contribute/new-content/new-content/)에 대해 알아보기.
|
||||
|
||||
Reference in New Issue
Block a user