技术分享是程序员中十分重要的学习方式,对分享者来说总结自己在项目进行过程遇到的问题更重新梳理思考问题的过程,加深印象,而对于阅读者也可以规避掉前人踩过的坑,找到解决的思路或方法,鉴于此想法,笔者想要搭建公司内部的wiki平台,用于技术分享使用。
因为公司的开发环境以Java为主,因此选用JSPWiki进行搭建。
- 一、前期环境准备
需要先在服务器上搭建好JDK+Tomcat环境,配置好环境变量,这里不再赘述。
- 二、部署JSPWiki包
1、下载JSPWiki包,地址
http://www-us.apache.org/dist/jspwiki/
里面有多个版本包,下载JSPWiki.war包以及jspwiki-wikipages-zh_CN-2.10.2包,前者是部署war包,后者是中文页面。
2、将JSPWiki.war包放在服务器Tomcat安装路径下的webapps文件夹下,启动Tomcat,自动编译war,在webapps文件夹下生成JSPWiki文件夹。
注意:网上很多教程,此步可以将JSPWiki.war改成自己的名字,笔者尝试后发现,这样部署上去的包中间链接会出现问题,例如访问路径为 http://127.0.0.1:8080/MyWiki/的页面点击某个链接,跳转到 http://127.0.0.1:8080/JSPWiki/xxx.jsp ,显示404找不到,因此建议不修改war包的名称。
3、 在浏览器中打开localhost:8080/JSPWiki/Install.jsp(即http://<myhost>/<appname>/Install.jsp)来初始化设置wiki,
填写pageDir的位置,提交会在Tomcat/temp下生成jspwiki-custom.xml
#Tue Feb 07 10:35:40 CST 2017
jspwiki.basicAttachmentProvider.storageDir=D\:\\\\\\\\Program Files\\\\\\\\Apache Software Foundation\\\\\\\\Tomcat 7.0\\\\\\\\JSPWiki\\\\\\\\temp
jspwiki.fileSystemProvider.pageDir=D\:\\\\\\\\Program Files\\\\\\\\Apache Software Foundation\\\\\\\\Tomcat 7.0\\\\\\\\JSPWiki\\\\\\\\temp
jspwiki.pageProvider=VersioningFileProvider
jspwiki.applicationName=MyWiki
jspwiki.workDir=D\:\\\\\\\\Program Files\\\\\\\\Apache Software Foundation\\\\\\\\Tomcat 7.0\\\\\\\\temp
jspwiki.baseURL=http\://127.0.0.1\:8090/JSPWiki/
log4j.appender.FileLog.File=D\:\\\\\\\\Program Files\\\\\\\\Apache Software Foundation\\\\\\\\Tomcat 7.0\\\\\\\\temp\\\\\\\\jspwiki.log
#日志文件的路径
log4j.appender.FileLog.File=D:/program/jspwiki/wiki_content/jspwiki.log
#支持中文搜索
jspwiki.lucene.analyzer = org.apache.lucene.analysis.cjk.CJKAnalyzer
jspwiki.encoding = UTF-8
#支持html
jspwiki.translatorReader.allowHTML = true
#使用模板
jspwiki.templateDir=star_zh_CN
注意:直接修改
jspwiki-custom.xml文件,重启Tomcat生效不了,如果需要直接修改文件生效,需要将该文件放在lib文件夹下以及conf文件夹下。
- 三、加载中文模板
此时的JSPWiki已经可以正常访问了,但使用的是默认的模板,要使用中文模板,则将JSPWiki\templates下的haddock重命名为default。
jspwiki-wikipages-zh_CN-2.10.2.rar包解压后,将文件夹里面的txt文件复制到jspwiki.fileSystemProvider.pageDir 配置的路径下面。
至此,JSPWiki搭建结束,后续可根据需要进行页面的修改和增加。