[ko] Standardize handling of internal links in Korean localization (#53474)

* standardize internal links in Korean localization

* Update content/ko/docs/contribute/localization_ko_best_practice.md

Co-authored-by: Seokho Son <shsongist@gmail.com>

* address review comment

* address review comments

---------

Co-authored-by: Seokho Son <shsongist@gmail.com>

Author: wonyongg

content/ko/docs/contribute/localization_ko.md

@@ -47,12 +47,12 @@ content_type: concept
 지정한다.
 
 한글화팀의 PR 랭글러가 갖는 의무는 업스트림의
-[PR 랭글러](/ko/docs/contribute/advanced/#일주일-동안-pr-랭글러-wrangler-되기)가 갖는
+[PR 랭글러](/docs/contribute/participate/pr-wranglers)가 갖는
 의무와 유사하다. 단, 업스트림의 PR 랭글러와는 달리 승인자가 아니어도 팀 마일스톤의 PR 랭글러가
 될 수 있다. 그래서, 보다 상위 권한이 필요한 업무가 발생한 경우, PR 랭글러는 해당 권한을 가진
 한글화팀 멤버에게 처리를 요청한다.
 
-업스트림의 [PR 랭글러에게 유용한 GitHub 쿼리](/ko/docs/contribute/advanced/#랭글러에게-유용한-github-쿼리)를
+업스트림의 [PR 랭글러에게 유용한 GitHub 쿼리](/docs/contribute/participate/pr-wranglers/#랭글러를-위해-도움이-되는-github-쿼리)를
 기반으로 작성한, 한글화팀의 PR 랭글러에게 유용한 쿼리를 아래에 나열한다.
 
 - [CLA 서명 없음, 병합할 수 없음](https://github.com/kubernetes/website/pulls?q=is%3Aopen+is%3Apr+label%3A%22cncf-cla%3A+no%22+-label%3Ado-not-merge+label%3Alanguage%2Fko)
@@ -121,6 +121,14 @@ content_type: concept
 weight: 10
 ```
 
+### 내부 링크 자동 현지화
+쿠버네티스 웹사이트는 문서 빌드 과정에서 `/docs/~`와 같은 형태의 내부 링크 경로 앞에, 문서의 언어에 맞는 디렉터리 접두사(`/ko`)가 자동으로 추가된다.
+해당 기능은 풀 리퀘스트 [#47620](https://github.com/kubernetes/website/pull/47620)에서 구현되었으며, 2024년 8월에 병합되었다.
+
+따라서, 현지화 문서 작성 시 다음 기준으로 링크 표기를 통일한다.
+* **신규 문서 작성** : 영어 원문의 내부 링크 경로를 변경 없이 유지한다.(단, 앵커 링크의 경우 기존과 같이 한국어에 맞게 수정한다.)
+* **기존 문서 갱신** : 과거에 수동으로 추가한 `/ko` 접두사가 남아있는 경우 이를 제거한다.
+
 ## 용어 한글화 가이드
 
 ### 용어 한글화의 일반적 방침
@@ -199,7 +207,7 @@ API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독
 
 ### 기능 게이트(feature gate) 한글화 방침
 
-쿠버네티스의 [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를
+쿠버네티스의 [기능 게이트](/docs/reference/command-line-tools-reference/feature-gates/)를
 의미하는 용어는 한글화하지 않고 원문 형태를 유지한다.
 
 기능 게이트의 예시는 다음과 같다.
@@ -210,7 +218,7 @@ API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독
 - ...
 
 전체 기능 게이트 목록은
-[여기](/ko/docs/reference/command-line-tools-reference/feature-gates/#feature-gates)를 참고한다.
+[여기](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates)를 참고한다.
 
 {{% note %}}
 단, 해당 원칙에는 예외가 있을 수 있으며, 이 경우에는 가능한
@@ -393,7 +401,7 @@ Node | 노드(Node) | API 오브젝트인 경우
 node lease | 노드 리스(lease)
 Object | 오브젝트 |
 observability | 가시성(observability) |
-Operator | 오퍼레이터 | [쿠버네티스의 소프트웨어 익스텐션](https://kubernetes.io/ko/docs/concepts/extend-kubernetes/operator/)을 의미하는 경우
+Operator | 오퍼레이터 | [쿠버네티스의 소프트웨어 익스텐션](/docs/concepts/extend-kubernetes/operator/)을 의미하는 경우
 Orchestrate | 오케스트레이션하다 |
 Output | 출력 |
 parameter | 파라미터 |

content/ko/docs/contribute/localization_ko_best_practice.md

@@ -157,6 +157,23 @@ content_type: concept
 
 ---
 
+### 내부 링크 현지화 가이드라인
+
+- `[xxx](/docs/~)`와 같은 형태의 내부 링크에 언어 디렉터리 접두사(`/ko`)를 수동으로 추가하지 않는다. (참고: 풀 리퀘스트 [#47620](https://github.com/kubernetes/website/pull/47620)에 의해서 자동화 되었음.)
+  - 기존 문서 수정 과정에서 내부 링크에 `/ko`가 포함되어 있다면 이를 제거한다.
+- 단, 원문의 헤더 제목에 별도의 영문 앵커 링크가 지정되어 있는 경우, 해당 앵커의 참조 링크 구문에서도 기존 영문 표기를 유지한다.
+  헤더 제목에 별도 명시된 영문 앵커가 없고 제목이 한글로 변환되었다면, 헤더 제목에 따라 자동 생성되는 한국어 앵커로 참조 링크 구문도 수정한다.
+
+#### 예시
+
+**[영어 원문]**
+> For more information, see \[Adding and removing issue labels\]\(/docs/contribute/review/for-approvers/#adding-and-removing-issue-labels\).
+
+**[권장 번역]**
+> 자세한 내용은 \[이슈 레이블 추가와 제거\]\(/docs/contribute/review/for-approvers/#이슈-레이블-추가와-제거\)를 참고한다.
+
+---
+
 ## 원문
 
 ### 가급적 원문을 준수함
@@ -213,7 +230,7 @@ content_type: concept
 ### 한글화 용어집에 등록되지 않은 용어
 
 - 쿠버네티스 한글화 팀은 한글화 용어집을 준용하며, 등록되지 않은 용어의 경우 논의를 통해 용어집에 등록할 수 있다.
-- 자세한 내용은 [쿠버네티스 한글화 가이드](/ko/docs/contribute/localization_ko/#용어-한글화-가이드)를 참고한다.
+- 자세한 내용은 [쿠버네티스 한글화 가이드](/docs/contribute/localization_ko/#용어-한글화-가이드)를 참고한다.
 
 #### 참고 링크
 - [용어 논의 관련 사례(#51885)](https://github.com/kubernetes/website/issues/51885#issuecomment-3301329235)
@@ -241,7 +258,7 @@ content_type: concept
 
 ### 쿠버네티스 오브젝트 또는 필드 명칭 번역
 
-- [쿠버네티스 문서 한글화 가이드](/ko/docs/contribute/localization_ko/#api-오브젝트-용어-한글화-방침)에서 api 오브젝트 용어 한글화 방침에 대한 내용을 확인할 수 있다.
+- [쿠버네티스 문서 한글화 가이드](/docs/contribute/localization_ko/#api-오브젝트-용어-한글화-방침)에서 api 오브젝트 용어 한글화 방침에 대한 내용을 확인할 수 있다.
 
 #### 예시
 

content/ko/docs/contribute/new-content/open-a-pr.md

@@ -16,7 +16,7 @@ card:
 {{< /note >}}
 
 새 콘텐츠 페이지를 기여하거나 기존 콘텐츠 페이지를 개선하려면, 풀 리퀘스트(PR)를 연다.
-[시작하기 전에](/ko/docs/contribute/new-content/) 섹션의
+[시작하기 전에](/docs/contribute/new-content/) 섹션의
 모든 요구 사항을 준수해야 한다.
 
 변경 사항이 적거나, git에 익숙하지 않은 경우,
@@ -217,9 +217,9 @@ class changes,changes2 white
    - 기존 콘텐츠를 개선하려면, `upstream/main` 를 사용한다.
    - 기존 기능에 대한 새로운 콘텐츠를 작성하려면, `upstream/main` 를 사용한다.
    - 현지화된 콘텐츠의 경우, 현지화 규칙을 사용한다. 자세한 내용은
-     [쿠버네티스 문서 현지화](/ko/docs/contribute/localization_ko/)를 참고한다.
+     [쿠버네티스 문서 현지화](/docs/contribute/localization_ko/)를 참고한다.
    - 다가오는 쿠버네티스 릴리스의 새로운 기능에 대해서는 기능 브랜치(feature branch)를 사용한다. 자세한 정보는
-     [릴리스 문서화](/ko/docs/contribute/new-content/new-features/)를 참고한다.
+     [릴리스 문서화](/docs/contribute/new-content/new-features/)를 참고한다.
    - 콘텐츠 재구성과 같이 여러 SIG Docs 기여자들이 협업하는 장기적인 작업에는,
      해당 작업을 위해 작성된 특정 기능 브랜치를 사용한다.
 
@@ -430,7 +430,7 @@ PR을 연 후, GitHub는 자동화된 테스트를 실행하고
   직전의 버전(staged version)이 열린다. 이는 리뷰어가 변경 사항을 확인하는 방법이다.
 
 또한 GitHub는 리뷰어에게 도움을 주기 위해 PR에 레이블을 자동으로 할당한다. 필요한 경우 직접 추가할 수도 있다.
-자세한 내용은 [이슈 레이블 추가와 제거](/ko/docs/contribute/review/for-approvers/#이슈-레이블-추가와-제거)를 참고한다.
+자세한 내용은 [이슈 레이블 추가와 제거](/docs/contribute/review/for-approvers/#이슈-레이블-추가와-제거)를 참고한다.
 
 ### 로컬에서 피드백 해결하기
 
@@ -634,5 +634,5 @@ PR의 **Commits** 탭에서 또는 `git log` 명령을 로컬에서 실행하여
 
 ## {{% heading "whatsnext" %}}
 
-- 리뷰 프로세스에 대한 자세한 내용은 [리뷰하기](/ko/docs/contribute/review/reviewing-prs)를 읽어본다.
+- 리뷰 프로세스에 대한 자세한 내용은 [리뷰하기](/docs/contribute/review/reviewing-prs)를 읽어본다.