Static Site Generator

Build a markdown-based static site generator with zero dependencies. Use when implementing a blog generator, markdown-to-HTML converter, static site build pipeline, or template engine from scratch using pure Node.js.

revfactory Updated 1.3k repo stars
Baseline vs Harness scores across 15 cases

File contents

Static Site Generator

모듈 아키텍처

bin/
  blog.js            - CLI 엔트리포인트
src/
  builder.js         - 빌드 오케스트레이터
  markdown.js        - 마크다운->HTML 변환기
  frontmatter.js     - YAML frontmatter 파서
  highlight.js       - 코드 구문 하이라이팅
  template.js        - 템플릿 엔진 ({{var}}, {{#each}}, {{#if}})
  new-post.js        - 새 포스트 생성
  server.js          - 로컬 개발 서버
templates/
  layout.html        - 기본 레이아웃
  post.html          - 포스트 템플릿
  index.html         - 인덱스 템플릿
  tag.html           - 태그 페이지 템플릿

빌드 파이프라인 워크플로우

  1. posts/ 내 *.md 파일 스캔
  2. 각 파일에서 frontmatter 추출 + 마크다운 파싱
  3. 날짜순 정렬
  4. 태그 수집 및 그룹화
  5. 개별 포스트 HTML 생성 -> dist/posts/
  6. 인덱스 페이지 생성 -> dist/index.html
  7. 태그별 페이지 생성 -> dist/tags/
  8. 태그 인덱스 생성 -> dist/tags.html
  9. CSS 복사 -> dist/style.css

핵심 제약

  • 외부 의존성 0개 (순수 Node.js)
  • 각 모듈은 독립적으로 테스트 가능해야 함
  • CSS는 별도 파일로 분리
  • 반응형 디자인 적용

상세 변환 규칙과 테스트 전략은 references/patterns.md 참조.

revfactory/claude-code-harness commit 6e2dd3db97

Frequently asked questions

npx get-skill add revfactory/static-site-generator