i18n(ko-KR): update 3 Korean documents (#3127)

author: Junseong Park 2025-04-16 21:00:37 +0900
committer: GitHub 2025-04-16 14:00:37 +0200
commit: d3340d4a28673fec5700c31f9505ddb9e2a40cce (patch)
tree: b00a3fecb3003a1a476319aaa1637405f846da98
parent: 3cd02f3b1cf8fac79341de61fb18fd9951b1d261 (diff)
download: IT.starlight-d3340d4a28673fec5700c31f9505ddb9e2a40cce.tar.gz
IT.starlight-d3340d4a28673fec5700c31f9505ddb9e2a40cce.tar.bz2
IT.starlight-d3340d4a28673fec5700c31f9505ddb9e2a40cce.zip
3 files changed, 98 insertions, 4 deletions
diff --git a/docs/src/content/docs/ko/guides/authoring-content.mdx b/docs/src/content/docs/ko/guides/authoring-content.mdx
index 57e49296..83c6f11e 100644
--- a/docs/src/content/docs/ko/guides/authoring-content.mdx
+++ b/docs/src/content/docs/ko/guides/authoring-content.mdx
@@ -647,3 +647,21 @@ yarn create astro --template starlight/markdoc
 </Steps>
 
 Markdoc 구문 및 기능에 대한 자세한 내용은 [Markdoc 문서](https://markdoc.dev/docs/syntax) 또는 [Astro Markdoc 통합 가이드](https://docs.astro.build/ko/guides/integrations-guide/markdoc/)를 참조하세요.
+
+### Markdoc 프리셋 구성
+
+다음은 `starlightMarkdoc()` 프리셋이 허용하는 구성 옵션입니다.
+
+#### `headingLinks`
+
+**타입:** `boolean`  
+**기본값:** `true`
+
+제목이 클릭 가능한 앵커 링크와 함께 렌더링될지 여부를 제어합니다. Markdown 및 MDX 파일에 적용되는 [`markdown.headingLinks`](/ko/reference/configuration/#markdown) 옵션과 동일합니다.
+
+```js "headingLinks: false"
+export default defineMarkdocConfig({
+	// 기본 제목 앵커 링크 지원을 비활성화합니다.
+	extends: [starlightMarkdoc({ headingLinks: false })],
+});
+```
diff --git a/docs/src/content/docs/ko/guides/pages.mdx b/docs/src/content/docs/ko/guides/pages.mdx
index 705569d0..12ff5794 100644
--- a/docs/src/content/docs/ko/guides/pages.mdx
+++ b/docs/src/content/docs/ko/guides/pages.mdx
@@ -3,6 +3,8 @@ title: 페이지
 description: Starlight를 사용하여 문서 사이트의 페이지를 만들고 관리하는 방법을 알아보세요.
 sidebar:
   order: 1
+tableOfContents:
+  maxHeadingLevel: 4
 ---
 
 Starlight는 Markdown Frontmatter를 통해 제공되는 유연한 옵션을 사용하여 콘텐츠를 기반으로 사이트의 HTML 페이지를 생성합니다.
@@ -73,28 +75,49 @@ description: 이것은 내 Starlight 기반 사이트의 페이지입니다.
 
 ### 사용자 정의 페이지에서 Starlight 디자인 사용
 
-사용자 정의 페이지에서 Starlight 레이아웃을 사용하려면 `<StarlightPage />` 컴포넌트로 페이지 콘텐츠를 감싸세요.
+사용자 정의 페이지에서 Starlight 레이아웃을 사용하려면 [`<StarlightPage>` 컴포넌트](#starlightpage-컴포넌트)로 페이지 콘텐츠를 감싸세요.
 이는 콘텐츠를 동적으로 생성하지만 여전히 Starlight의 디자인을 사용하려는 경우 유용할 수 있습니다.
 
+사용자 정의 페이지에서 [`<AnchorHeading>` 컴포넌트](#anchorheading-컴포넌트)를 사용하여 Starlight의 Markdown 앵커 링크 스타일과 일치하는 앵커 링크를 제목에 추가할 수 있습니다.
+
 ```astro
 ---
 // src/pages/custom-page/example.astro
 import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import AnchorHeading from '@astrojs/starlight/components/AnchorHeading.astro';
 import CustomComponent from './CustomComponent.astro';
 ---
 
 <StarlightPage frontmatter={{ title: '사용자 정의 페이지' }}>
-	<p>이것은 사용자 정의 컴포넌트가 있는 사용자 정의 페이지입니다.</p>
+	<p>사용자 정의 컴포넌트가 있는 사용자 정의 페이지입니다.</p>
 	<CustomComponent />
+	
+	<AnchorHeading level="2" id="learn-more">자세히 알아보기</AnchorHeading>
+	<p>
+		<a href="https://starlight.astro.build/">Starlight 문서에서 자세히 알아보기</a>
+	</p>
 </StarlightPage>
 ```
 
-#### Props
+#### `<StarlightPage>` 컴포넌트
+
+`<StarlightPage />` 컴포넌트는 Starlight의 레이아웃과 스타일을 사용하여 전체 페이지 콘텐츠를 렌더링합니다.
+
+```astro
+---
+import StarlightPage from '@astrojs/starlight/components/AnchorHeading.astro';
+---
+
+<StarlightPage frontmatter={{ title: '사용자 정의 페이지' }}>
+	<!-- 사용자 정의 페이지 콘텐츠 -->
+</StarlightPage>
+```
 
 `<StarlightPage />` 컴포넌트는 다음 props를 허용합니다.
 
-##### `frontmatter` (필수)
+##### `frontmatter`
 
+**필수**  
 **타입:** `StarlightPageFrontmatter`
 
 Markdown 페이지의 프론트매터와 유사하게 이 페이지에 대한 [프론트매터 속성](/ko/reference/frontmatter/)을 설정합니다.
@@ -173,3 +196,33 @@ Markdown 페이지의 프론트매터와 유사하게 이 페이지에 대한 [�
 **기본값:** `false`
 
 현재 언어에 대한 번역이 존재하지 않아 이 페이지가 [대체 콘텐츠](/ko/guides/i18n/#대체-콘텐츠)를 사용하고 있는지 표시합니다.
+
+#### `<AnchorHeading>` 컴포넌트
+
+`<AnchorHeading />` 컴포넌트는 Starlight의 Markdown 스타일과 일치하는 클릭 가능한 앵커 링크가 있는 HTML 제목 요소를 렌더링합니다.
+
+```astro
+---
+import AnchorHeading from '@astrojs/starlight/components/AnchorHeading.astro';
+---
+
+<AnchorHeading level="2" id="sub-heading">하위 제목</AnchorHeading>
+```
+
+이 컴포넌트는 다음과 같은 props 뿐만 아니라 다른 유효한 [전역 HTML 속성](https://developer.mozilla.org/ko/docs/Web/HTML/Reference/Global_attributes)도 허용합니다.
+
+##### `level`
+
+**필수**  
+**타입:** `1 | 2 | 3 | 4 | 5 | 6`
+
+렌더링할 제목 수준입니다.
+예를 들어, `level="1"`은 `<h1>` 요소를 렌더링합니다.
+
+##### `id`
+
+**필수**  
+**타입:** `string`
+
+이 제목의 고유 ID입니다.
+이는 렌더링된 제목의 `id` 속성으로 사용되며, 앵커 아이콘은 이 ID로 연결됩니다.
diff --git a/docs/src/content/docs/ko/reference/configuration.mdx b/docs/src/content/docs/ko/reference/configuration.mdx
index e73320a4..df71387d 100644
--- a/docs/src/content/docs/ko/reference/configuration.mdx
+++ b/docs/src/content/docs/ko/reference/configuration.mdx
@@ -377,6 +377,29 @@ starlight({
 });
 ```
 
+### `markdown`
+
+**타입:** `{ headingLinks?: boolean }`  
+**기본값:** `{ headingLinks: true }`
+
+Starlight의 Markdown 처리를 구성합니다.
+
+#### `headingLinks`
+
+**타입:** `boolean`  
+**기본값:** `true`
+
+제목이 클릭 가능한 앵커 링크와 함께 렌더링될지 여부를 제어합니다.
+
+```js
+starlight({
+	markdown: {
+		// Starlight의 클릭 가능한 제목 앵커 링크를 비활성화합니다.
+		headingLinks: false,
+	},
+}),
+```
+
 ### `expressiveCode`
 
 **타입:** `StarlightExpressiveCodeOptions | boolean`
author	Junseong Park	2025-04-16 21:00:37 +0900
committer	GitHub	2025-04-16 14:00:37 +0200
commit	d3340d4a28673fec5700c31f9505ddb9e2a40cce (patch)
tree	b00a3fecb3003a1a476319aaa1637405f846da98
parent	3cd02f3b1cf8fac79341de61fb18fd9951b1d261 (diff)
download	IT.starlight-d3340d4a28673fec5700c31f9505ddb9e2a40cce.tar.gz IT.starlight-d3340d4a28673fec5700c31f9505ddb9e2a40cce.tar.bz2 IT.starlight-d3340d4a28673fec5700c31f9505ddb9e2a40cce.zip