Assemble: Handlebars 기반 정적 사이트 생성 도구

Source

  • Evernote/Inbox/Assemble Handlebars를 이용한 정적사이트 생성도구.md

Summary

Assemble는 Handlebars 템플릿 엔진과 Grunt를 기반으로 하는 정적 사이트 생성 도구(SSG)입니다. 서버 측 템플릿 엔진 없이 HTML 기반 프론트엔드를 구축할 때, 헤더/푸터 등 공통 영역의 유지보수 문제를 해결하기 위해 사용됩니다. 주요 기능으로는 레이아웃(Layout)을 통한 페이지 구조화, YAML 프론트매터(Front-matter)를 이용한 페이지별 변수 정의, Partial Include를 통한 공통 컴포넌트 재사용, 그리고 Handlebars 헬퍼 함수를 통한 템플릿 로직 확장이 있습니다. Grunt 설정을 통해 소스 .hbs 파일을 빌드하여 최종 정적 HTML 파일로 생성합니다.

Key Points

  • Handlebars 템플릿 엔진과 Grunt 기반의 정적 사이트 생성 도구
  • 레이아웃(Layout) 파일을 사용하여 헤더, 푸터 등 공통 영역을 중앙에서 관리
  • 페이지별 YAML 프론트매터(--- 내)로 title 등 변수를 정의하여 레이아웃에 주입
  • Partial Include({{> partial_name }})를 통해 스크립트, 메뉴 등 공통 컴포넌트 재사용
  • Gruntfile.js 설정을 통해 레이아웃 디렉토리, 파셜 디렉토리, 헬퍼 함수 경로 등을 구성
  • Handlebars 헬퍼 함수를 등록하여 템플릿 내에서 데이터 조작 또는 로직 처리 가능