# reasy  
[![NPM version](https://badge.fury.io/js/reasy.png)](https://www.npmjs.org/package/reasy)
[![Build Status](https://api.travis-ci.org/wEasyTeam/reasy.png?branch=master)](https://travis-ci.org/wEasyTeam/reasy)

[![NPM Download](https://nodei.co/npm-dl/reasy.png?months=1)](https://www.npmjs.org/package/reasy)

> 基于fis3的纯前端工程自动化工具



## 安装

 1. Linux

        $npm install -g reasy
        $npm install -g web-debug
        
        ;or use git
        $git clone https://github.com/wEasyTeam/reasy
        $cd reasy
        $./reasy-install.sh
  
 2. Windows
     
        >npm install -g reasy
        >npm install -g web-debug
        
        ;or use git
        >git clone https://github.com/wEasyTeam/reasy
        >cd reasy
        >reasy-install.bat

 > 如`npm`方式安装失败，可以下载安装脚本进行安装：[[Linux安装脚本](https://raw.githubusercontent.com/wEasyTeam/reasy/master/reasy-install.sh)]   [[Windows安装脚本](https://raw.githubusercontent.com/wEasyTeam/reasy/master/reasy-install.bat)]
 > 将文件保存至本机后执行即可进行自动安装。
 

## 用法

> 详见： [FIS3官网](http://fis.baidu.com/)

> 注：建议将默认配置文件命名为`reasy-conf.js`，与fis3的配置文件`fis-conf.js`区分开来。


## DEMO
> https://github.com/wEasyTeam/reasy/tree/master/example

## 详细文档
> [Reasy纯前端工具使用教程(一)](http://weasyteam.github.io/reasy/2015/09/10/reasy.html)

> [Reasy纯前端工具使用教程(二)--Reasy内置插件用法](http://weasyteam.github.io/reasy/2015/09/16/reasy2.html)

## 新增功能使用说明

### 新增API

 为了确保一致性，reasy对FSI3的API进行了增量拓展。

 * reasy.extend(ruleName)
   该方法可以实现对配置的继承，可继承的配置在reasy的rules目录下，你也可以在项目rules目录下添加自己的可复用规则，采用`module.exports`导出
 * ...
 

#### 内置规则

现有的内置规则有: 

* relative 将绝对路径转化为相对路径
* autoprefix  可以实现css自动添加私有前缀
* compress 对css,js,png进行压缩
* parse 对sass,less,art-template进行编译
* sprite 对sass,less,css添加雪碧图
* md5 将文件名修改为md5形式
* sea 对sea.js模块进行封装
* mod 对modj.s模块进行封装
* require 对require.js模块进行封装
* jshint 对js进行lint，进行lint时记得在命令行后加上`-l`或`--lint`
* qunit 自动进行单元测试,需要自行安装`reasy-postpackager-qunit`,即`npm install -g reasy-postpackager-qunit`
* iconfont 根据svg图标自动打包生成iconfont字体及相关样式
* ldeploy 本地发布
* debug 去除压缩属性

你也可以自己编写规则放置在工程目录下的rules目录下，如：`workdir/myrule.js`,则调用方法为：`reasy.extend('myrule', args1, args2)`。
rule文件书写示例：
```
module.exports = function(args1, args2) {
    return this.match('**', {
        // ...  写法请参考FIS3配置文件写法
    });
};
```


### 新增命令

 为了减少不必要的配置文件的书写，本工具在`release`命令上拓展了一个`-R`(或`--rules`)命令，使用方法示例: `reasy release -R parse,compress,md5 -d ../output` 。表示编译时会将parse, compress, 和 md5规则应用上去，而不需要编写`reasy-conf.js`


### 调试服务器
reasy没有使用FIS3内置的`fis server`做为web服务器，原因主要有：

* `fis3 release -L` 命令会将liveload.js加入页面，开发阶段可能会打调试版的代码部署至服务器，导致liveload.js无法被用户加载而出错。`web-debug`是在做为本地服务器动态解析时自动加入liveload.js,并不修改本地代码。
* `web-debug`集成了对移动端的调试功能，可以更方便地进行移动页面开发

> 使用时在工程目录执行`web-debug 8080 ./dist`即可。
  


## 关于reasy

> reasy前端自动化工具基于FIS3构建，并在其基础上对纯前端开发模式进行了一定的优化，使用更为轻便。主要特点有：

 1. 对前端默认的编译插件集进行了打包，实现一键安装即可使用
 2. 实现配置继承，并对常用的功能（如压缩，md5，sass编译，模版编译等）进行了封装，可以在一定程度上减少配置文件的书写量
 3. 增加了`-m`配置实现无配置实现基础的压缩，md5等功能
 4. 更改FIS3内置Server为[`web-debug`](https://github.com/lwdgit/web-debug/),增加了移动端调试功能
 5. 更多功能正在进一步添加...