README

gulp-rebase-css-urls

A Gulp plugin for bundling js and css resources as an external reference.

Overview

The plugin is minimalistic and simple. It rebases a chosen css files stream urls to a new base url.

Example

+ src
    - file.css
    + fldr
        - image.jpg
        - file2.css

Where 'file.css' contents are:

.a{
    background-image: url("fldr/image.jpg");
}

and 'file2.css' contents are:

.b{
    background-image: url("image.jpg");
}

And the task:

var rebaseCssUrls = require('gulp-rebase-css-urls'),
    concat = require('gulp-concat');

gulp.task('concat-css-files', ['copy-image-file'], function(){
    return gulp.src('src/**/*.css')
        .pipe(rebaseCssUrls(srcDir))
        .pipe(concat('bundle.css'))
        .pipe(gulp.dest(dstDir));
});

Results in a directory like so:

+ dst
    - bundle.css
    + fldr
        - image.jpg

And a bundle.css contents like so:

.a{
    background-image: url("fldr/image.jpg");
}
.b{
    background-image: url("fldr/image.jpg");
}

Parameters

rebaseCssUrls(base)

base

Type: String

The new base url, comparing to initial file's src.

Testing

Running the gulp file would concat tests/input files into tests/actual and compare the results to a static tests/expected directory, and make sure we got what we've expected.

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Gulp.

Release History

0.0.1 - Basic features.
0.0.2 - Improved tests and added reporting.

License

MIT

Usage no npm install needed!