使用Github生成燃尽图
经过一晚上折腾,终于算是把linux上成功生成了我们团队项目的燃尽图,效果还是不错,在过程中又发现了另一种生成燃尽图的方式,也是基于一个开源项目。
1、准备:
首先你的项目一定要有milestone。你可以按如下步骤建立一个milestone:
- 点击项目主页Issues进入Issues页面:
- 点击标签页中的MileStone标签,然后点击右侧New milestone按钮新建一个MileStone。
- 在Title里可以写“α版本”或者你们其他预计要达到的版本即可,在描述中可以写项目的验收标准或者项目要完成的功能。在右侧的日历表中要选的时间是该milestone预估实现时的日期。
- 在新建完成milestone后,如果你之前已经发布了很多个Issue,那么可以通过如下方式将Issue全部转移到新的milestone中:
-
- 首先点击下图中的左侧全选框
-
- 将所有的选中后,点击下方所示的Milestone,在里面选择一个要set的
注意:记得要对每一页的Issues进行如上操作。如果是新建了milestone之后才建的Issues,在建Issues时要记得加上milestone。
- 在完成milestone后,我们还需要加入类似[size 1]这样的标签(数字表示贡献量或叫工作量),比如下面我们组的标签:
这样我们的准备工作就完成了,下面我们通过两种方式来生成燃尽图。
2、通过现成的服务器生成
首先介绍一个网站:http://radekstepan.com/burnchart
- 这个网站是可以帮Github上的项目生成燃尽图的,首先打开这个网站。
- 示意图如上所示,那么现在点击左上角的Add a Project
- 注意这里填入你的Github项目的相对路径,相对路径你可以按如下方式找到,首先打开你们的Gtihub项目主页:
- 在浏览器的地址栏中,截取github.com/ 后面的内容就是Github项目的相对地址,比如我们团队项目地址是
https://github.com/buaase/Phylab-Web
- 那么截取后的相对地址应该是:
buaase/Phylab-Web
- 将项目相对路径输入到刚才那个页面中,现在页面截图如下:
- 点击右侧Add按钮后,进入如下页面:
- 然后点击项目名称,比如在这里点击下方红色框内部分:
- 点击进入后,再点击对应的Milestones,比如这里我们点击 阿尔法版本雏形 。
- 这样就可以看到我们的燃尽图啦!
3、另一种方式(Linux环境下)
安装依赖
#安装nodejs,教程可以参考:
http://my.oschina.net/blogshi/blog/260953
# 再安装npm,如下:
wget http://npmjs.org/install.sh
sudo chmod u+x install.sh
./install.sh
# 克隆项目仓库
git clone https://github.com/JerrySievert/github-burndown-chart.git
# 进入项目文件夹
cd github-burndown-chart
# 提升权限,在ubuntu下这一点非常重要!!!
sudo -s
# 开始安装过程...
npm install express -gd
npm install eco -d
npm install --save coffee-script
npm install flatiron -d
npm install connect -d
npm install js-yaml -d
npm install union -d
# 别看github项目主页上写着只有几个依赖...但是实际上依赖非常多...
修改配置文件config.yml
#这里user就是项目相对路径中的第一个元素,project就是项目相对路径中的第二个元素。
github_user: 'buaase'
github_project: 'Phylab-Web'
#这里的project_name是自己随便写的,比如
project_name: 'Phylab-Web BurnDown chart'
#这里的6,7是指休息日,如果设置为休息日,计划线就会在那两天为平
weekend: [ 6, 7 ]
#注意这里base_url保持不变即可,如果你改变clone后的文件夹名字,那么填改动后的名字即可。
base_url: 'github-burndown-chart'
#这个api_token对于公开的项目不需要填写
api_token: false
#运行之前注意一点,要对github-burndown-chart文件夹内的文件设置权限:
cd ..
sudo chmod u+x github-burndown-chart -R
#重新进入项目
cd github-burndown-chart
#运行start.js
node start.js
运行时如果出现404的错误,可能是user_project那里填错了。
出现像403的错误,请看看是否没有联网,还有可以插入网线尝试一下。
如果运行正常,将会出现下面类似的图:
这时候我们访问端口地址:
http://127.0.0.1:47727(这个跟生成地址有关)
可以看到如下图:
这样我们就生成了燃尽图!其中蓝色是计划线,而橘色线是实际工作线。
这个燃尽图是按加上size 标签的工作量计算的,所以是按积压工作量来计算的~
至此,我们就完成github项目生成燃尽图的目标啦~