前言
學習過程中可能遇到不同方面的知識，數量多瞭要靠腦袋組織還是太困難，自己會的東西要和朋友要分享溝通也非常麻煩。
而擁有一個自己的Wiki，就能解決這兩個問題：1、自己對知識的整理；2、和其他人分享溝通。
現在有很多開源免費的軟件，隻要有一臺個人電腦就能部署一個自己的Wiki環境，何樂而不為。
開源Wiki中比較流行的是 Mediawiki 和 Dokuwiki，有興趣的話可以瞭解這兩個Wiki。
我這裡選的是 XWiki，形式上繼承瞭 Mediawiki 和 Confluence，個人比較喜歡。
但是XWiki網上資料比較散，沒有找到一個完整流程，中途也遇到中文字符相關問題，折騰瞭兩天才搭起來，所以記錄分享一下自己的部署過程。
（ 個人Web零基礎，所以如果有需要，不要擔心部署有困難，放手折騰 ）
（ 熟悉的話，不用一個小時就能搭起來自己Wiki ）
貓貓鎮樓，效果如下：
一、安裝配置流程
我這裡選擇的是 Tomcat 服務端 + MySQL 數據庫 + XWiki的組合。
XWiki可以支持各種類型的服務端和數據庫，具體可以看上面的官方安裝文檔，不必吊死在這一棵樹上
大概流程如下：
1、Java環境配置（JDK）
2、Tomcat 作為Web服務器
2.1、Tomcat中文字符配置
3、MySQL Server & WorkBench，數據庫管理Wiki條目
4、XWiki 安裝配置
5、XWiki中文配置 與 搜索引擎中文配置
參考：
官方安裝文檔：www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/
油管安裝流程視頻：https://www.youtube.com/watch?v=HWvvgNjf9ng&ab_channel=allthingstechnical
二、提前準備文件
所需要的安裝文件：
1. AdoptOpenJDK 11.0.17+8：https://adoptium.net/zh-CN/temurin/releases/?version=11 （Java環境）
2. MySQL Installer 8.0.32：https://dev.mysql.com/downloads/installer/ （建議下載400+MB的離線版本，不然要還要再等下載）
3. Apache Tomcat：https://tomcat.apache.org/ （Web服務端）
4. driver for mysql connector： https://dev.mysql.com/downloads/connector/j/
這裡要選Platform Independent下載的才是Connector
5. XWiki：https://www.xwiki.org/xwiki/bin/view/Download/ 選一個喜歡的版本，想穩就選Long Term Support，無所謂就無腦最新版。
要下載兩個文件，XWiki本體 .war包 和 初始主題 .xip 包。
6. XWiki 搜索引擎 中文分詞器：https://repo1.maven.org/maven2/org/apache/lucene/lucene-analyzers-smartcn/ 用來讓Wiki支持中文搜索
後面的詳細步驟中也會給出需要應用的下載鏈接
三、詳細過程
1、Java環境配置（JDK）
（這一步如果已經有瞭Java環境可以跳過）
直接下載Java安裝完事。我這裡直接用的默認路徑安裝。
JDK：OpenJDK11U-jdk_x64_windows_hotspot_11.0.18_10.msi
下載地址：https://adoptium.net/zh-CN/temurin/releases/?version=11
安裝好後，右鍵我的電腦 -> 高級系統設置 -> 環境變量，檢查添加JAVA_HOME系統變量配置，配置為安裝的jdk路徑。
配置完畢，打開cmd，輸入java -version，如果正確輸出瞭版本，這一步就算完成瞭。
2、Tomcat安裝
這部分參考官方：https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/InstallationWAR/InstallationTomcat/
先下載Tomcat：https://tomcat.apache.org/
官網列瞭部分版本Tomcat不兼容，這裡我的版本是8.5.87 apache-tomcat-8.5.87.exe Windows直接下載.exe安裝
可以選其他兼容的版本
安裝完畢，打開 Tomcatbinstartup.bat，在瀏覽器打開 localhost:8080，出現下面頁面就算成功。
打開 Tomcatconfcontext.xml，在最後加上：
打開 Tomcatconfserver.xml，在下圖位置加上：（設置字符集為UTF-8，開啟壓縮）
2.1、Tomcat8中文字符配置（UTF-8）
【我的Tomcat版本是 8.5.87，如果是其他版本可能不會有這個問題】
Tomcat8關鍵：由於需要中文環境，需要在 Tomcatbincatalina.bat 文件裡，加上一行：（否則會在後續傳遞中文到MySQL數據庫的時候報錯）
3、MySQL Server & WorkBench，數據庫管理Wiki條目
這部分參考官方文檔：https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/InstallationWAR/InstallationMySQL/
準備好MySQL Connector：mysql-connector-j-8.0.32.jar
下載MySQL 8.0.32 mysql-installer-community-8.0.32.0.msi
下載安裝以下兩個部分：
MySQL Server
MySQL Workbench 圖形化界面，不用黑框框手敲指令
安裝好後，先把 mysql-connector-j 文件放到 Tomcatlib 下，提供Tomcat到MySQL的連接。
然後打開 MySQL Workbench，建立一個連接Connection：localhost
建立新的Schema，命名為xwiki，並設置字符集為：utf8mb4 和 utf8mb4_bin
然後到 Query1 （或者MySQL控制臺都行）輸入下面的指令並執行：
然後再執行以下命令，將MySQL最大數據包大小改大（也可以手動到C:/ProgramData/下的MySQL路徑中，找到MySQL配置文件，修改：max_allowed_packet=64M），防止後續導入 XWiki 包時出錯。
4、XWiki 安裝配置
下載 XWiki 壓縮包：
XWiki：xwiki-platform-distribution-war-15.1.war
XWiki初始化主題 .xip 包：xwiki-platform-distribution-flavor-xip-15.1.xip
將 .war 包解壓到 Tomcatwebappsxwiki 文件夾下（用解壓縮應用直接解壓 .war 包），可以得到以下文件：
接下來需要配置兩個文件：
1、打開 TomcatwebappsxwikiWEB-INFxwiki.properties，找到 environment.permanentDirectory 字段，這個路徑就會是以後Wiki數據存儲的路徑
將其解除註釋（去掉前面的#號）設置路徑為你希望存儲Wiki數據的路徑
environment.permanentDirectory = 數據路徑
2、打開 TomcatwebappsxwikiWEB-INFhibernate.cfg.xml，配置XWiki與MySQL數據庫連接
找到 hibernate.connection.url 的配置，將這部分字段註釋或刪掉，改為：
最後解壓前面下載的 flavor-xip，將解壓縮得到的文件，放到前面配置的XWiki數據data存儲路徑下：
到這裡，XWiki就應當能夠開始運行瞭。
打開 Tomcatbinstartup.bat，然後打開網頁 http://localhost:8080/xwiki
如果看到XWiki的配置界面，前面的流程就算成功瞭。
註意：這裡最好重啟一次 Tomcat 和 XWiki 再進行後續配置，第一次打開 XWiki 可能無法正確識別下載好的 flavor離線包。
接下來按照XWiki的提示，註冊管理員賬號。（這個賬號是最高權限的管理員賬號，平時不需要的時候可以用普通賬號登錄）
接下來到XWiki的初始化主題，點擊下面的Flavor，然後點擊Install
由於前面用xip離線包提前獲取瞭需要下載的文件，所以這裡可以跳過下載，直接開始下一步安裝
安裝好後，點擊下一步就可以來到開頭的Wiki界面。（當然，你沒有貓，現在界面也還沒有漢化）
5、XWiki中文配置 與 搜索引擎中文配置
安裝好 XWiki 後，會看到界面都是英文，還需要配置中文。
找到右側側邊欄，點擊個人頭像，然後找到 Administer Wiki，然後到左側，搜索 local，點擊下面的 Localization，進行本地化配置。
將紅框部分的，支持語言 和 默認語言，都配置為 中文(中國)，點擊Save就可以看到界面漢化瞭。
XWiki中文配置，還隻是進行瞭界面的漢化。實際使用會發現，搜索時還搜不到中文，這時候可以：
1、在查詢配置中，將搜索引擎改為Database（但這種辦法會缺少搜索細節、高亮提示等信息）：
2、對Solr搜索引擎進行中文配置：
先關閉 Wiki 和 Tomcat。
下載中文分詞器：lucene-analyzers-smartcn-8.9.0.jar
將下載好的 .jar 文件，放入XWiki數據目錄下的： Data數據路徑storesolrsearchlib 中
然後配置文件：Data數據路徑storesolrsearchconfmanaged-schema
在文件最後加上以下配置：
現在再打開 Tomcat，訪問Wiki，等待搜索引擎索引完成，就能搜索中文瞭。
