Dec 23, 2010

搭建项目组内部wiki

  看到txt2tags有一段时间了,在Ubuntu下工作一个多月了吧,以后也会一直在Linux下工作,必须抓紧放弃讨厌的二进制文件格式,选个处理纯文本的工具完成文档。

  上周笔试题是边学边用txt2tags完成的,最近,项目组要写很多文档,为扩大做准备。首先想到的就是wiki了,其实,之前一直用trac做wiki的,但,trac有些不好的地方。

  trac的不爽之处:
  1. 啥都做, 喜欢 do one thing, and do it well.
  2. 貌似用的自己的数据库,想只把wiki分离出来不太方便
  3. 想把wiki页面转换成其他格式,不是很方便

  自己用过一段时间的vimwiki, 总觉得太简单了,而且,那天项目组来个用emacs的就不好整了。

  考虑到txt2tags one source multi target. 纯文本,语法也比较简单,容易上手,txt2tags.org 几乎所有页面都可以查看源文件。

  最终,决定用txt2tags,用git管理 *.t2t,大家都可以随便修改wiki页面,当然,修改稍微麻烦了些,必须先通过git checkout下来,必须学习txt2tags markup语法,然后,一个字一个字的写,写好再push上去,我已经写好git hooks/post-update 根据修改文件在/var/www/wiki下生成相应的 .html。

  虽然难了些,但,我们是开发组,大家应该多学习点知识,不管是编码还是写文档,争取都做得专业点,争取做公司技术实力最强的项目组。

  一切都刚刚开始,好的愿望,希望坚持会有好的结果。

No comments:

Post a Comment

您的评论将使我blog更有动力~