(转)项目Wiki的选择和配置

项目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中增加内容如下：

   <servlet> 
     <servlet-name>ImageMapServlet</servlet-name> 
     <servlet-class>
        com.ecyrd.jspwiki.plugin.ImageMapServlet
     </servlet-class> 
  </servlet> 
  
  <servlet-mapping> 
     <servlet-name>ImageMapServlet</servlet-name> 
     <url-pattern>/ImageMapServlet</url-pattern> 
  </servlet-mapping> 
  

如果还想使用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解压缩。