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
