Skip to content

Commit

Permalink
[ko] Update outdated files in dev-1.24-ko.1 ko.toml
Browse files Browse the repository at this point in the history
  • Loading branch information
jihoon-seo committed May 30, 2022
1 parent e6d993f commit 9fd05ae
Show file tree
Hide file tree
Showing 2 changed files with 108 additions and 10 deletions.
60 changes: 56 additions & 4 deletions README-ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,9 @@

이 저장소에는 [쿠버네티스 웹사이트 및 문서](https://kubernetes.io/)를 빌드하는 데 필요한 자산이 포함되어 있습니다. 기여해주셔서 감사합니다!

- [문서에 기여하기](#contributing-to-the-docs)
- [`README.md`에 대한 쿠버네티스 문서 현지화](#localization-readmemds)

# 저장소 사용하기

Hugo(확장 버전)를 사용하여 웹사이트를 로컬에서 실행하거나, 컨테이너 런타임에서 실행할 수 있습니다. 라이브 웹사이트와의 배포 일관성을 제공하므로, 컨테이너 런타임을 사용하는 것을 적극 권장합니다.
Expand Down Expand Up @@ -40,6 +43,8 @@ make container-image
make container-serve
```

에러가 발생한다면, Hugo 컨테이너를 위한 컴퓨팅 리소스가 충분하지 않기 때문일 수 있습니다. 이를 해결하려면, 머신에서 도커에 허용할 CPU 및 메모리 사용량을 늘립니다([MacOSX](https://docs.docker.com/docker-for-mac/#resources) / [Windows](https://docs.docker.com/docker-for-windows/#resources)).

웹사이트를 보려면 브라우저를 http://localhost:1313 으로 엽니다. 소스 파일을 변경하면 Hugo가 웹사이트를 업데이트하고 브라우저를 강제로 새로 고칩니다.

## Hugo를 사용하여 로컬에서 웹사이트 실행하기
Expand All @@ -56,7 +61,45 @@ make serve

그러면 포트 1313에서 로컬 Hugo 서버가 시작됩니다. 웹사이트를 보려면 http://localhost:1313 으로 브라우저를 엽니다. 소스 파일을 변경하면, Hugo가 웹사이트를 업데이트하고 브라우저를 강제로 새로 고칩니다.

## API 레퍼런스 페이지 빌드하기

`content/en/docs/reference/kubernetes-api`에 있는 API 레퍼런스 페이지는 <https://github.com/kubernetes-sigs/reference-docs/tree/master/gen-resourcesdocs>를 사용하여 Swagger 명세로부터 빌드되었습니다.

새로운 쿠버네티스 릴리스를 위해 레퍼런스 페이지를 업데이트하려면 다음 단계를 수행합니다.

1. `api-ref-generator` 서브모듈을 받아옵니다.

```bash
git submodule update --init --recursive --depth 1
```

2. Swagger 명세를 업데이트합니다.

```bash
curl 'https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/openapi-spec/swagger.json' > api-ref-assets/api/swagger.json
```

3. `api-ref-assets/config/`에서, 새 릴리스의 변경 사항이 반영되도록 `toc.yaml``fields.yaml` 파일을 업데이트합니다.

4. 다음으로, 페이지를 빌드합니다.

```bash
make api-reference
```

로컬에서 결과를 테스트하기 위해 컨테이너 이미지를 이용하여 사이트를 빌드 및 실행합니다.

```bash
make container-image
make container-serve
```

웹 브라우저에서, <http://localhost:1313/docs/reference/kubernetes-api/>로 이동하여 API 레퍼런스를 확인합니다.

5. 모든 API 변경사항이 `toc.yaml``fields.yaml` 구성 파일에 반영되었다면, 새로 생성된 API 레퍼런스 페이지에 대한 PR을 엽니다.

## 문제 해결

### error: failed to transform resource: TOCSS: failed to transform "scss/main.scss" (text/x-scss): this feature is not available in your current Hugo version

Hugo는 기술적인 이유로 2개의 바이너리 세트로 제공됩니다. 현재 웹사이트는 **Hugo 확장** 버전 기반에서만 실행됩니다. [릴리스 페이지](https://github.com/gohugoio/hugo/releases)에서 이름에 `extended` 가 포함된 아카이브를 찾습니다. 확인하려면, `hugo version` 을 실행하고 `extended` 라는 단어를 찾습니다.
Expand Down Expand Up @@ -97,17 +140,17 @@ sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist

이 내용은 Catalina와 Mojave macOS에서 작동합니다.


# SIG Docs에 참여하기

[커뮤니티 페이지](https://github.com/kubernetes/community/tree/master/sig-docs#meetings)에서 SIG Docs 쿠버네티스 커뮤니티 및 회의에 대한 자세한 내용을 확인합니다.

이 프로젝트의 메인테이너에게 연락을 할 수도 있습니다.

- [슬랙](https://kubernetes.slack.com/messages/sig-docs) [슬랙에 초대 받기](https://slack.k8s.io/)
- [슬랙](https://kubernetes.slack.com/messages/sig-docs)
- [슬랙에 초대 받기](https://slack.k8s.io/)
- [메일링 리스트](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)

# 문서에 기여하기
# 문서에 기여하기 {#contributing-to-the-docs}

이 저장소에 대한 복제본을 여러분의 GitHub 계정에 생성하기 위해 화면 오른쪽 위 영역에 있는 **Fork** 버튼을 클릭하면 됩니다. 이 복제본은 *fork* 라고 부릅니다. 여러분의 fork에서 원하는 임의의 변경 사항을 만들고, 해당 변경 사항을 보낼 준비가 되었다면, 여러분의 fork로 이동하여 새로운 풀 리퀘스트를 만들어 우리에게 알려주시기 바랍니다.

Expand All @@ -124,7 +167,15 @@ sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
* [문서화 스타일 가이드](http://kubernetes.io/docs/contribute/style/style-guide/)
* [쿠버네티스 문서 현지화](https://kubernetes.io/docs/contribute/localization/)

# `README.md`에 대한 쿠버네티스 문서 현지화(localization)
### 신규 기여자 대사(ambassadors)

기여 과정에서 도움이 필요하다면, [신규 기여자 대사](https://kubernetes.io/docs/contribute/advanced/#serve-as-a-new-contributor-ambassador)에게 연락하는 것이 좋습니다. 이들은 신규 기여자를 멘토링하고 첫 PR 과정에서 도움을 주는 역할도 담당하는 SIG Docs 승인자입니다. 신규 기여자 대사에게 문의할 가장 좋은 곳은 [쿠버네티스 슬랙](https://slack.k8s.io/)입니다. 현재 SIG Docs 신규 기여자 대사는 다음과 같습니다.

| Name | Slack | GitHub |
| -------------------------- | -------------------------- | -------------------------- |
| Arsh Sharma | @arsh | @RinkiyaKeDad |

# `README.md`에 대한 쿠버네티스 문서 현지화(localization) {#localization-readmemds}

## 한국어

Expand All @@ -135,6 +186,7 @@ sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
* 손석호 ([GitHub - @seokho-son](https://github.com/seokho-son))
* [슬랙 채널](https://kubernetes.slack.com/messages/kubernetes-docs-ko)


# 행동 강령

쿠버네티스 커뮤니티 참여는 [CNCF 행동 강령](https://github.com/cncf/foundation/blob/master/code-of-conduct-languages/ko.md)을 따릅니다.
Expand Down
58 changes: 52 additions & 6 deletions data/i18n/ko/ko.toml
Original file line number Diff line number Diff line change
@@ -1,11 +1,5 @@
# i18n strings for the Korean translation.
# NOTE: Please keep the entries in alphabetical order when editing
[announcement_title]
other = "Black lives matter."

[announcement_message]
other = "우리는 흑인 공동체를 지지합니다.<br/>인종차별은 용납될 수 없습니다.<br/> 인종차별은 [쿠버네티스 프로젝트의 핵심 가치](https://git.k8s.io/community/values.md)에 상충되며 우리 공동체는 이를 용인하지 않습니다."

[caution]
other = "주의:"

Expand Down Expand Up @@ -42,6 +36,9 @@ other = " 문서는 더 이상 적극적으로 관리되지 않음. 현재 보
[deprecation_file_warning]
other = "사용 중단됨(deprecated)"

[dockershim_message]
other = """Dockershim은 쿠버네티스 릴리스 1.24부터 쿠버네티스 프로젝트에서 제거되었다. 더 자세한 내용은 <a href="/dockershim">Dockershim 제거 FAQ</a>를 참고한다."""

[docs_label_browse]
other = "문서 둘러보기"

Expand All @@ -63,12 +60,21 @@ other = "최신 버전"
[docs_version_other_heading]
other = "이전 버전"

[end_of_life]
other = "지원 종료:"

[envvars_heading]
other = "환경 변수"

[error_404_were_you_looking_for]
other = "무엇과 관련된 정보를 찾으시나요?"

[examples_heading]
other = "예시"

[feature_state]
other = "기능 상태:"

[feedback_heading]
other = "피드백"

Expand All @@ -81,9 +87,18 @@ other = "네"
[feedback_no]
other = "아니요"

[inline_list_separator]
other = ","

[input_placeholder_email_address]
other = "전자 우편 주소"

[javascript_required]
other = "이 컨텐츠를 보려면 자바스크립트가 [활성화](https://www.enable-javascript.com/)되어 있어야 합니다."

[latest_release]
other = "최신 릴리스:"

[latest_version]
other = "최신 버전."

Expand Down Expand Up @@ -183,6 +198,10 @@ other = "읽어 보기"
[main_read_more]
other = "더 읽기"

[not_applicable]
# Localization teams: it's OK to use a longer text here
other = "해당되지 않음"

[note]
other = "참고:"

Expand All @@ -192,12 +211,29 @@ other = "목적"
[options_heading]
other = "옵션"

[outdated_blog__message]
other = "이 글은 작성일로부터 1년 이상 지났습니다. 오래된 글은 더 이상 유효하지 않은 컨텐츠를 포함하고 있을 수 있습니다. 이 페이지의 정보가 틀리지 않았는지 다시 한 번 확인하세요."

[post_create_issue]
other = "이슈 생성"

[prerequisites_heading]
other = "시작하기 전에"

[previous_patches]
other = "패치 릴리스:"

[release_date_after]
other = "에 릴리스됨)"

[release_date_before]
other = "("

# See https://gohugo.io/functions/format/#gos-layout-string
# Use a suitable format for your locale
[release_date_format]
other = "2006-01-02"

[seealso_heading]
other = "더 보기"

Expand All @@ -210,6 +246,16 @@ other = "시놉시스"
[thirdparty_message]
other = """이 섹션은 쿠버네티스에 필요한 기능을 제공하는 써드파티 프로젝트와 관련이 있다. 쿠버네티스 프로젝트 작성자는 써드파티 프로젝트에 책임이 없다. 이 페이지는 <a href="https://github.com/cncf/foundation/blob/master/website-guidelines.md" target="_blank">CNCF 웹사이트 가이드라인</a>에 따라 프로젝트를 알파벳 순으로 나열한다. 이 목록에 프로젝트를 추가하려면 변경사항을 제출하기 전에 <a href="/contribute/style/content-guide/#third-party-content">콘텐츠 가이드</a>를 읽어본다."""

[thirdparty_message_edit_disclaimer]
other="""써드파티 컨텐츠 안내"""


[thirdparty_message_single_item]
other = """&#128711; 이 항목은 쿠버네티스에 속하지 않는 써드파티 프로젝트 또는 제품의 링크로 연결됩니다. <a class="alert-more-info" href="#third-party-content-disclaimer">추가 정보</a>"""

[thirdparty_message_disclaimer]
other = """<p>이 페이지는 쿠버네티스가 필요로 하는 기능을 제공하는 써드파티 프로젝트 또는 제품에 대해 언급하고 있습니다. 쿠버네티스 프로젝트 저자들은 이러한 써드파티 프로젝트 또는 제품에 대해 책임지지 않습니다. <a href="https://github.com/cncf/foundation/blob/master/website-guidelines.md" target="_blank">CNCF 웹사이트 가이드라인</a>에서 더 자세한 내용을 확인합니다.</p><p>다른 써드파티 링크를 추가하는 변경을 제안하기 전에, <a href="/docs/contribute/style/content-guide/#third-party-content">컨텐츠 가이드</a>를 확인해야 합니다.</p>"""

[ui_search_placeholder]
other = "검색하기"

Expand Down

0 comments on commit 9fd05ae

Please sign in to comment.