# grunt-rainbow-build

> rainbow build

Latest version **0.1.9** (published 2016-12-23) · 0 weekly downloads

## Install

```sh
npm install grunt-rainbow-build
pnpm add grunt-rainbow-build
yarn add grunt-rainbow-build
bun add grunt-rainbow-build
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.9 |
| Published | 2016-12-23 |
| First published | 2016-12-14 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 0.8.0 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Andykeh |
| Maintainers | andykeh |
| Keywords | gruntplugin |

## Links

- npm: https://www.npmjs.com/package/grunt-rainbow-build
- Repository: https://github.com/andykeh/grunt-rainbow-build
- Issues: https://github.com/andykeh/grunt-rainbow-build/issues
- npm.io page: https://npm.io/package/grunt-rainbow-build

## Recent versions

- 0.1.9 (latest) — 2016-12-23
- 0.1.8 — 2016-12-23
- 0.1.7 — 2016-12-23
- 0.1.6 — 2016-12-23
- 0.1.5 — 2016-12-21
- 0.1.4 — 2016-12-20
- 0.1.3 — 2016-12-20
- 0.1.2 — 2016-12-14
- 0.1.1 — 2016-12-14
- 0.1.0 — 2016-12-14

## README

# grunt-rainbow-build

> rainbow build

## 开始
需要的Grunt版本 `~0.4.5`


安装
```shell
npm install grunt-rainbow-build --save-dev
```

在Gruntfile引入插件

```js
grunt.loadNpmTasks('grunt-rainbow-build');
```

## 散列文件名任务: "rainbow_hash" 
### 工程需要的插件
grunt-contrib-clean

### 开始配置
引入需要的插件，
并在在grunt初始化配置里增加任务
```js
grunt.loadNpmTasks('grunt-contrib-clean');
grunt.initConfig({
    
});
```
####1.清除构建目录的文件
先使用 grunt-contrib-clean 做一些清除工作
```js
grunt.initConfig({
clean: {
      tests: ['test/jsdist','test/cssdist']
    }
})
```

####2.散列文件名配置
```js
grunt.initConfig({
  rainbow_hash: {
      options: {        
         'hashLength':8 /*散列值长度*/         
      },
      your_target: {
        options: {
          'fileType':'js',  /*文件类型*/
          'label':'script'  /*文件引入的标签类型*/
        },
        files: [{
            expand:true,   
            cwd:'test/js',
            dest : 'test/jsdist', /*资源将被拷贝到该目录*/
            src:['**/*.js']
        }]
      }
  }
});
```

##输出map文件任务
```js
grunt.initConfig({
 rainbow_out_map:{
        options:{
            filePath:'test/map.js', /*map文件路径*/
            'hashName' :true,       /*是否散列文件名*/          
            'hashLength':8          /*散列值长度*/ 
        },
        dist:{
    
        }
    }
});
```
##处理页面引入资源任务 "rainbow_use"


```js
grunt.initConfig({
rainbow_use:{
        options:{
            'static':['script','link'], /*处理的静态资源类型*/
            'replace':['../','${STATIC_URI}'] /*自定义替换规则*/
        },
        dist:{
            files:[{
                expand:true,
                cwd:'test/html',
                dest : 'test/htmldist', /*页面资源将被拷贝到该目录*/
                src:['**/*.html'] 
            }]
        }

    }
})
```
>html引入的资源路径请设置为相对路径，动态路径无法识别，可以通过replace设置规则替换最终路径，
比如以上配置test/js/xx.js 最终将会处理为 ${STATIC_URI}test/jsdist/xxxx.xx.js 


##配置参考

```js
'use strict';

module.exports = function(grunt) {
  grunt.initConfig({
    clean: {
      tests: ['test/jsdist','test/cssdist']
    },

    // 文件名散列命名
    rainbow_hash: {
        options: {
            'hashMap':'hash_map/map.js' /*输出map文件*/
        },
      hash_js: {
        options: {
          'fileType':'js',
          'label':'script'
        },
        files: [{
            expand:true,
            cwd:'test/js',
            dest : 'test/jsdist',
            src:['**/*.js']
        }]
      },
      hash_css: {
        options: {
            'fileType':'css',
            'label':'link'
        },
        files: [{
            expand:true,
            cwd:'test/css',
            dest : 'test/cssdist',
            src:['**/*.css']
        }]
      }
    },
    //输出map
     rainbow_out_map:{
        options:{
            filePath:'test/map.js'
        },
        dist:{

        }
    },
    //处理引用
    rainbow_use:{
        options:{
            'static':['script','link'], /*处理的静态资源类型*/
            'replace':['../','${STATIC_URI}'] /*输出资源链接替换规则*/
        },
        dist:{
            files:[{
                expand:true,
                cwd:'test/html',
                dest : 'test/htmldist',
                src:['**/*.html']
            }]
        }

    }
  });

  grunt.loadTasks('tasks');
  grunt.loadNpmTasks('grunt-contrib-clean');
  grunt.registerTask('default', ['clean', 'rainbow_hash', 'rainbow_use']);

};

```

---
_Source: https://npm.io/package/grunt-rainbow-build · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._