GitHub Pages에 React/정적 틀 올리기

이 저장소는 Vite로 스타일만 번들하고, 글은 posts/N.md 한 폴더에 두고 프론트매터 category로 dev·it·trend·knowledge·finance·realestate·food 등을 구분합니다. 공개 URL은 /posts/N/ 으로 통일합니다. Actions가 배포용 저장소의 gh-pages에 푸시합니다. 소스와 공개가 분리되어 있으면 메인 저장소를 private으로 두기도 쉽습니다.

배포용 저장소에는 deploy key(쓰기) 를 붙이고, CI에는 비밀 키 를 시크릿으로 둡니다. external_repository 에 owner/name을 지정하는 방식이 일반적입니다.

빌드 루프 (요약)

npm ci && npm run build
# publish_dir: dist

위에서 vite build 가 CSS 자산을 만든 뒤, prerender가 마크다운 → HTML 정적 파일을 dist에 씁니다.