grunt-contrib-compass는 Grunt 빌드 시스템에서 Compass를 구동하기 위한 플러그인입니다. Compass는 Sass 기반의 CSS 전처리기로, 변수, 믹스인, 함수 등 풍부한 기능을 제공하여 스타일시트 작성 생산성을 크게 높여 줍니다. 이 플러그인을 사용하면 Grunt 작업 안에서 Compass 파일을 컴파일하고, 변경 사항을 감지하여 자동 재컴파일하는 일련의 과정을 손쉽게 제어할 수 있습니다.
주요 기능
빌드 자동화
Grunt의 태스크 러너와 결합하면 한 번의 설정으로 Sass/Compass 파일을 일괄 컴파일할 수 있습니다. 개발 중에는 watch 태스크와 연계하여 소스 파일이 수정될 때마다 CSS 출력을 갱신할 수 있어, 수동 빌드 과정을 제거하고 반복 작업을 최소화합니다.
세밀한 옵션 제어
컴파일 옵션은 프로젝트 성격에 맞게 자유롭게 조정할 수 있습니다. 환경(development/production), 출력 스타일, 소스 맵 생성, 외부 라이브러리 경로 등을 지정해 원하는 결과물을 얻을 수 있습니다. 다음은 옵션 구성 예시입니다.
compass: {
build: {
options: {
sassDir: 'src/scss',
cssDir: 'build/assets/css',
outputStyle: 'compressed',
sourcemap: true,
environment: 'production'
}
}
}
실시간 반영
Grunt의 watch 플러그인과 함께 사용하면 Sass 파일 변경 시 곧바로 컴파일이 실행되고, 브라우저를 새로고침하지 않아도 스타일 변경 사항을 바로 확인할 수 있습니다. 아래는 watch 설정 예입니다.
watch: {
styles: {
files: ['src/scss/**/*.scss'],
tasks: ['compass:build']
}
}
시작하기
먼저 시스템에 Ruby와 Compass가 설치되어 있어야 합니다. Compass는 Ruby gem으로 배포되며, gem install compass 명령으로 설치합니다. 이후 Node.js 환경에서 Grunt CLI와 필요한 npm 패키지를 준비합니다.
- 프로젝트 디렉터리에서 필요한 노드 모듈을 설치합니다.
npm install --save-dev grunt grunt-contrib-compass - Compass가 사용할 캐시 디렉터리를 수동으로 생성하거나, 첫 실행 시 자동 생성되도록 둘 수 있습니다(보통
.sass-cache). - Gruntfile.js에 태스크를 등록합니다. 아래는 최소 구성 예제입니다.
module.exports = function(grunt) { grunt.initConfig({ compass: { dev: { options: { sassDir: 'src/sass', cssDir: 'dist/styles', environment: 'development' } } } }); grunt.loadNpmTasks('grunt-contrib-compass'); grunt.registerTask('default', ['compass:dev']); }; - 터미널에서
grunt를 실행하면 지정된 소스 디렉터리의 모든 Sass/Compass 파일이 컴파일되어 CSS가 출력됩니다.
이제 Grunt를 통해 Compass 컴파일이 자동화되었습니다. 필요한 경우 watch 태스크와 결합해 더욱 편리한 개발 환경을 구축할 수 있습니다.