Skip to content

Commit 12aaecf

Browse files
authored
Merge branch 'main' into kian/add-cf-docs-to-showcase
2 parents 08cd68c + fab0277 commit 12aaecf

16 files changed

Lines changed: 74 additions & 32 deletions

File tree

docs/src/content/docs/fr/guides/customization.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -385,7 +385,7 @@ Il fournit des modules npm que vous pouvez installer pour les polices que vous s
385385
2. Installez le package pour la police choisie.
386386
Vous pouvez trouver le nom du package en cliquant sur "Installer" sur la page de police Fontsource.
387387

388-
<Tabs>
388+
<Tabs syncKey="pkg">
389389

390390
<TabItem label="npm">
391391

docs/src/content/docs/fr/guides/site-search.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Si vous avez accès au [programme DocSearch d'Algolia](https://docsearch.algolia
5252

5353
1. Installez `@astrojs/starlight-docsearch` :
5454

55-
<Tabs>
55+
<Tabs syncKey="pkg">
5656

5757
<TabItem label="npm">
5858

docs/src/content/docs/fr/manual-setup.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Pour suivre ce guide, vous aurez besoin d'un projet Astro existant.
1616

1717
Starlight est une [intégration Astro](https://docs.astro.build/fr/guides/integrations-guide/). Ajoutez-la à votre site en exécutant la commande `astro add` dans le répertoire racine de votre projet :
1818

19-
<Tabs>
19+
<Tabs syncKey="pkg">
2020
<TabItem label="npm">
2121
```sh
2222
npx astro add starlight

docs/src/content/docs/ko/guides/components.mdx

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
9191

9292
`syncKey` 속성을 추가하여 여러 탭 그룹을 동기화된 상태로 유지합니다.
9393

94-
동일한 `syncKey` 값을 가진 페이지의 모든 `<Tabs>`에는 동일한 활성 라벨이 표시됩니다. 이를 통해 독자는 한 번 (예: 운영 체제 또는 패키지 관리자) 선택하고 선택 사항이 페이지 전체에 반영되는 것을 수 있습니다.
94+
`syncKey` 값이 같은 모든 `<Tabs>` 동일한 활성 라벨을 표시합니다. 이렇게 하면 독자가 운영 체제나 패키지 관리자 등을 한 번 선택하면 페이지 탐색 간 선택한 내용이 유지되는 것을 확인할 수 있습니다.
9595

9696
관련 탭을 동기화하려면 각 `<Tabs>` 컴포넌트에 동일한 `syncKey` 속성을 추가하고 모두 동일한 `<TabItem>` 라벨을 사용하는지 확인하세요.
9797

@@ -229,6 +229,38 @@ import { LinkCard } from '@astrojs/starlight/components';
229229
<LinkCard title="컴포넌트" href="/ko/guides/components/" />
230230
</CardGrid>
231231

232+
### 링크 버튼
233+
234+
시각적으로 구분되는 콜투액션 링크에는 `<LinkButton>` 컴포넌트를 사용합니다.
235+
링크 버튼은 가장 관련성이 높거나 실행 가능한 콘텐츠로 사용자를 안내하는 데 유용하며 랜딩 페이지에서 자주 사용됩니다
236+
237+
`<LinkButton>`에는 [`href`](https://developer.mozilla.org/ko/docs/Web/HTML/Element/a#href) 속성이 필요하며, 'target'과 같은 다른 링크 속성을 선택적으로 허용합니다.
238+
239+
`icon` 속성을 [Starlight 내장 아이콘 중 하나](#모든-아이콘)의 이름으로 설정하여 텍스트 옆에 아이콘을 포함할 수 있습니다.
240+
텍스트 앞에 아이콘을 배치하기 위해 `iconPlacement` 속성을 `start`로 설정할 수 있습니다 (기본값은 `end`).
241+
242+
`primary` (기본값), `secondary`, `minimal`로 설정할 수 있는 `variant` 속성을 사용하여 링크 버튼의 모양을 사용자 정의합니다.
243+
244+
```mdx
245+
# src/content/docs/example.mdx
246+
247+
import { LinkButton } from '@astrojs/starlight/components';
248+
249+
<LinkButton href="/ko/getting-started/">시작하기</LinkButton>
250+
<LinkButton href="https://docs.astro.build" variant="secondary" icon="external">
251+
관련: Astro
252+
</LinkButton>
253+
```
254+
255+
위의 코드는 페이지에 다음과 같은 내용을 생성합니다:
256+
257+
import { LinkButton } from '@astrojs/starlight/components';
258+
259+
<LinkButton href="/ko/getting-started/">시작하기</LinkButton>
260+
<LinkButton href="https://docs.astro.build" variant="secondary" icon="external">
261+
관련: Astro
262+
</LinkButton>
263+
232264
### 주석
233265

234266
“권고” 또는 “콜아웃”이라고도 하는 '주석'은 페이지의 기본 콘텐츠 옆에 보조 정보를 표시하는 데 유용합니다.

docs/src/content/docs/ko/guides/customization.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -370,7 +370,7 @@ Starlight 사이트에 사용자 정의 글꼴을 추가해야 하는 경우,
370370

371371
2. 선택한 글꼴에 대한 패키지를 설치합니다. Fontsource 글꼴 페이지에서 “Install”을 클릭하면 패키지 이름을 찾을 수 있습니다.
372372

373-
<Tabs>
373+
<Tabs syncKey="pkg">
374374

375375
<TabItem label="npm">
376376

docs/src/content/docs/ko/guides/pages.mdx

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -109,26 +109,25 @@ Markdown 페이지의 프론트매터와 유사하게 이 페이지에 대한 [
109109

110110
##### `sidebar`
111111

112-
**타입:** `SidebarEntry[]`
112+
**타입:** [`SidebarItem[]`](/ko/reference/configuration/#sidebaritem)
113113
**기본값:** [전역 `sidebar` 구성](/ko/reference/configuration/#sidebar)을 기반으로 생성된 사이드바
114114

115115
이 페이지에 대한 사용자 정의 사이트 탐색 사이드바를 제공합니다.
116116
설정하지 않으면 페이지에서 기본 전역 사이드바를 사용합니다.
117117

118-
예를 들어, 다음 페이지는 홈페이지 링크와 다양한 별자리에 대한 링크 그룹으로 기본 사이드바를 재정의합니다.
119-
사이드바의 현재 페이지는 `isCurrent` 속성을 사용하여 설정되었으며 선택적인 `badge`가 링크 항목에 추가되었습니다.
118+
예를 들어, 다음 페이지는 홈페이지 링크와 다양한 다른 사용자 지정 페이지로 연결되는 링크 그룹으로 기본 사이드바를 재정의합니다.
120119

121120
```astro {3-13}
122121
<StarlightPage
123122
frontmatter={{ title: '오리온' }}
124123
sidebar={[
125-
{ label: '홈', href: '/' },
124+
{ label: '홈', link: '/' },
126125
{
127126
label: '별자리',
128127
items: [
129-
{ label: '안드로메다', href: '/andromeda/' },
130-
{ label: '오리온', href: '/orion/', isCurrent: true },
131-
{ label: '작은곰자리', href: '/ursa-minor/', badge: 'Stub' },
128+
{ label: '안드로메다', link: '/andromeda/' },
129+
{ label: '오리온', link: '/orion/' },
130+
{ label: '작은곰자리', link: '/ursa-minor/', badge: 'Stub' },
132131
],
133132
},
134133
]}
@@ -137,38 +136,40 @@ Markdown 페이지의 프론트매터와 유사하게 이 페이지에 대한 [
137136
</StarlightPage>
138137
```
139138

139+
사이드바를 사용자 정의하기 위해 사용할 수 있는 옵션에 대해 자세히 알아보려면 [“사이드바 탐색”](/ko/guides/sidebar/) 가이드를 참조하세요.
140+
140141
##### `hasSidebar`
141142

142-
**타입:** `boolean`
143+
**타입:** `boolean`
143144
**기본값:** [`frontmatter.template`](/ko/reference/frontmatter/#template)의 값이 `'splash'`라면 `false`, 그렇지 않다면 `true`
144145

145146
이 페이지에 사이드바를 표시할지 여부를 제어합니다.
146147

147148
##### `headings`
148149

149-
**타입:** `{ depth: number; slug: string; text: string }[]`
150+
**타입:** `{ depth: number; slug: string; text: string }[]`
150151
**기본값:** `[]`
151152

152153
이 페이지의 모든 제목 배열을 제공하세요.
153154
제공된 경우 Starlight는 이 제목에서 페이지 목차를 생성합니다.
154155

155156
##### `dir`
156157

157-
**타입:** `'ltr' | 'rtl'`
158+
**타입:** `'ltr' | 'rtl'`
158159
**기본값:** 현재 로케일의 쓰기 방향
159160

160161
이 페이지 콘텐츠의 쓰기 방향을 설정합니다.
161162

162163
##### `lang`
163164

164-
**타입:** `string`
165+
**타입:** `string`
165166
**기본값:** 현재 로케일의 언어
166167

167168
이 페이지 콘텐츠에 대해 BCP-47 언어 태그를 설정합니다. 예: `en`, `zh-CN` 또는 `pt-BR`.
168169

169170
##### `isFallback`
170171

171-
**타입:** `boolean`
172+
**타입:** `boolean`
172173
**기본값:** `false`
173174

174175
현재 언어에 대한 번역이 존재하지 않아 이 페이지가 [대체 콘텐츠](/ko/guides/i18n/#대체-콘텐츠)를 사용하고 있는지 표시합니다.

docs/src/content/docs/ko/guides/site-search.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ title: 부분적으로 색인이 생성된 페이지
5252

5353
1. `@astrojs/starlight-docsearch`를 설치합니다.
5454

55-
<Tabs>
55+
<Tabs syncKey="pkg">
5656

5757
<TabItem label="npm">
5858

docs/src/content/docs/ko/index.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,10 @@ hero:
1515
actions:
1616
- text: 시작하기
1717
icon: right-arrow
18-
variant: primary
1918
link: /ko/getting-started/
2019
- text: GitHub에서 보기
2120
icon: external
21+
variant: minimal
2222
link: https://github.com/withastro/starlight
2323
---
2424

@@ -67,8 +67,9 @@ import Testimonial from '~/components/testimonial.astro';
6767
cite="https://twitter.com/sulco/status/1735610348730802342"
6868
>
6969
Starlight는 훌륭한 DX의 대표적인 예시입니다. 속도, 편리함, 세부 사항에 대한 관심이 인상적입니다. 기술과 디자인을 모두 관리하므로 콘텐츠에 집중할 수 있습니다 👏
70-
70+
7171
StackBlitz 팀은 이 프로젝트를 정말 좋아합니다!
72+
7273
</Testimonial>
7374
<Testimonial
7475
name="Roberto"

docs/src/content/docs/ko/manual-setup.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
1515

1616
Starlight는 [Astro 통합](https://docs.astro.build/ko/guides/integrations-guide/)입니다. 사이트에 이를 추가하기 위해 프로젝트의 루트 디렉터리에서 `astro add` 명령을 실행하세요.
1717

18-
<Tabs>
18+
<Tabs syncKey="pkg">
1919
<TabItem label="npm">
2020
```sh
2121
npx astro add starlight

docs/src/content/docs/ko/reference/frontmatter.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -113,10 +113,10 @@ hero:
113113
- text: 더보기
114114
link: /getting-started/
115115
icon: right-arrow
116-
variant: primary
117116
- text: Github에서 보기
118117
link: https://github.com/astronaut/my-project
119118
icon: external
119+
variant: minimal
120120
attrs:
121121
rel: me
122122
---
@@ -164,8 +164,8 @@ interface HeroConfig {
164164
actions?: Array<{
165165
text: string;
166166
link: string;
167-
variant: 'primary' | 'secondary' | 'minimal';
168-
icon: string;
167+
variant?: 'primary' | 'secondary' | 'minimal';
168+
icon?: string;
169169
attrs?: Record<string, string | number | boolean>;
170170
}>;
171171
}

0 commit comments

Comments
 (0)