summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJunseong Park2025-07-17 16:53:16 +0900
committerGitHub2025-07-17 09:53:16 +0200
commit4e4808dddeec6d850e99db2268bad0b62c2a681d (patch)
treefc7aa28267c242523549ad61442b6d37dab81c7e
parent23fc6bfe458e57f7f6de17514dfb2bac36a38605 (diff)
downloadIT.starlight-4e4808dddeec6d850e99db2268bad0b62c2a681d.tar.gz
IT.starlight-4e4808dddeec6d850e99db2268bad0b62c2a681d.tar.bz2
IT.starlight-4e4808dddeec6d850e99db2268bad0b62c2a681d.zip
i18n(ko-KR): update `sidebar.mdx`, `frontmatter.md` (#3321)
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
-rw-r--r--docs/src/content/docs/ko/guides/sidebar.mdx82
-rw-r--r--docs/src/content/docs/ko/reference/frontmatter.md1
2 files changed, 75 insertions, 8 deletions
diff --git a/docs/src/content/docs/ko/guides/sidebar.mdx b/docs/src/content/docs/ko/guides/sidebar.mdx
index fae5dd29..28000960 100644
--- a/docs/src/content/docs/ko/guides/sidebar.mdx
+++ b/docs/src/content/docs/ko/guides/sidebar.mdx
@@ -91,9 +91,9 @@ starlight({
]}
/>
-링크된 νŽ˜μ΄μ§€μ˜ ν”„λ‘ νŠΈλ§€ν„°μ—μ„œ μΆ”λ‘ λœ 값을 μž¬μ •μ˜ν•˜κΈ° μœ„ν•΄ `label`, [`translations`](#κ΅­μ œν™”) 및 [`attrs`](#μ‚¬μš©μž-μ •μ˜-html-속성) 속성을 μΆ”κ°€ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
+링크된 νŽ˜μ΄μ§€μ˜ ν”„λŸ°νŠΈλ§€ν„°μ—μ„œ μΆ”λ‘ λœ 값을 μž¬μ •μ˜ν•˜κΈ° μœ„ν•΄ `label`, [`translations`](#κ΅­μ œν™”) 및 [`attrs`](#μ‚¬μš©μž-μ •μ˜-html-속성) 속성을 μΆ”κ°€ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
-νŽ˜μ΄μ§€ ν”„λ‘ νŠΈλ§€ν„°μ—μ„œ μ‚¬μ΄λ“œλ°” λͺ¨μ–‘을 μ œμ–΄ν•˜λŠ” ​​방법에 λŒ€ν•œ μžμ„Έν•œ λ‚΄μš©μ€ ["μžλ™ μƒμ„±λœ 링크 μ‚¬μš©μž μ •μ˜"](#ν”„λ‘ νŠΈλ§€ν„°μ—μ„œ-μžλ™-μƒμ„±λœ-링크-μ‚¬μš©μž-μ •μ˜)λ₯Ό μ°Έμ‘°ν•˜μ„Έμš”.
+νŽ˜μ΄μ§€ ν”„λŸ°νŠΈλ§€ν„°μ—μ„œ μ‚¬μ΄λ“œλ°” λͺ¨μ–‘을 μ œμ–΄ν•˜λŠ” 방법에 λŒ€ν•œ μžμ„Έν•œ λ‚΄μš©μ€ ["μžλ™ μƒμ„±λœ 링크 μ‚¬μš©μž μ •μ˜"](#ν”„λŸ°νŠΈλ§€ν„°μ—μ„œ-μžλ™-μƒμ„±λœ-링크-μ‚¬μš©μž-μ •μ˜)λ₯Ό μ°Έμ‘°ν•˜μ„Έμš”.
#### λ‚΄λΆ€ 링크의 μ•½μ–΄
@@ -236,11 +236,11 @@ starlight({
]}
/>
-## ν”„λ‘ νŠΈλ§€ν„°μ—μ„œ μžλ™ μƒμ„±λœ 링크 μ‚¬μš©μž μ •μ˜
+## ν”„λŸ°νŠΈλ§€ν„°μ—μ„œ μžλ™ μƒμ„±λœ 링크 μ‚¬μš©μž μ •μ˜
-μžλ™μœΌλ‘œ μƒμ„±λœ 링크λ₯Ό λ³€κ²½ν•˜λ €λ©΄ κ°œλ³„ νŽ˜μ΄μ§€μ˜ [`sidebar` ν”„λ‘ νŠΈλ§€ν„° ν•„λ“œ](/ko/reference/frontmatter/#sidebar)λ₯Ό μ‚¬μš©ν•˜μ„Έμš”.
+μžλ™μœΌλ‘œ μƒμ„±λœ 링크λ₯Ό λ³€κ²½ν•˜λ €λ©΄ κ°œλ³„ νŽ˜μ΄μ§€μ˜ [`sidebar` ν”„λŸ°νŠΈλ§€ν„° ν•„λ“œ](/ko/reference/frontmatter/#sidebar)λ₯Ό μ‚¬μš©ν•˜μ„Έμš”.
-ν”„λ‘ νŠΈλ§€ν„°μ—μ„œ sidebar μ˜΅μ…˜μ„ μ‚¬μš©ν•˜λ©΄ [μ‚¬μš©μž μ •μ˜ 라벨](/ko/reference/frontmatter/#label)을 μ„€μ •ν•˜κ±°λ‚˜ 링크에 [λ°°μ§€](/ko/reference/frontmatter/#badge)λ₯Ό μΆ”κ°€ν•˜κ±°λ‚˜ μ‚¬μ΄λ“œλ°”μ—μ„œ 링크λ₯Ό [μˆ¨κΈ°κ±°λ‚˜](/ko/reference/frontmatter/#hidden) [μ‚¬μš©μž μ •μ˜ μ •λ ¬ κΈ°μ€€](/ko/reference/frontmatter/#order)을 μ„€μ •ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
+ν”„λŸ°νŠΈλ§€ν„°μ—μ„œ sidebar μ˜΅μ…˜μ„ μ‚¬μš©ν•˜λ©΄ [μ‚¬μš©μž μ •μ˜ 라벨](/ko/reference/frontmatter/#label)을 μ„€μ •, [μ‚¬μš©μž μ •μ˜ 속성](/ko/reference/frontmatter/#attrs) μ‚¬μš©, 링크에 [λ°°μ§€](/ko/reference/frontmatter/#badge) μΆ”κ°€, μ‚¬μ΄λ“œλ°”μ—μ„œ 링크λ₯Ό [μˆ¨κΈ°κ±°λ‚˜](/ko/reference/frontmatter/#hidden) [μ‚¬μš©μž μ •μ˜ μ •λ ¬ κΈ°μ€€](/ko/reference/frontmatter/#order)을 μ •μ˜ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
```md "sidebar:"
---
@@ -258,7 +258,7 @@ sidebar:
---
```
-μœ„ ν”„λ‘ νŠΈλ§€ν„°κ°€ μžˆλŠ” νŽ˜μ΄μ§€λ₯Ό ν¬ν•¨ν•˜λŠ” μžλ™ 생성 그룹은 λ‹€μŒ μ‚¬μ΄λ“œλ°”λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€.
+μœ„ ν”„λŸ°νŠΈλ§€ν„°κ°€ μžˆλŠ” νŽ˜μ΄μ§€λ₯Ό ν¬ν•¨ν•˜λŠ” μžλ™ 생성 그룹은 λ‹€μŒ μ‚¬μ΄λ“œλ°”λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€.
<SidebarPreview
config={[
@@ -278,7 +278,7 @@ sidebar:
/>
:::note
-`sidebar` ν”„λ‘ νŠΈλ§€ν„° ꡬ성은 `slug` μ†μ„±μœΌλ‘œ μ •μ˜λœ μžλ™μœΌλ‘œ μƒμ„±λœ 그룹의 링크 및 λ¬Έμ„œ λ§ν¬μ—λ§Œ μ‚¬μš©λ©λ‹ˆλ‹€. `link` μ†μ„±μœΌλ‘œ μ •μ˜λœ λ§ν¬μ—λŠ” μ μš©λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
+`sidebar` ν”„λŸ°νŠΈλ§€ν„° ꡬ성은 `slug` μ†μ„±μœΌλ‘œ μ •μ˜λœ μžλ™μœΌλ‘œ μƒμ„±λœ 그룹의 링크 및 λ¬Έμ„œ λ§ν¬μ—λ§Œ μ‚¬μš©λ©λ‹ˆλ‹€. `link` μ†μ„±μœΌλ‘œ μ •μ˜λœ λ§ν¬μ—λŠ” μ μš©λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
:::
## λ°°μ§€
@@ -434,6 +434,72 @@ starlight({
]}
/>
+### μžλ™ 생성 링크의 μ‚¬μš©μž μ •μ˜ HTML 속성
+
+`autogenerate` κ΅¬μ„±μ˜ `attrs` 속성을 μ •μ˜ν•˜μ—¬ [μžλ™ 생성 κ·Έλ£Ή](#μžλ™-생성-κ·Έλ£Ή)에 μžˆλŠ” λͺ¨λ“  링크의 HTML 속성을 μ‚¬μš©μž μ •μ˜ν•©λ‹ˆλ‹€.
+κ°œλ³„ νŽ˜μ΄μ§€μ—μ„œλŠ” [`sidebar.attrs` ν”„λŸ°νŠΈλ§€ν„° ν•„λ“œ](/ko/reference/frontmatter/#attrs)λ₯Ό μ‚¬μš©ν•˜μ—¬ μ‚¬μš©μž μ •μ˜ 속성을 μ§€μ •ν•  수 있으며, μ΄λŠ” `autogenerate.attrs` ꡬ성과 λ³‘ν•©λ©λ‹ˆλ‹€.
+
+예λ₯Ό λ“€μ–΄, λ‹€μŒκ³Ό 같은 ꡬ성을 μ‚¬μš©ν•  수 μžˆμŠ΅λ‹ˆλ‹€.
+
+```js {9}
+starlight({
+ sidebar: [
+ {
+ label: 'λ³„μžλ¦¬',
+ autogenerate: {
+ // 'constellations' 디렉터리에 λŒ€ν•œ 링크 그룹을 μžλ™μœΌλ‘œ μƒμ„±ν•©λ‹ˆλ‹€.
+ directory: 'constellations',
+ // 이 그룹의 λͺ¨λ“  링크 라벨을 μ΄νƒ€λ¦­μ²΄λ‘œ ν‘œμ‹œν•©λ‹ˆλ‹€.
+ attrs: { style: 'font-style: italic' },
+ },
+ },
+ ],
+});
+```
+
+그리고 파일 κ΅¬μ‘°λŠ” λ‹€μŒκ³Ό κ°™μŠ΅λ‹ˆλ‹€.
+
+<FileTree>
+
+- src/
+ - content/
+ - docs/
+ - constellations/
+ - carina.md
+ - centaurus.md
+ - seasonal/
+ - andromeda.md
+
+</FileTree>
+
+λ‹€μŒκ³Ό 같이 λͺ¨λ“  μžλ™ 생성 링크가 μ΄νƒ€λ¦­μ²΄λ‘œ ν‘œμ‹œλœ μ‚¬μ΄λ“œλ°”κ°€ μƒμ„±λ©λ‹ˆλ‹€.
+
+<SidebarPreview
+ config={[
+ {
+ label: 'λ³„μžλ¦¬',
+ items: [
+ { label: '용골자리', link: '', attrs: { style: 'font-style: italic' } },
+ {
+ label: 'μΌ„νƒ€μš°λ£¨μŠ€',
+ link: '',
+ attrs: { style: 'font-style: italic' },
+ },
+ {
+ label: 'seasonal',
+ items: [
+ {
+ label: 'μ•ˆλ“œλ‘œλ©”λ‹€',
+ link: '',
+ attrs: { style: 'font-style: italic' },
+ },
+ ],
+ },
+ ],
+ },
+ ]}
+/>
+
## κ΅­μ œν™”
[BCP-47](https://www.w3.org/International/questions/qa-choosing-language-tags) μ–Έμ–΄ νƒœκ·Έλ₯Ό μ§€μ •ν•˜μ—¬ μ§€μ›λ˜λŠ” 각 언어에 λŒ€ν•œ 링크 λ˜λŠ” κ·Έλ£Ή 라벨을 λ²ˆμ—­ν•˜λ €λ©΄ 링크 및 κ·Έλ£Ή ν•­λͺ©μ˜ `translations` 속성을 μ‚¬μš©ν•˜μ„Έμš”. `"en"`, `"ar"` λ˜λŠ” `"zh-CN"`을 ν‚€λ‘œ, λ²ˆμ—­λœ 라벨을 κ°’μœΌλ‘œ μ‚¬μš©ν•©λ‹ˆλ‹€.
@@ -484,7 +550,7 @@ starlight({
### λ‚΄λΆ€ 링크 κ΅­μ œν™”
-[λ‚΄λΆ€ 링크](#λ‚΄λΆ€-링크)λŠ” 기본적으둜 μ½˜ν…μΈ  ν”„λ‘ νŠΈλ§€ν„°μ˜ λ²ˆμ—­λœ νŽ˜μ΄μ§€ 제λͺ©μ„ μžλ™μœΌλ‘œ μ‚¬μš©ν•©λ‹ˆλ‹€.
+[λ‚΄λΆ€ 링크](#λ‚΄λΆ€-링크)λŠ” 기본적으둜 μ½˜ν…μΈ  ν”„λŸ°νŠΈλ§€ν„°μ˜ λ²ˆμ—­λœ νŽ˜μ΄μ§€ 제λͺ©μ„ μžλ™μœΌλ‘œ μ‚¬μš©ν•©λ‹ˆλ‹€.
```js {9-10}
starlight({
diff --git a/docs/src/content/docs/ko/reference/frontmatter.md b/docs/src/content/docs/ko/reference/frontmatter.md
index fa7302ec..598d866b 100644
--- a/docs/src/content/docs/ko/reference/frontmatter.md
+++ b/docs/src/content/docs/ko/reference/frontmatter.md
@@ -381,6 +381,7 @@ sidebar:
**νƒ€μž…:** `Record<string, string | number | boolean | undefined>`
μ‚¬μ΄λ“œλ°”μ—μ„œ μžλ™ μƒμ„±λœ 링크 그룹을 μ‚¬μš©ν•  λ•Œ, 이 νŽ˜μ΄μ§€μ˜ 링크에 μΆ”κ°€ν•  HTML 속성을 μ„€μ •ν•©λ‹ˆλ‹€.
+이 νŽ˜μ΄μ§€κ°€ μ†ν•œ μžλ™ 생성 그룹에 [`autogenerate.attrs`](/ko/guides/sidebar/#μžλ™-생성-링크의-μ‚¬μš©μž-μ •μ˜-html-속성)κ°€ μ„€μ •λ˜μ–΄ 있으면 ν”„λŸ°νŠΈλ§€ν„° 속성이 κ·Έλ£Ή 속성과 λ³‘ν•©λ©λ‹ˆλ‹€.
```md
---