0.0.4 • Published 10 years ago
generator-module-imweb v0.0.4
Module Generator
Create a module with Yeoman, including grunt-jsdoc and bower.json for publish
安装
如果没安装yo:npm install -g yo
npm install -g generator-module-imweb
新建模块
mkdir <package-name>
cd <package-name>
yo module-imweb
开发
目录说明:
dist
: 压缩合并后的文件doc
: 静态文档页面所在目录,index.html
是入口src
: 源文件所在目录gruntfile.js
: grunt配置文件package.json
: 开发时包的信息跟依赖README.md
: 模块说明文档,生成静态文档页面时会作为index.html
bower.json
: 发布时,作为bower包的信息
组件开发:
- 修改组件说明文档
README.md
- 将组件代码放到
src
文件夹,使用jsdoc3
规则对模块进行注释 - 命令说明:
grunt doc
: 自动分析src
中代码的注释跟README.md
, 在文件夹doc
中生成html文档grunt dev
: 将src
中的js代码压缩到dist
grunt clean
: 清空doc
跟dist
文件夹grunt build
: 同时运行grunt doc
跟grunt dev
, 用于最后发布组件
发布
- 在github上新建对应的远程仓库
- 添加本地代码,打上版本tag(bower发布需要git仓库上的项目有版本tag)
- 将代码和tag上传到远程仓库
- 输入
bower register <module-name> <repository-url>