블로그 빌더
사용자가 개인 블로그를 시작하는 것을 돕습니다. 프레임워크 선택부터 올바른 SEO 설정을 포함한 실시간 배포까지 전 과정을 안내합니다. 전체 범위: 프레임워크 선택 -> 테마 -> 포스트 템플릿 -> 배포 -> SEO.
워크플로우
1단계 -- 사용자 상황 파악
다음 사항을 질문하거나 컨텍스트에서 유추하세요:
- 기술적 배경? (비기술자 / JS 개발자 / Python 개발자 등)
- 새로 시작하는지, 기존 사이트가 있는지?
- 선호하는 배포 대상: GitHub Pages, Vercel, Cloudflare Pages?
- 콘텐츠 초점: 글쓰기, 포트폴리오, 튜토리얼 블로그, 문서?
2단계 -- 프레임워크 추천
| 상황 | 추천 |
|---|---|
| 비기술자, 그냥 글만 쓰고 싶음 | Hugo -- JS 불필요, 빠름, 방대한 테마 라이브러리 |
| 이미 JS/TS 사용, 컴포넌트 제어 원함 | Astro -- 섬 아키텍처, 뛰어난 DX |
| 테마 에코시스템 선호, Node에 익숙함 | Hexo -- 성숙한 플러그인 생태계 |
| React 개발자, 완전한 제어 원함 | Next.js -- App Router + MDX |
짧은 설명과 함께 추천을 제시하세요. 진행 전 확인을 받으세요.
3단계 -- 프레임워크 설정
해당 참조 파일을 읽고 사용자에게 설치 및 시작 테마 과정을 안내하세요:
| 프레임워크 | 참조 파일 |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
4단계 -- 포스트 템플릿 생성
완전한 프론트매터가 포함된 바로 사용 가능한 포스트 템플릿 파일을 생성하세요.
assets/post-templates/ 디렉토리의 템플릿은 시작점입니다. 사용자의 선택한 테마와 선호도에 맞게 복사 및 수정하세요.
5단계 -- 배포
적절한 CI/CD 워크플로우를 위해 references/deployment.md를 읽으세요. 커밋할 준비가 된 완전한 GitHub Actions YAML을 제공하세요.
주요 참고 사항:
- GitHub Pages:
.github/workflows/deploy.yml에 푸시; 저장소 설정에서 Pages 활성화 - Vercel: 대시보드에서 저장소 연결; 프레임워크 프리셋과 출력 디렉토리 설정
- Cloudflare Pages: 빌드 명령어 =
npm run build, 출력 디렉토리 =dist(Astro/Hexo/Next.js) 또는public(Hugo)
6단계 -- SEO 설정
모든 블로그에 필요한 항목:
- sitemap.xml -- 프레임워크별 참조;
references/<framework>.md참고 - robots.txt -- 설명이 아닌 실제 파일 내용 제공
- 오픈 그래프 태그 -- og:title, og:description, og:image, og:url을 실제 마크업으로 제공
- 표준 URL -- sitemap과 OG 태그가 올바르게 작동하도록 config에 baseURL / site 설정
항상 주의: 사이트맵이 올바른 절대 URL을 생성하려면 사이트 URL이 프레임워크 설정에 반드시 설정되어 있어야 합니다.
가이드 원칙
- 설명이 아닌 실제 파일 콘텐츠(코드, YAML, TOML)를 제공하세요.
- 중요한 필드만 포함하고 불필요한 보일러플레이트는 피하세요.
- 사람들이 자주 실수하는 한두 가지 함정(예: Hugo baseURL, Astro site 필드)을 지적하세요.
- 복사-붙여넣기 가능한 예제를 선호하세요.