gulp 中文 API

本文主要翻译gulp官方API,加上自己一点点拙解。

1. gulp.src(globs[, options])

1.1 说明:src 方法是指定需要处理的源文件的路径,gulp 借鉴了 Unix 操作系统的管道(pipe)思想,前一级的输出,直接变成后一级的输入,gulp.src 返回当前文件流至可用插件;

1.2 globs:类型(必填):String or StringArray,需要处理的源文件匹配符路径;
通配符路径匹配示例:

  • “src/a.js”:指定具体文件;
  • “*”:匹配所有文件,例:src/*.js(包含 src 下的所有 js 文件);
  • “**”:匹配 0 个或多个子文件夹,例:src/**/*.js(包含 src 的 0 个或多个子文件夹下的 js 文件);
  • “{}”:匹配多个属性,例:src/{a,b}.js(包含 a.js 和b.js文件) src/*.{jpg,png,gif}(src 下的所有 jpg/png/gif 文件);
  • “!”:排除文件,例:!src/a.js(不包含 src 下的 a.js 文件);
    
    var gulp = require('gulp'),
      less = require('gulp-less');

gulp.task('testLess', function () {
//gulp.src('less/test/style.less')
gulp.src(['less/*/.less','!less/{extend,page}/*.less'])
.pipe(less())
.pipe(gulp.dest('./css'));
});


1.3 **options:**类型(可选):Object,有 3 个属性 buffer、read、base;
* options.buffer:
类型:Boolean
默认:true
设置为 false,将返回 file.content 的流并且不缓冲文件,处理大文件时非常有用;
* options.read:
类型:Boolean
默认:true
设置 false,将不执行读取文件操作,返回 null;
* options.base:
类型:String
设置输出路径以某个路径的某个组成部分为基础向后拼接,具体看下面示例:
```javascript
gulp.src('client/js/**/*.js') 
    .pipe(minify())
    .pipe(gulp.dest('build'));  // Writes 'build/somedir/somefile.js'

gulp.src('client/js/**/*.js', { base: 'client' })
    .pipe(minify())
    .pipe(gulp.dest('build'));  // Writes 'build/js/somedir/somefile.js'

2. gulp.dest(path[, options])

2.1 说明:dest 方法是指定处理完后文件输出的路径;

gulp.src('./client/templates/*.jade')
    .pipe(jade())
    .pipe(gulp.dest('./build/templates'))
    .pipe(minify())
    .pipe(gulp.dest('./build/minified_templates'));

2.2 path:类型(必填):String or Function,指定文件输出路径,或者定义函数返回文件输出路径亦可;

2.3 options:类型(可选):Object,有 2 个属性 cwd、mode;

  • options.cwd:
    类型:String
    默认:process.cwd()
    前脚本的工作目录的路径 当文件输出路径为相对路径将会用到;
  • options.mode:
    类型:String
    默认:0777
    指定被创建文件夹的权限;

3. gulp.task(name[, deps], fn)

3.1 说明:task 定义一个 gulp 任务;

3.2 name: 类型(必填):String,指定任务的名称(不应该有空格);

3.3 deps: 类型(可选):StringArray,该任务依赖的任务(注意:被依赖的任务需要返回当前任务的事件流,请参看下面示例);

gulp.task('testLess', function () {
    return gulp.src(['less/style.less'])
        .pipe(less())
        .pipe(gulp.dest('./css'));
});

gulp.task('minicss', ['testLess'], function () { //执行完 testLess 任务后再执行 minicss 任务
    gulp.src(['css/*.css'])
        .pipe(minifyCss())
        .pipe(gulp.dest('./dist/css'));
});

3.4 fn:类型(必填):Function 该任务调用的插件操作;

4. gulp.watch(glob [, opts], tasks) or gulp.watch(glob [, opts, cb])

4.1 说明:watch 方法是用于监听文件变化,文件一修改就会执行指定的任务;

4.2 glob:类型(必填):String or StringArray,需要处理的源文件匹配符路径;

4.3 opts:类型(可选):Object,具体参看 https://github.com/shama/gaze

4.4 tasks:类型(必填):StringArray,需要执行的任务的名称数组;

4.5 cb(event):类型(可选):Function,每个文件变化执行的回调函数;

gulp.task('watch1', function () {
    gulp.watch('less/**/*.less', ['testLess']);
});

gulp.task('watch2', function () {
    gulp.watch('js/**/*.js', function (event) {
        console.log('File ' + event.path + ' was ' + event.type + ', running tasks...');
    });
});

原文:http://www.ydcss.com/archives/424

发表评论
* 昵称
* Email
* 网址
* 评论