前言

學習過程中可能遇到不同方面的知識,數量多瞭要靠腦袋組織還是太困難,自己會的東西要和朋友要分享溝通也非常麻煩。

而擁有一個自己的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,等待搜索引擎索引完成,就能搜索中文瞭。