1
1
---
2
- title : 프론트매터 참조
3
- description : Starlight가 지원하는 기본 프론트매터 필드에 대한 개요입니다.
2
+ title : 프런트매터 참조
3
+ description : Starlight가 지원하는 기본 프런트매터 필드에 대한 개요입니다.
4
4
---
5
5
6
- 프론트매터의 값을 설정하여 Starlight에서 개별 Markdown 및 MDX 페이지를 변경할 수 있습니다. 예를 들어 일반 페이지에서는 ` title ` 및 ` description ` 필드를 설정할 수 있습니다.
6
+ 프런트매터의 값을 설정하여 Starlight에서 개별 Markdown 및 MDX 페이지를 변경할 수 있습니다. 예를 들어 일반 페이지에서는 ` title ` 및 ` description ` 필드를 설정할 수 있습니다.
7
7
8
8
``` md {3-4}
9
9
---
@@ -15,7 +15,7 @@ description: 내가 진행 중인 프로젝트에 대해 자세히 알아보세
15
15
나를 소개하는 페이지에 오신 것을 환영합니다!
16
16
```
17
17
18
- ## 프론트매터 필드
18
+ ## 프런트매터 필드
19
19
20
20
### ` title ` (필수)
21
21
@@ -33,7 +33,7 @@ description: 내가 진행 중인 프로젝트에 대해 자세히 알아보세
33
33
34
34
** 타입** : ` string `
35
35
36
- 페이지의 슬러그를 재정의합니다. 자세한 내용은 Astro 공식문서의 [ “사용자 정의 슬러그 정의”] ( https://docs.astro.build/ko/guides/content-collections/#defining-custom-slugs ) 를 참조하세요.
36
+ 페이지의 슬러그를 재정의합니다. 자세한 내용은 Astro 공식문서의 [ “사용자 지정 ID 정의”] ( https://docs.astro.build/ko/guides/content-collections/#사용자-지정-id-정의 ) 를 참조하세요.
37
37
38
38
### ` editUrl `
39
39
@@ -45,7 +45,7 @@ description: 내가 진행 중인 프로젝트에 대해 자세히 알아보세
45
45
46
46
** 타입:** [ ` HeadConfig[] ` ] ( /ko/reference/configuration/#headconfig )
47
47
48
- ` head ` 프론트매터 필드를 사용하여 페이지의 ` <head> ` 에 태그를 추가할 수 있습니다. 이는 사용자 정의 스타일, 메타데이터 또는 기타 태그를 단일 페이지에 추가할 수 있음을 의미합니다. [ 전역 ` head ` 옵션] ( /ko/reference/configuration/#head ) 과 유사합니다.
48
+ ` head ` 프런트매터 필드를 사용하여 페이지의 ` <head> ` 에 태그를 추가할 수 있습니다. 이는 사용자 정의 스타일, 메타데이터 또는 기타 태그를 단일 페이지에 추가할 수 있음을 의미합니다. [ 전역 ` head ` 옵션] ( /ko/reference/configuration/#head ) 과 유사합니다.
49
49
50
50
``` md
51
51
---
@@ -390,21 +390,22 @@ sidebar:
390
390
---
391
391
```
392
392
393
- ## 프런트매터 스키마 맞춤설정
393
+ ## 프런트매터 스키마 사용자 정의
394
394
395
- Starlight의 ` docs ` 콘텐츠 컬렉션에 대한 프런트매터 스키마는 ` docsSchema() ` 도우미를 사용하여 ` src/content/ config.ts ` 에 구성됩니다.
395
+ Starlight의 ` docs ` 콘텐츠 컬렉션에 대한 프런트매터 스키마는 ` docsSchema() ` 도우미를 사용하여 ` src/content. config.ts ` 에 구성됩니다.
396
396
397
- ``` ts {3,6 }
398
- // src/content/ config.ts
397
+ ``` ts {4,7 }
398
+ // src/content. config.ts
399
399
import { defineCollection } from ' astro:content' ;
400
+ import { docsLoader , i18nLoader } from ' @astrojs/starlight/loaders' ;
400
401
import { docsSchema } from ' @astrojs/starlight/schema' ;
401
402
402
403
export const collections = {
403
- docs: defineCollection ({ schema: docsSchema () }),
404
+ docs: defineCollection ({ loader: docsLoader (), schema: docsSchema () }),
404
405
};
405
406
```
406
407
407
- Astro 공식문서의 [ "컬렉션 스키마 정의"] ( https://docs.astro.build/ko/guides/content-collections/#defining-a-collection-schema ) 에서 콘텐츠 컬렉션 스키마에 대해 자세히 알아보세요.
408
+ Astro 공식문서의 [ "컬렉션 스키마 정의"] ( https://docs.astro.build/ko/guides/content-collections/#컬렉션-스키마-정의 ) 에서 콘텐츠 컬렉션 스키마에 대해 자세히 알아보세요.
408
409
409
410
` docsSchema() ` 는 다음 옵션을 사용합니다:
410
411
@@ -414,17 +415,19 @@ Astro 공식문서의 ["컬렉션 스키마 정의"](https://docs.astro.build/ko
414
415
** 기본값:** ` z.object({}) `
415
416
416
417
` docsSchema() ` 옵션에서 ` extend ` 를 설정하여 추가 필드로 Starlight의 스키마를 확장하세요.
417
- 값은 [ Zod 스키마] ( https://docs.astro.build/ko/guides/content-collections/#defining-datatypes-with-zod ) 여야 합니다.
418
+ 값은 [ Zod 스키마] ( https://docs.astro.build/ko/guides/content-collections/#zod를-사용한-데이터-타입-정의 ) 여야 합니다.
418
419
419
420
다음 예시에서는 ` description ` 필드에 더 엄격한 타입을 제공하여 필수 항목으로 만들고, 새로운 선택적 필드인 ` category ` 를 추가합니다.
420
421
421
- ``` ts {8-13 }
422
- // src/content/ config.ts
422
+ ``` ts {10-15 }
423
+ // src/content. config.ts
423
424
import { defineCollection , z } from ' astro:content' ;
425
+ import { docsLoader } from ' @astrojs/starlight/loaders' ;
424
426
import { docsSchema } from ' @astrojs/starlight/schema' ;
425
427
426
428
export const collections = {
427
429
docs: defineCollection ({
430
+ loader: docsLoader (),
428
431
schema: docsSchema ({
429
432
extend: z .object ({
430
433
// 기본 제공 필드를 선택 사항이 아닌 필수 항목으로 변경합니다.
@@ -437,15 +440,17 @@ export const collections = {
437
440
};
438
441
```
439
442
440
- [ Astro ` image() ` 도우미] ( https://docs.astro.build/ko/guides/images/#images-in-content-collections ) 를 활용하려면 스키마 확장을 반환하는 함수를 사용하세요.
443
+ [ Astro ` image() ` 도우미] ( https://docs.astro.build/ko/guides/images/#콘텐츠-컬렉션의-이미지 ) 를 활용하려면 스키마 확장을 반환하는 함수를 사용하세요.
441
444
442
- ``` ts {8-13 }
443
- // src/content/ config.ts
445
+ ``` ts {10-15 }
446
+ // src/content. config.ts
444
447
import { defineCollection , z } from ' astro:content' ;
448
+ import { docsLoader } from ' @astrojs/starlight/loaders' ;
445
449
import { docsSchema } from ' @astrojs/starlight/schema' ;
446
450
447
451
export const collections = {
448
452
docs: defineCollection ({
453
+ loader: docsLoader (),
449
454
schema: docsSchema ({
450
455
extend : ({ image }) => {
451
456
return z .object ({
0 commit comments