gulp-url-prefixer

prefix urls of static assets in a flexible way with Gulp-Url-Prefixer

Issues with the output should be reported on the GulpUrlPrefixer issue tracker.

Install

$ npm install --save-dev gulp-url-prefixer

Usage

const gulp = require('gulp');
const urlPrefixer = require('gulp-url-prefixer');

gulp.task('default', () =>
  gulp.src('src/**/*.html')
    .pipe(urlPrefixer.html({
      prefix: 'http://yourcdn.com/myapp/'
    }))
    .pipe(gulp.dest('dist'))
);

options

Type: object

Set options described below from its properties.

options.tags

Type: array Default:

['script', 'link', 'a', 'img', 'embed']

Set matched tags

options.attrs

Type: array Default:

['href', 'src']

Set matched attributes

options.prefix

Type: string\function Default: http://localhost/

used to prefix the local paths of assets. if it's a function, the return value will be used.

eg:

const path = require('path')

const ext2CDN = pathname => {
  const extname = path.extname(pathname)
  let prefix = null
  switch (extname) {
  case '.js':
    prefix = 'http://j1.mycdn.com/mywebsite'
    break;
  case '.css':
    prefix = 'http://j2.mycdn.com/mywebsite'
    break;
  default:
    prefix = 'http://www.mycdn.com/mywebsite'
  }
  return prefix
}

gulp.task('default', =>
  gulp.src('src/**/*.html')
    .pipe(urlPrefixer.html({prefix: ext2CDN}))
    .pipe(gulp.dest('dist'))
);

options.placeholderFuncName

Type: string Default: __uri

set placeholder function name.

before build

location.href = __uri('/mywebsite/service/index.html')

after build (assume you config.prefix option is http://youwebsite.com/)

location.href = 'http://youwebsite.com/mywebsite/service/index.html'

options.splitOn

Type: string Default: null

Allows the prefixer to split multiple values in an attribute, needed to prefix srcset.

eg: before build(assume you config.splitOn option is , and config.prefix is http://youwebsite.com/mywebsite)

const imgArr = __uri('./images/img01.png,/images/img02.jpeg')

after build

location.href = 'http://youwebsite.com/mywebsite/images/img01.png,http://youwebsite.com/mywebsite/images/img02.jpeg'

API

html

prefix local urls of html like files

gulp.src('src/**/*.{html,tmpl}')
  .pipe(urlPrefixer.html({
    prefix: 'http://yourcdn.com/myapp/',
    tags: ['script', 'link', 'img']
  }))
  .pipe(gulp.dest('dist'))

css

prefix local urls of css like files

gulp.src('src/**/*.{css,less}')
  .pipe(urlPrefixer.css({
    prefix: 'http://yourcdn.com/myapp/'
  }))
  .pipe(gulp.dest('dist'))

js

prefix local urls of js like files

gulp.src('src/**/*.{js,html}')
  .pipe(urlPrefixer.js({
    prefix: 'http://yourcdn.com/myapp/',
    placeholderFuncName: '__prefix'
  }))
  .pipe(gulp.dest('dist'))

License

MIT © Louie Lang