프로젝트 구조
이 가이드에서는 Starlight 프로젝트가 구성되는 방법과 프로젝트의 다양한 파일이 수행하는 작업을 보여줍니다.
Starlight 프로젝트는 일반적으로 다른 Astro 프로젝트와 동일한 파일 및 디렉터리 구조를 따릅니다. 자세한 내용은 Astro의 프로젝트 구조 문서를 참조하세요.
파일 및 디렉터리
astro.config.mjs
— Starlight 통합 및 구성이 포함된 Astro 구성 파일 입니다.src/content/config.ts
— Starlight의 프론트매터 스키마를 프로젝트에 추가하는 콘텐츠 컬렉션 구성 파일입니다.src/content/docs/
— 콘텐츠 파일들이 포함된 디렉터리입니다. Starlight는 이 디렉터리에 있는.md
,.mdx
또는.mdoc
파일을 사이트의 페이지로 변환합니다.src/content/i18n/
(선택적) — 국제화를 지원하는 번역 데이터들이 포함된 디렉터리입니다.src/
— 프로젝트의 기타 소스 코드 및 파일(컴포넌트, 스타일, 이미지 등)이 포함된 디렉터리입니다.public/
— Astro에서 처리되지 않는 정적 자산(글꼴, 파비콘, PDF 등)이 포함된 디렉터리입니다.
예시 프로젝트
Starlight 프로젝트 디렉터리는 다음과 같습니다.
Directorypublic/
- favicon.svg
Directorysrc/
Directoryassets/
- logo.svg
- screenshot.jpg
Directorycomponents/
- CustomButton.astro
- InteractiveWidget.jsx
Directorycontent/
Directorydocs/
Directoryguides/
- 01-getting-started.md
- 02-advanced.md
- index.mdx
- config.ts
- env.d.ts
- astro.config.mjs
- package.json
- tsconfig.json