欢迎光临散文网 会员登陆 & 注册

零基础快速搭建个人Wiki（XWiki+Tomcat+MySQL）

2023-03-19 16:06 作者:LanDaze  | 我要投稿

前言

学习过程中可能遇到不同方面的知识，数量多了要靠脑袋组织还是太困难，自己会的东西要和朋友要分享沟通也非常麻烦。

而拥有一个自己的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/

油管安装流程视频：youtube.com/watch?


二、提前准备文件

所需要的安装文件：

1. AdoptOpenJDK 11.0.17+8：adoptium.net/zh-CN/temu （Java环境）

2. MySQL Installer 8.0.32：dev.mysql.com/downloads （建议下载400+MB的离线版本，不然要还要再等下载）

3. Apache Tomcat：tomcat.apache.org/ （Web服务端）

4. driver for mysql connector： dev.mysql.com/downloads

这里要选Platform Independent下载的才是Connector

5. XWiki：xwiki.org/xwiki/bin/vie 选一个喜欢的版本，想稳就选Long Term Support，无所谓就无脑最新版。

要下载两个文件，XWiki本体 .war包 和 初始主题 .xip 包。

6. XWiki 搜索引擎 中文分词器：repo1.maven.org/maven2/ 用来让Wiki支持中文搜索


三、详细过程

1、Java环境配置（JDK）

（这一步如果已经有了Java环境可以跳过）

直接下载Java安装完事。我这里直接用的默认路径安装。

JDK：OpenJDK11U-jdk_x64_windows_hotspot_11.0.18_10.msi

下载地址：adoptium.net/zh-CN/temu

安装好后，右键我的电脑 -> 高级系统设置 -> 环境变量，检查添加JAVA_HOME系统变量配置，配置为安装的jdk路径。

配置完毕，打开cmd，输入java -version，如果正确输出了版本，这一步就算完成了。


2、Tomcat安装

这部分参考官方：xwiki.org/xwiki/bin/vie

先下载Tomcat：tomcat.apache.org/

官网列了部分版本Tomcat不兼容，这里我的版本是8.5.87 apache-tomcat-8.5.87.exe Windows直接下载.exe安装

可以选其他兼容的版本

安装完毕，打开 Tomcat\bin\startup.bat，在浏览器打开 localhost:8080，出现下面页面就算成功。

打开 Tomcat\conf\context.xml，在最后加上：

<Resources cachingAllowed="true" cacheMaxSize="100000" ></Resources>

打开 Tomcat\conf\server.xml，在下图位置加上：（设置字符集为UTF-8，开启压缩）

URIEncoding="UTF-8"
compression="on"
compressionMinSize="2048"
compressableMimeType="text/html,text/xml,text/css,text/javascript,application/x-javascript"


2.1、Tomcat8中文字符配置（UTF-8）

【我的Tomcat版本是 8.5.87，如果是其他版本可能不会有这个问题】

Tomcat8关键：由于需要中文环境，需要在 Tomcat\bin\catalina.bat 文件里，加上一行：（否则会在后续传递中文到MySQL数据库的时候报错）

set "JAVA_OPTS=%JAVA_OPTS% %LOGGING_CONFIG% -Dfile.encoding=UTF-8"

3、MySQL Server & WorkBench，数据库管理Wiki条目

这部分参考官方文档：xwiki.org/xwiki/bin/vie

准备好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 文件放到 Tomcat\lib 下，提供Tomcat到MySQL的连接。

然后打开 MySQL Workbench，建立一个连接Connection：localhost

建立新的Schema，命名为xwiki，并设置字符集为：utf8mb4 和 utf8mb4_bin

然后到 Query1 （或者MySQL控制台都行）输入下面的指令并执行：

CREATE USER 'xwiki'@'localhost' IDENTIFIED BY 'xwiki';
grant all privileges on *.* to xwiki@localhost;


4、XWiki 安装配置

下载 XWiki 压缩包：

XWiki：xwiki-platform-distribution-war-15.1.war

XWiki初始化主题 .xip 包：xwiki-platform-distribution-flavor-xip-15.1.xip


将 .war 包解压到 Tomcat\webapps\xwiki 文件夹下（用解压缩应用直接解压 .war 包），可以得到以下文件：

接下来需要配置两个文件：

1、打开 Tomcat\webapps\xwiki\WEB-INF\xwiki.properties，找到 environment.permanentDirectory 字段，这个路径就会是以后Wiki数据存储的路径

将其解除注释（去掉前面的#号）设置路径为你希望存储Wiki数据的路径

environment.permanentDirectory = 数据路径

2、打开 Tomcat\webapps\xwiki\WEB-INF\hibernate.cfg.xml，配置XWiki与MySQL数据库连接

找到 hibernate.connection.url 的配置，将这部分字段注释或删掉，改为：

<property name="connection.url">jdbc:mysql://localhost/xwiki</property> <property name="connection.username">xwiki</property> <property name="connection.password">xwiki</property> <property name="connection.driver_class">com.mysql.jdbc.Driver</property> <property name="connection.useUnicode">true</property> <property name="connection.characterEncoding">UTF-8</property>

最后解压前面下载的 flavor-xip，将解压缩得到的文件，放到前面配置的XWiki数据data存储路径下：

到这里，XWiki就应当能够开始运行了。

打开 Tomcat\bin\startup.bat，然后打开网页 localhost:8080/xwiki

如果看到XWiki的配置界面，前面的流程就算成功了。


接下来按照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数据路径\store\solr\search\lib 中

然后配置文件：Data数据路径\store\solr\search\conf\managed-schema

在文件最后加上以下配置：

<!-- smartcn分词器 -->
<dynamicField name="*_zh" type="text_smartcn" indexed="true" stored="true" multiValued="true" />
<dynamicField name="*_zh_CN" type="text_smartcn" indexed="true" stored="true" multiValued="true" />
<dynamicField name="*_zh_TW" type="text_smartcn" indexed="true" stored="true" multiValued="true" />

<!-- smartcn分词器 -->
<fieldType name="text_smartcn" class="solr.TextField" positionIncrementGap="100">
<analyzer type="index">
<tokenizer class="org.apache.lucene.analysis.cn.smart.HMMChineseTokenizerFactory"/>
<filter class="solr.StopFilterFactory" ignoreCase="true" words="stopwords.txt" />
<filter class="solr.LowerCaseFilterFactory"/>
</analyzer>
<analyzer type="query">
<tokenizer class="org.apache.lucene.analysis.cn.smart.HMMChineseTokenizerFactory"/>
<filter class="solr.StopFilterFactory" ignoreCase="true" words="stopwords.txt" />
<filter class="solr.SynonymFilterFactory" synonyms="synonyms.txt" ignoreCase="true" expand="true"/>
<filter class="solr.LowerCaseFilterFactory"/>
</analyzer>
</fieldType>

现在再打开 Tomcat，访问Wiki，等待搜索引擎索引完成，就能搜索中文了。


标签：个人WikiXWikiWiki部署WebWiki

零基础快速搭建个人Wiki（XWiki+Tomcat+MySQL）的评论 (共 条)

分享到微博请遵守国家法律