[!NOTE] 아카이브된 버전: 이 치트시트는 Middleman v3을 다룹니다. 최신 환경에서는 Middleman v4+ 문서를 참조하세요.
Middleman은 최신 웹 개발 표준을 활용하는 Ruby 기반의 정적 사이트 생성기입니다.
구성 (config.rb)
디렉터리 및 에셋
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# image_tag 헬퍼에 자동 이미지 크기 속성 추가
activate :automatic_image_sizes
Compass 연동
compass_config do |config|
config.output_style = :compact
end
페이지 라우팅 및 레이아웃
# 순수 HTML 또는 XML 템플릿의 레이아웃 비활성화
page "/sitemap.xml", layout: false
# 대체 레이아웃 할당
page "/admin/*", layout: :admin_layout
# 여러 경로를 하나의 레이아웃으로 그룹화
with_layout :docs do
page "/guides/*"
page "/api/*"
end
# 가상 프록시 페이지 생성
page "/about.html", proxy: "/template-page.html" do
@page_title = "About Us"
end
커스텀 헬퍼
helpers do
def format_currency(amount)
"$%.2f" % amount
end
end
빌드 구성
middleman build 실행 시에만 에셋 최적화:
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# 커스텀 CDN 경로로 에셋 접두사 지정
# set :http_path, "https://cdn.example.com/"
end