개요

이 프로젝트는 VitePress 기반 AI 정보 사이트입니다.

목표

• AI 개념/기술을 한국어로 쉽게 설명
• 도구 사용법과 실전 예시 제공
• 학습자와 실무자 모두 참고할 수 있는 구조화된 문서 제공

로컬 실행

npm install
npm run docs:dev

Cloudflare Pages 배포 설정 (자동 + 수동 실행)

main 브랜치 머지 시 자동 배포되며, 필요하면 GitHub Actions에서 수동 실행도 가능합니다.

1) Cloudflare Pages 프로젝트 생성

• Cloudflare Dashboard → Workers & Pages → Create application → Pages → Connect to Git
• GitHub 저장소를 연결하고 프로젝트를 생성합니다.

2) GitHub Secrets 등록

저장소의 Settings → Secrets and variables → Actions에 아래 값을 등록하세요.

• CLOUDFLARE_API_TOKEN
• CLOUDFLARE_ACCOUNT_ID
• CLOUDFLARE_PAGES_PROJECT (Cloudflare Pages 프로젝트명)

3) 배포 실행 방식

• 자동: main에 머지되면 자동 배포
• 수동: GitHub 저장소 Actions 탭 → Deploy VitePress to Cloudflare Pages → Run workflow

참고

• Cloudflare Pages 배포에서는 VitePress base를 기본값(/)으로 두는 것을 권장합니다.
• 기존 GitHub Pages용 base: '/repo-name/' 설정이 있다면 제거하세요.