搭建一個知識管理平台, 用於知識庫管理/規范管理, 可以作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