xpage mysql_搭建xwiki知识库

最近两个月为项目组搭建了xwiki在线知识库。期间遇到了各种各样的困难，好在都被一一克服了。在此记录下整个过程，以方便日后翻阅。

搭建wiki之前需要准备的工具

开始安装：

安装Tomcat

在Tomcat\webapps目录下新建xwiki文件夹，并将XWiki War解压缩后放入其中

编辑Tomcat\conf\server.xml文件，

配置catalina.policy文件，参考这里

安装mysql数据库，创建用户数据库xwiki以及用户xwiki

编辑Tomcat\webapps\xwiki\WEB-INF\hinernate.cfg.xml文件，参考这里

将mysql-connector-java*.jar拷贝到Tomcat\webapps\xwiki\WEB-INF\lib目录

运行Tomcat\bin\Tomcat8w.exe启动或停止服务

由于使用Tomcat时，CKEditor一直无法使用，所以，请忽略上面的步骤。我采用了下面的策略：

安装了官方发布的独立安装包，即jetty+hsql这种组合

安装mysql，并建立数据库

配置WEB-INF\hibernate.cfg.xml文件，取消对mysql的注释

不知是由于我自己的网络质量差还是其他原因，我始终没有通过在线的方式完成安装，而是通过手动导入XAR的方式完成安装

即：我使用了jetty+mysql的组合方式。

其实，整个过程参考官方的说明即可。

若是在线安装扩展包，可能很慢很慢，所以可以尝试另一种途径：下载离线包，然后再导入。

离线安装包的下载链接为：

2017.04.12 00:03更新

添加office importer

1.安装open offcie，安装到C：\OpenOffice,路径中最好不要有空格

2.修改xwiki.properties文件

openoffice.serverType=0

openoffice.serverPort=8100

openoffice.autoStart=true

openoffice.homePath=C://OpenOffice

openoffice.profilePath=C://OpenOffice

openoffice.maxTasksPerProcess=50

openoffice.taskExecutionTimeout=30000

3.在OpenOffice安装目录下添加user文件夹

之后即可导入word文档

导出pdf文件时需要注意的地方

xwiki在导出pdf文件时需要特定的字体存在，字体文件保存在WEB-INF\fonts文件夹中。但是9.2这个版本需要在fop-config.xml文件中特别说明以下字体文件夹的全路径

D:\xwiki\webapps\xwiki\WEB-INF\fonts

而且需要在WEB-INF\classes路径下保存xhtml2fo.xsl以及fop-config.xml文件。

导入/导出页面需要注意的事项

在备份xwiki时，可以选择先导出所有页面，再导入。但是，导入页面时有几个地方需要注意：

如果XAR包的大小超过了32MB，需要修改xwiki的配置。配置方式请参见此处。

如果XAR中包含的页面比较多。xwiki会在导入时提示Server Error，控制台中的异常信息是“form too many keys”。解决办法是：不要一次性将所有页面都导入，而是分多次导入页面。

LDAP

http://extensions.xwiki.org/xwiki/bin/view/Extension/LDAP/Authenticator/

CKEditor

通过jar -cvfM D:\xwiki\ckeditor.jar D:\META-INF命令，将修改后的ckeditor-webjar.jar放到xwiki中。

修改方法是：将lang文件夹下的zh.js和zh-cn.js修改为统一的内容，然后清空客户端的浏览器缓存。

文档

http://platform.xwiki.org/xwiki/bin/view/SRD/Navigation?xpage=embed

http://www.xwiki.org/xwiki/bin/view/Documentation/DevGuide/API/