项目Wiki的选择和配置
项目组内部使用的wiki终于创建成功了!因为要开始一个新的重要项目,所以要开始用正规方法来进行项目管理。为了保证项目内部沟通的畅通,所以我们需要选择一个wiki来进行内部文档的合作编写。
工具的选择
选择wiki时候的首选参考当然就是 http://c2.com/cgi/wiki?ChoosingaWiki 了,其中包含了大部分开源的wiki产品,并且提供了各种选型参考和特性比较。经过仔细考察,发现最好的wiki毫无疑问应当是 wikipedia 引擎了,但是考虑到公司主要的开发语言在.net和java方面,为了保证未来能够维护,所以选择只能局限在asp/asp.net/c#/java四种语言的wiki引擎。除了开源的东西之外,商业产品中还有confluence,最终我们选中了四种产品进行考察:
- openwiki
openwiki是我去年就开始用的小工具,用asp编制,而且安装很方便,用起来也不错,当时还把它汉化了一把,后台采用access数据库。但是就因为是用access数据库,上次M$发布了一个补丁,说要增强access的安全性,结果打了补丁之后,openwiki的帮助页面有好几个出不来了,估计是含有补丁认为的非法字符。不爽,所以就cancel了。另外附带说一句,http://www.openwiki.com 曾经有好长一段时间遭到国内一些spam的袭击,结果人家被迫把国内的ip给屏蔽了很长时间,这帮人丢人都丢到国外去了! - flexwiki
用asp.net编写的一个开源产品,可是M$写的哦!(参考这里 http://www.oui-blog.com/balduran/archives/002242.html)著名的C# Win32 API站点http://www.pinvoke.net/ 用的就是flexwiki。它使用文件作为数据存储,功能很强,但是问题是中文支持有问题,尤其是标题栏中不能使用中文,而且还有其他的bug。没办法,只好忍痛割爱,等她长大了我再考虑她吧! :D - snipsnap
非常强大的一个wiki+blog的工具,用java写的,支持大部分主流wiki的功能。但是存在一个小问题,就是中文支持有限,可以做中文的条目,但是一旦进入编辑这个条目的时候就出现乱码,而且乱码条目编辑之后无法保存。虽然它有很强大的功能,包括支持编写UML图,不过也只能cancel了。那位大虾帮忙把它这个小bug改掉了,估计国内会有很多人用的,因为它自身已经被汉化了。 - jspwiki
我现在就在用的好东西,java写的。支持各种插件,好的让人喜不自禁。等以下我跟你说哦。不过缺点就是版本管理上不完善, c2说它一旦删除页面了就再也无法恢复。 - usemodj
c2上评论是最好用而且最好装的java wiki了,安装确实方便,但是在我的tomcat5.5上面无法正常运行。就为了一个传说中的条目管理功能,浪费了我一个晚上。 - confluence
非常好的商业产品,大家可以申请免费的“开源”和“免费”授权,而且还可以申请免费的“个人”授权(2用户),商家考虑的非常周到(致敬)!不过因为要申请的缘故,所以不想等了。国内有很多的站点建立了,我也找到了一个1.2.3版本的crack,却找不到1.2.3的程序了。但是又想想,人家已经为大家作了那么多的奉献,要盗人家的版也不好意思,不怕等3个工作日的话就申请一个吧。
最后选定jspwiki作为我的wiki引擎。
jspwiki的安装
因为是java的程序,所以大家要去apache下载tomcat。但是安装时候要注意,不要安装到默认的program file文件夹下,要安装到路径名不含空格的路径下,我的安装目录就是d:\tomcat,至于为什么这样,不是jspwiki的问题,而是jspwiki中有一些很重要很有用的插件的关系,稍后便讲。
jspwiki安装非常方便,到www.jspwiki.org下载程序,也可以下载源代码自己编译。然后把其中的 jspwiki.war文件复制到tomcat的webapps目录下就可以了,我机器上的位置是d:\tomcat\webapps。
其次就要配置了。用浏览器访问 http://localhost:8080/JSPWiki/Install.jsp ,记得大小写有区分哦!如果你不想JSPWiki出现在url中的话,你就要把jspwiki.war在复制到webapps目录之前改名,或者停掉tomcat然后再复制,并在复制之后改名(比如改为mywiki.war)就可以了。
在初始化配置的时候有几个地方需要注意:
1。Base URL的机器名部分不要是localhost,否则人家访问时候看不到图片。
2。File storage部分要填写类似 e:/cms/wiki 这样的格式,是wiki页面内容存放的位置,不要放在tomcat目录下。
3。Work directory也要填写好,我这里填的是 e:/cms/wiki/tmp/,把所有位置都放到一起去
4。Log files我填写的位置是e:/cms/wiki/log/jspwiki.log。
5。把配置文件 {TOMCAT目录}webapps\{JSPWiki目录}\WEB-INF\jspwiki.properties中的配置项修改以便支持中文搜索:
jspwiki.lucene.analyzer = org.apache.lucene.analysis.cjk.CJKAnalyzer
然后就是安装插件了,如果没有插件支持的话,jspwiki也就不要用了!我安装了几个插件:
ImageMap 支持图像中嵌入链接
ImageGen 一组图形插件,可以从特定格式文本中画出UML类图,UML顺序图,组织结构图,成因图,以及常用的报表类图形(折线图,饼图,甘特图等等)。个人认为这个插件是最有吸引力的地方。
GraphViz 一个画流程图的工具,是AT&T的GraphViz的简单封装。
其他插件包括日期显示,天气报告,页面嵌入,计数器等等。
插件的安装很简单,就是把jar包全部放到{TOMCAT目录}webapps\{JSPWiki目录}\WEB-INF\lib下面,然后修改一下配置文件jspwiki.properties中的配置项为
jspwiki.plugin.searchPath = com.mckessonaps.jspwiki.plugin,\
com.mckessonaps.jspwiki.plugin.graphviz,\
org.nascif.jspwiki.plugin.imagegen.snipgraph, \
org.nascif.jspwiki.plugin.imagegen.sequence,\
org.nascif.jspwiki.plugin.imagegen.jfreechart
然后增加配置项
graphviz.bin=D:/Program Files/ATT/Graphviz/bin
然后再和jspwiki.properties同目录的web.xml中增加内容如下:
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
![](/Images/OutliningIndicators/None.gif)
如果还想使用TranscludePlugin来插入其他网站的页面的话,就把web.xml中用 “REMOVE ME TO ENABLE XML-RPC”标注的区域取消注释就可以了。
为了让GraphViz插件能够正常工作,还需要到http://www.graphviz.org去下载安装graphviz才可以。配置文件中的 graphviz.bin 就指向你graphviz安装目录中的bin目录位置。
配置界面以及其他
到这里,整个wiki就算架站完毕,可以开始使用了。当然事情还有很多,比如权限没有配置,界面风格不好看等等。不过我不熟悉java,在jspwiki网站上也没有找到很合适的解决方案,只要等各位看官的贡献了。
另外,我也配置了一些我自己整理的帮助文档,一起贡献给大家了,希望您能喜欢。 :D 具体的安装方法就是直接把这个压缩包里边的文件解压缩到jspwiki存储数据的目录,我这里是e:/cms/wiki中。
到这里下载插件包卷1和 卷2,这里下载 内容包,请用winrar解压缩。