node-ursa

A front end development workbench with server/https/template engine/optimization tools support

npm install node-ursa
1 downloads in the last day
2 downloads in the last week
27 downloads in the last month

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
npm loves you