livestart

0.0.9 • Public • Published

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这些静态资源放置于 pagespages 目录也适合放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的技术进行开发,目标兼容原来的系统,引进新的一些好方法提升工作效率

Package Sidebar

Install

npm i livestart

Homepage

www.99is.com

Weekly Downloads

2

Version

0.0.9

License

BSD

Last publish

Collaborators

  • thewei