php/www/webapp/o2o/node_modules/grunt-tmod

grunt-tmod

前端模块工具 tmodjs 的grunt自动化插件

Getting Started

需要环境: Grunt ~0.4.1

如果你没有用过 Grunt , 可以先看一下 新手入门 指南, 里面有讲解怎么创建一个 Gruntfile 和如何使用grunt插件.

顺路推荐 : 中文版的grunt社区

安装插件:

npm install grunt-tmod --save-dev

安装完插件后要在gruntfile里面加上这句代码,载入这个插件:

grunt.loadNpmTasks('grunt-tmod');

说明

files 中的 src 为模版路径

files 中的 dest 为输出路径

原tmodjs有配备的watch功能,在grunt中统一使用watch插件来实现,所以取消了grunt-tmodjs中的watch参数.具体设置方法可以参照下面带watch的配置示例,也可以参考grunt-contrib-watch官网的说明.

其他参数和tmodjs的设置一样,只要对应在Gruntfile中进行对应的配置即可.

debug 默认为 false

charset 默认为 utf-8

type 默认为 templatejs

具体各个参数的意义及默认值请参考 tmodjs

配置示例

"use strict";

module.exports = function(grunt){

    // 项目配置
    grunt.initConfig({
        pkg: grunt.file.readJSON('package.json'),
        tmod: {
            files: {
                src: 'test/tpl'
            },
            options: {
                debug : false,
                charset : "utf-8",
                type: "templatejs"
                dest: './output/'
            }
        }
    });

    grunt.loadNpmTasks('grunt-tmod');

    grunt.registerTask('default', ['tmod']);

};

多任务配置示例

"use strict";

module.exports = function(grunt){

    // 项目配置
    grunt.initConfig({
        pkg: grunt.file.readJSON('package.json'),
        tmod: {
            task1 : {
                files: [{
                    src: 'test/tpl'
                }],
                options: {
                    debug : false,
                    charset : "utf-8",
                    type: "templatejs",
                    dest: './output/'
                }
            },
            task2: {
                files: [{
                    src: 'test/tpl2'
                }],
                options: {
                    debug : true,
                    charset : "utf-8",
                    type: "templatejs",
                    dest: './output/'
                }
            }
        }
    });


    grunt.loadNpmTasks('grunt-tmod');

    grunt.registerTask('default', ['tmod:task1']);

};

注意,dest路径是相对于src而言,如上代码设置,最后的dest目录将在 test/tpl 下生成.

####带watch插件配置示例(注意要先安装watch插件)

npm install grunt-contrib-watch --save-dev

"use strict";

module.exports = function(grunt){

    // 项目配置
    grunt.initConfig({
        pkg: grunt.file.readJSON('package.json'),
        tmod: {
            files: {
                src: 'test/tpl'
            },
            options: {
                debug : false,
                charset : "utf-8",
                type: "templatejs"
                dest: './output/'
            }
        },
        watch: {
            scripts: {
                files: ['test/tpl/*.*'],
                tasks: ['tmod'],
                options: {}
            }
        }
    });

    grunt.loadNpmTasks('grunt-contrib-watch');
    grunt.loadNpmTasks('grunt-tmod');

    grunt.registerTask('default', ['tmod','watch']);
    grunt.registerTask('dest', ['tmod']);

};

Release History

v 0.1.6 修复dest的路径问题 , 原本dest属性是放在files属性里 , 0.1.6版本后建议将 dest 属性放在 option 中, 如本篇 readMe 的代码所示. 如果有多个模版文件目录需要配置,建议使用多个任务的方式来配置,不建议在src中放入路径数组. 13-12-08

v 0.1.5 修复不支持多任务的bug 13-11-14

v 0.1.4 去除掉打包的tmodjs改为依赖,将内置tmod依赖改为0.0.2版本 13-11-11

v 0.1.3 第二个版本,配合npm修改版本号,加上参数识别功能 13-11-10

v 0.0.1 第一个版本 13-10-23

License

The MIT license.