Mucuna NPM | npm.io

Mucuna（猫豆）

一套简单的前端编译平台

碰到的问题

使用过的编译工具，都是在开发阶段，就开始编译，造成调试起来很麻烦（多文件合并/压缩后，无法准确定位到是那个文件）。
配置太复杂
需要维护编译前和编译后的文件
版本更新太复杂
图片需要手动css sprite

Mucuna目前已解决的问题

通过 document.write 来输出js脚本，通过 @import 来输出css，在上线阶段通过，Mucuna 通过正则替换掉这些配置，来进行打包
使用者只需要配置json文件即可
上线阶段才需要编译，所以版本控制中只需要一份开发代码即可
Mucuna会通过文件内容的md5来，更新每一个文件的版本号
Mucuna会检查语法，来提示你，不合理的语法错误
Mucuna会对smarty模板、html、js、css进行压缩，来减少带宽的浪费
你也可以帮Mucuna增加拓展，来提示你的开发效率
自动帮助你合并图片（以combo内的每一个样式表，都会生成一个相应的图片），并且替换combo后的css

提示

使用本系统必须安装nodejs
需要combo的文件，必须通过 document.write 或者 @import 来引用

安装

npm install -g mucuna

配置项

在根目录下运行

mucuna -a

会自动生成 config.json ，可以通过配置，其中的项来执行不同的功能

你也可以手动创建该文件，如下：

注意：json文件中请不要包含注释

在根目录下添加json文件，内容如下：

{
	// 模板目录，针对模板进行压缩处理
	"TPL_PATH": "/tpl",
	// 静态资源目录
	"STATIC_PATH": "src",
	// 合并文件存放文件夹
	"COMBINE_DIR": "combo",
	// 输出目录，会在根目录创建
	"BUILD_PATH": "output",
	// 需要sprite图片的源路径
	"SPRITE_SOURCE_PATH": "src/img",
	// 生成sprite图片后的路径
    "SPRITE_DEST_PATH": "src/sprites/",
    // css中更新后的路径（防止实际路径和显示路径不同）
    "SPRITE_CSS_PATH": "../../sprites/",
	// 项目文件编码
	"FILE_ENCODE": "utf-8",
	// 编码检查
	"ENCODE_CHECK": true,
	// css语法检查
	"CSS_REGULAR_CHECK": true,
	// js语法检查
	"JS_REGULAR_CHECK": false,
	// css是否合并
	"CSS_COMBINE": true,
	// js是否合并
	"JS_COMBINE": true,
	// html是否压缩
	"HTML_COMPRESS": true,
	// css是否压缩
	"CSS_COMPRESS": true,
	// js是否压缩
	"JS_COMPRESS": true,
	// 图片是否优化
	"OPTIMIZE_IMG": false,
	// 外链文件是否存放到本地
	"EXTERNAL_TO_INLINE": false
}