xwiki是一个开源百科系统，网上的二次开发介绍挺少的，这里会根据我开发中的具体问题进行总结。由于我是边开发边写本文，最开始我也会很多都不清楚，请大家多指教。
目前xwiki的版本是5.2.1，我本地测试的版本是4.4.1 可能会有一些差异。
需要环境：tomcat服务器、mysql数据库，jdk，
1、下载xwiki
地址：http://enterprise.xwiki.org/xwiki/bin/view/Main/Download
其中包含了安装包和源代码包。（打开源代码你会发现是一堆maven项目，可能会修改的代码主要在xwiki-platform-master项目中。基本我们都是不需要修改java代码的，不过这个项目下面是很多你能接触到的，比如说搜索）
你最需要下载的包是war file。如下图：
下载的文件里面应该有一个xar结尾的文件，这个是xwiki的模板，如果没有，请寻找对应的版本下载一个。
下载地址在改页面能够找到。
2、tomcat下安装xwiki，并配置相关环境
- 前期准备：tomcat服务器，和mysql数据库。（这个安装就不用介绍了，我也是做测试使用，tomcat是使用版本6）
- 将xwiki的war文件放在tomcat目录下的webapps文件夹下，然后启动tomcat。（双击tomcat目录下bin文件夹中的startup.bat就好了，linux下是startup.sh）
- 此时xwiki项目会解压缩，并且在xwiki下部署一个项目。你会发现tomcat会报错，先不用管它。
3、进行参数配置
- 将mysql的驱动jar文件放到tomcat目录下的lib文件夹下面（也可以放到对应项目下面的lib文件夹）。
- 将xwiki.cfg文件下的xwiki.superadminpassword=system这个一行前面的注释去掉，这样可以你就可以使用帐号superadmin/system登陆了，这个是管理员权限。
- 建议将hsqldb数据库部分注释掉。（我就不截图啦）
- 放开mysql连接部分的注释，并且配置对应的值，注意，将mysql的驱动名编码格式选择正确（使用utf-8编码格式），配置正确的用户名和密码。
- 在对应的数据库中建立一个名为xwiki的数据库，注意使用编码格式是utf-8（与你上面的配置相对应，如果你修改的jar当中写死了一个连接，你还要与这个连接数据库名称一致）。
- 修改mysql的配置文件my.ini，在[mysqld]这一样下面增加一行
- max_allowed_packet=32M（因为mysql默认包大小最多是1兆，不修改这个参数的话你今后导入模板包的时候会报错）。
- 重新启动tomcat（保证mysql是开着的哈）。这时候xwiki会自动在你刚才建立的xwiki数据库中自动建立表格，并且导入部分数据。其中第一个表格，记录了url响应和类的对应关系哦，有兴趣的大神研究一下吧。
4、调试配置xwiki
此时在本地输入localhost/xwiki（如果你tomcat配置不是默认的80端口，请加上你的tomcat服务器的对应端口号，xwiki是我的项目名称，如果你的项目名称，也就是文件夹名字不是这个，请修改为对应的名称）就能进入xwiki的页面了。这个时候你看不到任何文档，也没有模板。
- 使用上面的帐号superadmin/system进行登录，按照下图进行，找到你下载的xwiki的初始模板.war文件，进行文件导入。
点击你上传的模板，在页面的右边会出现该模板的所以文件。将滚动条移动到最下方会发现有个导入按钮（import）。点击这个按钮导入模板。今后你可能会根据开发需要还要导入很多其他模板，请按照这个过程进行导入。
- 设置xwiki的语言为中文，en代表因为，zh代表中文（因为不同版本的翻译可能不一样，而且开发文档全部是英文的，可以的话就是用英文吧）
5、简单使用
好了，现在xwiki已经搭建起来了，目前可以基于这个进行开发了。
xwiki的基本模式是先建空间，空间下面可以建立页面（不能再建立空间了），页面下面可以建立子页面。页面和子页面的关系在每个页面information下面能够看到。
如果要进行xwiki的二次开发，那么您需要准备以下知识。
velocity（重要，据说阿里也推崇这个）和groovy，如果需要整体运行java代码的话，您还需要maven的知识。因为你开发xwiki的宏、对象和皮肤都需要可能会使用到这些知识，这些对于大神们肯定都不是问题。
上面提到的宏、对象和皮肤这些东西会在后续文章中介绍。一起学习xwiki的开发吧。
本文原创，来源地址：http://www.cnblogs.com/zhangwenhao/p/3437465.html