node-ursa
node-ursa是一个用nodejs开发的、可以模拟服务器环境的前端开发环境,是ursa的js版本。使用node-ursa可以实时调试HTML页面,并能最终生成经过优化的,可用于线上环境的javascript,css和HTML模板文件,从而提高前端开发效率,降低前后端工作的耦合度。
主要功能
- HTTP(S)服务器,提供模拟线上环境的本地开发服务器;
- 变量替换,特别为开发环境和线上环境提供不同的页面参数;
- 文件时间戳,避免静态资源文件被缓存造成线上修改无效;
- 多模板引擎支持,提高HTML开发效率;
- 模拟服务器数据;
- 基于require.js的js和css文件合并;
- 多种js和css文件压缩策略;
- 支持LESS。
依赖
- Linux & MAC OS X
- Java 1.6+
- node.js+npm
使用方法
安装node-ursa
安装node-ursa需要npm的支持,并以全局方式安装:
#npm install -g node-ursa
这可能需要root权限。
创建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 [httpport/httpsport]
或者
#node-ursa -s [httpport/httpsport]
端口未指定则HTTP默认为8899,HTTPS为8443,同时端口也可以在manifest.json中指定。
访问服务器:http://localhost:[port]。通过配置可以支持https形式的访问,但不能同时以HTTP和HTTPS的形式访问。
开发
以ut后缀访问静态模板文件,路径为相对于./template。以m后缀访问则进入对应模板的数据文件编辑页,你也可以直接编辑对应的.json文件。
生成线上静态文件
#node-ursa --build [project] --html --compress
或者
#node-ursa -hcb [project]
project参数请查看manifest.json指南。
./build下即是可以部署到线上的静态文件和HTML模板。
doc
changelog
- 2013-11-02:支持HTTP与HTTPS同时工作;废弃https选项,代之以protocol;增加http_port和https_port选项。
- 2013-11-01:支持r.js工程化处理并增加相关配置选项;移除UglifyJS依赖;改js_utf8_escape为js_ascii_only;r.js updated to 2.1.9。
- 2013-10-30:使用async重建build代码风格,使用内置yuicompressor。
- 2013-10-11:增加@tm:@。
- 2013-10-06:增加LESS预处理。
- 2013-10-02:增加enable_proxy开关和template_dir配置项,不再支持jade引擎,支持插件。
- 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基本功能完成,时间戳,压缩合并功能完成。
test
#cd test/node-ursa-proj #sh start.sh
dependencies
notice
twig may throw exceptions which should not if syntax failed.
todo
- coffeescript support
- velocity support