一个使用Markdown格式文本进行项目计划编排、展示的工具
在平时做项目的过程中,我们需要制定项目计划,跟踪项目进度,有一些常见的软件比如Microsoft Project, OminiPlan,这些软件都很棒。但是也有一些小问题:
而随着 Markdown 这种既可以用普通文本编辑器(Vim/Emacs)编辑, 又有一定样式的文件格式的流行,我一直想着用Markdown文件记录项目计划的 内容,因为Markdown文件的编辑非常的方便,这样就必须要有一个软件对这个项目文件进行解析展示, 因为我希望我只指定最少的信息,其它信息 需要由这个软件自动计算出来。
在我的脑海里,这个软件应该符合以下几个条件:
总之一句话:
我只需要指定必要的信息: 项目什么时候开始;要做哪些事情;每件事情需要的人日、由谁负责;哪些人在哪些日子里面要请假,我便可以得到一个详细的计划。
经过几年的打磨(一点不夸张,换了至少三个方案),目前这个版本我觉得已经比较满意和趁手,因此分享给大家。废话不多说,先上图:
一个测试项目所有任务的列表:
对任务的进度进行更新:
整个项目的一些统计信息:
看了有这么多的功能,你可能会以为这背后一定有一个MySQL数据库吧? 没有,所有这些信息都是来自一个普通的Markdown文件,上面这个测试的项目文件在这里: test.plan.md。
# 下载
git clone [email protected]:xumingming/MarkdownPlanner.git
cd MarkdownPlanner
# 编译
mvn package
下面复制测试项目文件: test.plan.md
到任意目录(比如/tmp/test
), 然后到这个目录下面启动MarkdownPlanner
:
mkdir -vp /tmp/test
cp test.plan.md /tmp/test
cd /tmp/test
java -jar /path/to/your/MarkdownPlanner/target/MarkdownPlanner-0.1.0.jar --server.port=9999
现在打开浏览器访问 http://localhost:9999/test.plan.md 就可以访问到这个项目的页面了,祝你用得开心 :)。
为了能够让我们MarkdownPlanner把你的markdown文件识别成一个项目文件,你的文件名必须以
.plan.md
结尾。
Markdown文件里面跟任务制定相关的一些小 "语法" :
指定项目从 2018-01-22
开始:
* ProjectStartDate: 2018-01-22
一个由詹姆斯
负责的、需要1个人日
的、目前完成了 80%
的、名为 数据的填充
的任务:
* 数据的填充 -- 1[詹姆斯][80%]
指定 川普
同学, 2018-01-22
至 2018-01-26
期间不参与这个项目:
* 川普 -- 2018-01-22 - 2018-01-26
Happy planning!