Astro Starlight

Astro Starlight는 Astro 웹 프레임워크를 기반으로 구축된 문서 테마입니다. 빠르고 접근성이 뛰어나며 유지 관리가 용이한 문서 웹사이트를 만들기 위한 준비된 구조를 제공합니다. 다른 문서 도구와 달리 Starlight는 브라우저에 최소한의 자바스크립트만 전송하여 더 빠른 로드 시간과 향상된 성능을 제공합니다.

이 도구는 Markdown, MDX, Markdoc 형식으로 콘텐츠 작성이 가능하여 문서 작성 방식에 유연성을 제공합니다. 자동 내비게이션 생성, Pagefind가 지원하는 내장 검색 기능, 모든 기기에서 작동하는 반응형 디자인을 포함하고 있습니다. Starlight는 기본적으로 다국어를 지원하여 글로벌 문서 프로젝트에 적합합니다. 이 테마는 구성 파일을 통해 고도로 사용자 정의할 수 있어 간편한 설정을 유지하면서 브랜드에 맞게 조정할 수 있습니다.

Astro Starlight 시작은 간단하며 몇 가지 단계만 필요합니다:

• 터미널에서 npm create astro@latest -- --template starlight 명령어를 실행하여 Starlight를 설치하세요. 이 과정은 모든 것을 자동으로 설정합니다.

• 설치가 완료되면 npm run dev 명령어로 개발 서버를 시작하여 브라우저에서 문서 사이트를 로컬로 미리 볼 수 있습니다.

• src/content/docs/ 디렉토리에 Markdown 또는 MDX 파일을 생성하여 새 문서 페이지를 추가하세요. 각 파일은 자동으로 페이지가 됩니다.

• astro.config.mjs 파일에서 사이트 설정을 구성하세요. 여기서 사이트 제목을 설정하고, 소셜 미디어 링크를 추가하며, 내비게이션 사이드바를 맞춤 설정할 수 있습니다.

• docs 디렉토리 내에 폴더를 생성하여 페이지를 정리하세요. Starlight는 파일 구조를 기반으로 내비게이션을 자동 생성합니다.

• 게시할 준비가 되면 npm run build 명령어로 사이트를 빌드하고 Netlify, Vercel, GitHub Pages 같은 정적 호스팅 서비스에 배포하세요.

• 최소한의 자바스크립트로 빠른 정적 사이트 생성

• Pagefind 내장 검색 기능

• 완전한 국제화 지원

• 자동 내비게이션 생성

• 다크 및 라이트 테마 포함

• Markdown, MDX, Markdoc 지원

• 다중 프레임워크 통합 (React, Vue, Svelte)

• 접근성 중심 디자인

• 모바일 반응형 레이아웃

• 사용자 정의 가능한 테마 및 색상

• 페이지 편집 링크

• 소셜 미디어 통합

• SEO 최적화