liveStart
是什么
liveStart
是一套基于 Node.js 的前端工程项目开发环境,参考了 clam 的部分代码
目前是0.0.3版,实现了基本的模块化开发功能,之后将继续增加更多的功能与完善用户体验,作为一个node.js的初学者,欢迎各位多多提意见。 我的博客: DreamCity
liveStart
的安装与升级
安装liveStart
最简单的方式是通过 Node.js 提供的包管理工具npm
来安装:
npm -g install livestart
# Mac 和 Linux 环境下可能需要 sudo 权限
# 注意:Windows 平台下请使用原生命令行环境,不要在 Cygwin 下安装。
npm -g update livestart
# 升级livestart到最新版
liveStart
的使用
初始化项目目录:
livestart init
生成前端项目目录:
liveStart项目
- build
- DEMO-20130407-v2
- src
- pages
- mods
- widgets
- tests
- docs
- tools
- .livestart
- project.json
- json
# src: 项目源文件,包含html、模板、样式、脚本、图片、swf等;
# tests: 项目测试脚本;
# build: 项目编译打包目录;
# docs: 项目文档存放目录;
# tools: 项目工具目录
# .livestart: 项目元信息,project.json 为项目配置文件。
# .livestart为项目元信息目录
# 我们主要工作目录位于src,其中src又细分为pages、mods、widgets,其中pages存放静态页面资源、mods存放页面模块、widgets存放组件
调试模式:
livestart debug
# 你可以在debug后面加上项目调试端口,以满足同时打开多个调试窗口。例如:
livestart debug 9000
#项目可视化配置后台端口自动加1;即输入9000,则项目可视化配置后台端口为9001
# http://127.0.0.1:8000 作为默认项目调试地址,调试过程中显示效果与输出效果基本保持一致
# http://127.0.0.1:8001 作为默认项目可视化配置后台,可以根据项目需要进行配置、调试、打包
打包模式:
livestart build
# 你可以在build后加上版本号数字,则编译的目录最后以版本号结尾,否则将以temp结尾,如果已存在此目录,会进行文件覆盖。例如:
livestart build 2
# 则输出DEMO-20130407-v2目录
# 最终页面打包,文件输出在build目录里
模块化开发规则
HTML部分模块化
我们开发时的页面放于 pages
目录,css、images这些静态资源放置于 pages
。 pages
目录也适合放layout框架页。
切页面时产生公共模块,使用频繁的模块,应该做成模块放置于 mods
目录,用以下方法在 pages
里页面引用模块,url为引用的相对路径(引用的模块也可以是在pages
里的页面,兼容原来系统的语法):
<!--#include "url"-->
<!--#include file="url"-->
<!--#include virtual="url"-->
# 使用其中一种方法即可
参考:http://www.iamued.com/qianduan/1998.html
CSS部分模块化
比如页面头部我们只引用那一个样式,style.css,但是文件内容改成下面的:
/**
* xxx页面入口样式文件style.css
*/
@import './utils/base.css';
/*页面基础框架(骨架)*/
@import './mods/layout.css';
@import './mods/header.css';
@import './mods/nav.css';
/*首页焦点图*/
@import './mods/flash-pic.css';
………这里省略诸多模块………
@import './mods/footer.css';
# 多人协作写样式时请尽量使用这一种方式
参考:https://github.com/daxingplay/css-combo
JS部分模块化
目前是希望使用sea.js或者require.js实现
最终合并
最终build命令系统会把HTML、CSS、JS的模块进行合并输出到build目录,这个过程考虑加进一些其它的可选选项,比如CSS、JS压缩,注释文档输出等
liveStart
更多使用方法
以下变量作为模板变量放于文档的合适地址:
${firebug-js}
# 调用Firebug-lite for IE
${reload-js}
# F5自动刷新
${relativeUrl}
# 根目录相对路径
liveStart
使用技巧
暂空
liveStart
版本更新
0.0.3 1、打包时过滤掉.svn,.idea等目录
2、build方法后面可自加版本号输出打包,方法:livestart build 1
3、静态文件资源管理器地址栏不带'/'时引起目录层级错误的问题
4、完成自定义端口,方法:livestart debug 5000
0.0.2 1、完成基本的模块化工作方法,与原来的系统进行兼容
2、完成静态文件服务器
3、预留后台GUI管理界面,供以后完善。
0.0.1 开始项目,参考clam的技术进行开发,目标兼容原来的系统,引进新的一些好方法提升工作效率