node-ursa

node-ursa是一个用nodejs开发的、可以模拟服务器环境的前端开发环境,是ursa的js版本。使用node-ursa可以实时调试HTML页面，并能最终生成经过优化的，可用于线上环境的javascript,css和HTML模板文件，从而提高前端开发效率，降低前后端工作的耦合度。

##主要功能

• HTTP服务器，提供模拟线上环境的本地开发服务器;
• 变量替换，特别为开发环境和线上环境提供不同的页面参数;
• 文件时间戳，避免静态资源文件被缓存造成线上修改无效;
• 多模板引擎支持，提高HTML开发效率;
• 模拟服务器数据;
• 基于require.js的js和css文件合并;
• 基于YUI的js和css文件压缩。

##使用方法

####安装node-ursa

在node-ursa目录下执行npm命令安装依赖即可：

#npm install

####创建node-ursa项目

使用node-ursa命令创建：

#node-ursa --init [path]

或者

#node-ursa -i [path]

该命令会向指定目录(未指定则为当前目录)下创建项目的必要文件和目录：

• manifest.json：工程的唯一配置文件;
• template：HTML模板目录;
• static:包含js，css和img三个子目录，储存静态资源文件;
• _data:对应HTML模板的数据文件目录。

####启动开发服务器

#node-ursa --start [port]

或者

#node-ursa -s [port]

端口未指定则默认为8899。

访问服务器:http://localhost:[port]。暂时不支持https形式访问。

####开发

以ut后缀访问静态模板文件，路径为相对于./template。以m后缀访问则进入对应模板的数据文件编辑页，你也可以直接编辑对应的.json文件。

####生成线上静态文件

#node-ursa --build [project] --html  --compress

或者

#node-ursa -hcb [project]

project参数请查看manifest.json指南。

./build下即是可以部署到线上的静态文件。

changelog

• 2013-09-20:增加js_utf8_escape选项，用以支持js多字节转义；模板引擎去缓存化配置
• 2013-09-18:复用模板引擎给express的接口，支持所有express支持的模板引擎，现阶段加入twig、ejs、jade
• 2013-09-17:支持三种proxy模式
• 2013-09-15:支持HTTPS访问；支持always_add_timestamp选项；优化了build的日志显示和命令行HELP信息，增加server_add_timestamp选项，支持_ursa.json公共数据文件。
• 2013-09-14:添加了_token/_sutoken/_folder三个内部变量；支持{num}随机参量；规范化测试页面；合并Server和build的公共处理模块。
• 2013-09-10:修复了计算时间戳时没有引用生成后静态文件的bug，加入了test工程，加入了生成Tpl模板的支持。
• 2013-09-09:首次提交，服务器和build基本功能完成，时间戳，压缩合并功能完成。

support

• node
• commander
• mkdirp
• twig
• ejs
• jade
• mime
• exec
• colors
• request