alexkeysmith / gulp-minify-css

A Gulp plugin that minifies css with clean-css:

Breaking Changes from v0.3 to v0.4 (due to clean-css)

• noAdvanced became advanced - make sure to reverse the value;
• noAggressiveMerging became aggressiveMerging - make sure to reverse the value;
• noRebase became rebase - make sure to reverse the value;

source: clean-css

Regarding Issues

This is just a simple gulp plugin, which means it's nothing more than a thin wrapper around clean-css. If it looks like you are having CSS related issues, please contact clean-css. Only create a new issue if it looks like you're having a problem with the plugin itself.

Information

Package	gulp-minify-css
Description	Minify css with clean-css, including optional caching.
Node Version	>= 0.10

Installion

npm install --save-dev gulp-minify-css

Usage

var gulp = require('gulp'),
		minifyCSS = require('gulp-minify-css');

gulp.task('minify-css', function() {
  gulp.src('./static/css/*.css')
    .pipe(minifyCSS({keepBreaks:true}))
    .pipe(gulp.dest('./dist/'))
});

Options

• cache - check and return minified CSS from cache if it exists; minify and store in cache when it does not

This is a gulp-minify-css feature and not a clean-css feature.

---

• advanced - set to false to disable advanced optimizations - selector & property merging, reduction, etc.
• aggressiveMerging - set to false to disable aggressive merging of properties.
• benchmark - turns on benchmarking mode measuring time spent on cleaning up (run npm run bench to see example)
• compatibility - enables compatibility mode, see below for more examples
• debug - set to true to get minification statistics under stats property (see test/custom-test.js for examples)
• inliner - a hash of options for @import inliner, see test/protocol-imports-test.js for examples
• keepBreaks - whether to keep line breaks (default is false)
• keepSpecialComments - * for keeping all (default), 1 for keeping first one only, 0 for removing all
• processImport - whether to process @import rules
• rebase - set to false to skip URL rebasing
• relativeTo - path to resolve relative @import rules and URLs
• root - path to resolve absolute @import rules and rebase relative URLs
• roundingPrecision - rounding precision; defaults to 2; -1 disables rounding
• shorthandCompacting - set to false to skip shorthand compacting (default is true unless sourceMap is set when it's false)

Source: clean-css

Source maps

Source maps can be generated by using gulp-sourcemaps:

var gulp = require('gulp');
var minifyCSS = require('gulp-minify-css');
var sourcemaps = require('gulp-sourcemaps');

gulp.task('minify-css', function() {
  gulp.src('./src/*.css')
    .pipe(sourcemaps.init())
    .pipe(minifyCSS())
    .pipe(sourcemaps.write())
    .pipe(gulp.dest('dist'));
});

Caveats

When minifying (and import inlining) files with existing source map, be aware clean-css doesn't yet support source maps with inline source (sourcesContent property).. See #397. As such ensure that incoming source maps have properly set sourceRoot and soureces values to map back to the original source files.

LICENSE

(MIT License)

Copyright (c) 2013 Jonathan Pollack ([email protected]), Cloublabs Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.