搭建一个知识管理平台, 用于知识库管理/规范管理, 可以作wiki, 可以将word/excel等导入进去, 支持全文搜索, 可以记周报, 会议纪要. 

现在有很多文档管理系统, 比如阿里的语雀、腾讯的 TAPD 平台也包括文档管理功能, 但这些系统需要联网的. 企业内文档协作工具不是很多, 最有名是收费的 confluence 了, 禅道有文档管理功能, 但功能较弱, 比较适合附件上传管理.  一直留意有没有好用的开源免费工具, 发现开源的 Xwiki 非常好(http://www.xwiki.org) . 

 Xwiki 特点:

1. 部署简单, 基于 Java + DBMS(MySQL/PgSQL/Oracle等支持)

2. 本身功能就强大, 又支持插件功能

3. 好用的编辑器, 使用 CK Editor

4. 支持多种渲染语法, 支持 markdown, 支持多种 wiki 变体语法

5. 使用 solr 支持全文本搜索. 

主页: http://www.xwiki.org

对比:www.wikimatrix.org/compare/confluence+xwiki 

============================

准备依赖软件包

============================

1. 下载 tomcat, tomcat配置参考 link 

2. 下载 MySQL, 官方推荐 5.7, 不要使用 8.x 版

3. 下载 MySQL jdbc connector, 必须是5.1.x, 不能太新

4. 下载 xwiki 的 war 包

============================

安装注意事项

============================

1. 下载 MySQL, 官方推荐 5.7, 不要使用 8.x 版

2. 下载 MySQL jdbc connector, 必须是5.1.x, 不能太新

3. MySQL数据库引擎必须是 innodb, 字符集选择 utf8, 我试了 utf8bm4 , 结果自动建表时报错. 

4. xwiki.properties 文件中, 需要设置 environment.permanentDirectory , 该路径将存储附件和 solr 引擎的临时文件. 

============================
安装后的配置工作
============================

刚安装后的 xwiki 的 UI 非常简陋, 功能也非常少, wiki 提供大量的 extension 来增强功能. 如果我们的 xwiki 服务器能联网, 在首次访问网站时, 会有向导协助安装插件. 如果不能上网, 安装比较麻烦, 下面是一些重要插件离线安装说明.

优质插件排行榜 https://extensions.xwiki.org/xwiki/bin/view/Main/#|t=extensions&p=1&l=300&s=installedCount&d=desc
这个网址可以下载 XAR 插件包.

1. XWiki Standard Flavor, Flavor 是 xwiki 扩展集合, 我们需要安装 Standard Flavor, 否则功能太弱了, 这个flavor 已经包含了下面绝大多数插件. 很多情况下, 我们的服务器不能联网, 可以提前下载 xip 格式的离线包, flavor的安装比较特别, 将 xip文件放到本地的extension/repository 目录下, 重新改扩展名为 zip , 然后解压. 重启 xwiki 应用后会自动运行 preference 设置向导, 其中第2步即安装离线 flavor, 第2步扫描离线 flavor 非常慢, 需要耐心等待好几分钟, 才能扫描出这个flavor. 详细安装过程搜索官网指南, 下载网址, http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-flavor-xip/

2. extension manager application 插件. 通过该插件可以列出已安装的插件, 可以卸载插件, 如果能联网还可以在线安装插件. 下载 XAR 格式即可, 注意该插件版本要和 xwiki 版本一致, 所以要自行确定真实的download url. 安装 xar 插件可以在 xwiki 页面上完成, 需要用管理员账号登录, 跳转到administer wiki 页面的 content/import 标签, 参考官网

3. Administration Application 插件, 它为其他很多插件提供了一个管理 option 页面, https://extensions.xwiki.org/xwiki/bin/view/Extension/Administration%20Application

3. Admin Tools Application 插件, 另一个管理类插件,主要用来检查xwiki 是否可能改善.

4. CKEditor Integration 插件, 可以将编辑器从 text 修改 为WYSIWYG 风格, 这样编辑器能比较地将 word/Excel 内容复制过来了.

5. Invitation Application 插件, 邀请被人来协作修改 wiki

6. Share Page Application 插件, 分享 wiki 页面

7. Notifications Application 插件, 接收修改通知的插件

8. Watchlist application, 主动关注页面的插件

9. Syntax Highlighting Application 插件

10. Mail Application 插件, 用来设置 smtp 信息, https://extensions.xwiki.org/xwiki/bin/view/Extension/Mail%20Application

============================
subwiki
============================
xwiki 老版本有 workspace 概念, 每个 workspace 都可以设置自己的用户、用户组、权限管理策略, 新版本使用 wiki 替换 workspace 概念。 xwiki 初始化后会自动创建一个 Home wiki, 管理员可以在 wiki index 管理界面中, 增删改 wiki。

多个 wiki 的使用场景:
1. 为不同team创建不同的 wiki, 每个team都能管理自己的用户. 同时每个wiki都有自己的入口页面, 每个team可自行组织自己的docment目录树, 互不干扰, 目录树可以做到简洁明了.
2. 即使是一个team, 也有使用多个 wiki 的需求, 比如其中一个 wiki 作为全开放的知识库, 对team内外都公开, 方便知识在整个组织内共享. 但总有一些知识不适合对外开放, 比如组内共用的账号密码, 这些只应在team内公开. 具体做法是:
(a) 新建一个私有的 wiki, 仅对team成员开放浏览权限.
(b) 在这个team 私有的wiki下, 建立账号密码页面.
(c) 在全开放的wiki下建一个页面, 包含私有页面 link.

============================

参考

============================

XWiki_安装和基础配置企业级知识库 https://juejin.im/post/5c1466d0f265da61407ecb80
xwiki安装部署 https://www.cnblogs.com/huandada/p/11050156.html
Xwiki安装部署详解 https://www.cnblogs.com/rangle/p/8646676.html
XWiki搭建(window+tomcat+MySQL+jdk) https://blog.csdn.net/sunlight96/article/details/82665534
XWIKI离线WAR包部署(LDAP登录) https://www.cnblogs.com/yizhishi/p/10674977.html