From b179f54eb809e69ebd4d483a308fd773b58e037f Mon Sep 17 00:00:00 2001
From: Junseong Park <junseongpark.dev@gmail.com>
Date: Wed, 18 Sep 2024 23:28:01 +0900
Subject: [PATCH] i18n(ko-KR): create `asides.mdx` and update
 `authoring-content.mdx` (#2339)

Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
---
 .../src/content/docs/ko/components/asides.mdx | 158 ++++++++++++++++++
 .../docs/ko/guides/authoring-content.mdx      |  18 +-
 2 files changed, 167 insertions(+), 9 deletions(-)
 create mode 100644 docs/src/content/docs/ko/components/asides.mdx

diff --git a/docs/src/content/docs/ko/components/asides.mdx b/docs/src/content/docs/ko/components/asides.mdx
new file mode 100644
index 00000000000..62544d85b16
--- /dev/null
+++ b/docs/src/content/docs/ko/components/asides.mdx
@@ -0,0 +1,158 @@
+---
+title: 보조 내용
+description: Starlight에서 보조 내용을 사용하여 페이지의 주요 콘텐츠와 함께 보조 정보를 표시하는 방법을 알아보세요.
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+페이지의 주요 콘텐츠와 함께 보조 정보를 표시하려면 `<Aside>` 컴포넌트를 사용합니다.
+
+import Preview from '~/components/component-preview.astro';
+
+<Preview>
+
+<Aside slot="preview">
+    필수적이지 않은 보충 정보는 `<Aside>`에 포함하세요.
+</Aside>
+
+</Preview>
+
+## 가져오기
+
+```tsx
+import { Aside } from '@astrojs/starlight/components';
+```
+
+## 사용
+
+`<Aside>` 컴포넌트를 사용하여 보조 내용 (“admonitions” 또는 “callouts”이라고도 함)을 표시합니다.
+
+`<Aside>`에는 보조 내용의 색상, 아이콘 및 기본 제목을 제어하는 선택적 [`type`](#type) 속성이 있을 수 있습니다.
+
+<Preview>
+
+````mdx
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>보조 내용의 콘텐츠입니다.</Aside>
+
+<Aside type="caution">몇 가지 주의해야 할 내용입니다.</Aside>
+
+<Aside type="tip">
+
+보조 내용에는 다른 콘텐츠도 지원됩니다.
+
+```js
+// 예시 코드 스니펫.
+```
+
+</Aside>
+
+<Aside type="danger">비밀번호를 다른 사람에게 알려주지 마세요.</Aside>
+````
+
+<Fragment slot="markdoc">
+
+````markdoc
+{% aside %}
+보조 내용의 콘텐츠입니다.
+{% /aside %}
+
+{% aside type="caution" %}
+몇 가지 주의해야 할 내용입니다.
+{% /aside %}
+
+{% aside type="tip" %}
+보조 내용에는 다른 콘텐츠도 지원됩니다.
+
+```js
+// 예시 코드 스니펫.
+```
+{% /aside %}
+
+{% aside type="danger" %}
+비밀번호를 다른 사람에게 알려주지 마세요.
+{% /aside %}
+````
+
+</Fragment>
+
+<Fragment slot="preview">
+
+    <Aside>보조 내용의 콘텐츠입니다.</Aside>
+
+    <Aside type="caution">몇 가지 주의해야 할 내용입니다.</Aside>
+
+    <Aside type="tip">
+
+    보조 내용에는 다른 콘텐츠도 지원됩니다.
+
+    ```js
+    // 예시 코드 스니펫.
+    ```
+
+    </Aside>
+
+    <Aside type="danger">비밀번호를 다른 사람에게 알려주지 마세요.</Aside>
+
+</Fragment>
+
+</Preview>
+
+Starlight는 또한 `<Aside>` 컴포넌트의 대안으로 Markdown 및 MDX에서 보조 내용을 렌더링하기 위한 사용자 정의 구문을 제공합니다.
+사용자 정의 구문에 대한 자세한 내용은 [“Markdown에서 콘텐츠 작성하기”](/ko/guides/authoring-content/#보조-내용) 가이드를 참조하세요.
+
+### 사용자 정의 제목 사용
+
+[`title`](#title) 속성을 사용하여 보조 내용의 기본 제목을 재정의합니다.
+
+<Preview>
+
+```mdx 'title="조심하세요!"'
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="caution" title="조심하세요!">
+	사용자 정의 제목을 *사용하는* 경고 보조 내용입니다.
+</Aside>
+```
+
+<Fragment slot="markdoc">
+
+```markdoc 'title="조심하세요!"'
+{% aside type="caution" title="조심하세요!" %}
+사용자 정의 제목을 *사용하는* 경고 보조 내용입니다.
+{% /aside %}
+```
+
+</Fragment>
+
+<Aside slot="preview" type="caution" title="조심하세요!">
+	사용자 정의 제목을 *사용하는* 경고 보조 내용입니다.
+</Aside>
+
+</Preview>
+
+## `<Aside>` 속성
+
+**구현:** [`Aside.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/Aside.astro)
+
+`<Aside>` 컴포넌트는 다음과 같은 속성을 허용합니다:
+
+### `type`
+
+**타입:** `'note' | 'tip' | 'caution' | 'danger'`  
+**기본값:** `'note'`
+
+표시할 보조 내용의 유형입니다:
+
+- `note` 보조 내용은 파란색이며 정보 아이콘을 표시합니다 (기본값).
+- `tip` 보조 내용은 보라색이며 로켓 아이콘을 표시합니다.
+- `caution` 보조 내용은 노란색이며 삼각형 경고 아이콘을 표시합니다.
+- `danger` 보조 내용은 빨간색이며 팔각형 경고 아이콘을 표시합니다.
+
+### `title`
+
+**타입:** `string`
+
+표시할 보조 내용의 제목입니다.
+`title`이 설정되어 있지 않으면 현재 보조 내용의 `type`이 기본 제목으로 사용됩니다.
diff --git a/docs/src/content/docs/ko/guides/authoring-content.mdx b/docs/src/content/docs/ko/guides/authoring-content.mdx
index 8898ec66f45..6e826fa4c9f 100644
--- a/docs/src/content/docs/ko/guides/authoring-content.mdx
+++ b/docs/src/content/docs/ko/guides/authoring-content.mdx
@@ -107,15 +107,15 @@ description: Starlight에 내장된 링크를 사용하는 방법
 
 [Astro 공식 문서](https://docs.astro.build/ko/guides/markdown-content/#heading-ids)에서 Astro가 제목의 `id`를 처리하는 방법에 대해 자세히 알아보세요.
 
-## 주석
+## 보조 내용
 
-주석은 "admonitions" 또는 "callouts" 라고도 하며, 페이지의 기본 콘텐츠 주변에 보조 정보를 표시하는 데 유용합니다.
+보조 내용은 "admonitions" 또는 "callouts" 라고도 하며, 페이지의 기본 콘텐츠 주변에 보조 정보를 표시하는 데 유용합니다.
 
-Starlight는 주석 렌더링을 위한 사용자 정의 Markdown 구문을 제공합니다. 주석 블록은 내용을 감싸기 위해 세 개의 콜론 `:::`을 사용하며 `note`, `tip`, `caution` 또는 `danger` 타입일 수 있습니다.
+Starlight는 보조 내용 렌더링을 위한 사용자 정의 Markdown 구문을 제공합니다. 보조 내용 블록은 내용을 감싸기 위해 세 개의 콜론 `:::`을 사용하며 `note`, `tip`, `caution` 또는 `danger` 타입일 수 있습니다.
 
-다른 Markdown 콘텐츠를 주석 안에 중첩시킬 수도 있지만 짧고 간결한 콘텐츠 덩어리에 가장 적합합니다.
+다른 Markdown 콘텐츠를 보조 내용 안에 중첩시킬 수도 있지만 짧고 간결한 콘텐츠 덩어리에 가장 적합합니다.
 
-### Note 주석
+### Note 보조 내용
 
 :::note
 
@@ -138,9 +138,9 @@ npm create astro@latest -- --template starlight
 :::
 ````
 
-### 사용자 정의 주석 제목
+### 사용자 정의 보조 내용 제목
 
-주석 타입 다음에 대괄호를 사용해 주석의 제목을 지정할 수 있습니다. `:::tip[알고 계셨나요?]`
+보조 내용 타입 다음에 대괄호를 사용해 보조 내용의 제목을 지정할 수 있습니다. `:::tip[알고 계셨나요?]`
 
 :::tip[알고 계셨나요?]
 
@@ -153,9 +153,9 @@ Astro는 ["Islands Architecture"](https://docs.astro.build/ko/concepts/islands/)
 :::
 ```
 
-### 더 많은 주석 타입
+### 더 많은 보조 내용 타입
 
-Caution과 Danger 주석은 실수하기 쉬운 세부 사항에 대해 사용자를 집중시키는 데 도움이 됩니다. 이러한 기능을 많이 사용하고 있다면, 문서화중인 내용을 다시 디자인하는 것이 좋습니다.
+Caution과 Danger 보조 내용은 실수하기 쉬운 세부 사항에 대해 사용자를 집중시키는 데 도움이 됩니다. 이러한 기능을 많이 사용하고 있다면, 문서화중인 내용을 다시 디자인하는 것이 좋습니다.
 
 :::caution
 당신이 멋진 문서 사이트를 원하지 않는다면 [Starlight](/ko/)는 필요하지 않을 수도 있습니다.