==========================
showdoc 簡介
==========================
在線文檔管理系統很多, 比如阿里的語雀、騰訊的 TAPD 平台也包括文檔管理功能, 但這些系統需要聯網的, 企業內文檔協作工具不是很多, 最有名的是收費的 confluence 了, 禪道有文檔管理功能, 但功能較弱, 比較適合附件上傳管理.
這里介紹 Showdoc 這款開源(免費)文檔管理系統, 可以部署企業內部, 后台使用 php + sqlite, 支持 Windows/Linux/Docker 部署形式.
showdoc 的功能:
1. 文檔編輯語法采用 markdown, 編輯器做的挺不錯.
2. 支持文檔版本管理
3. 可以將文檔導出為 word 軟件格式
4. 權限控制: 可以新建公開項目和私密項目, 可以管理項目成員.
5. 文檔搜索功能: 可以在一個項目搜索文檔, 支持全文搜索, 但不支持跨項目的搜索.
==========================
安裝
==========================
部署手冊:https://www.showdoc.cc/help?page_id=13732
我使用的是 docker 安裝, 對應的幫助: https://www.showdoc.cc/help?page_id=65610 , 下面代碼就是摘自這個幫助文檔, 只是將宿主機的 /howdoc_data 修改為 /home/docker/howdoc_data
# 由於國內鏡像與官網原鏡像同步可能延遲，如果有網絡條件，建議使用原鏡像。如果網絡不好，建議使用國內鏡像 # 國內鏡像安裝命令 docker pull registry.docker-cn.com/star7th/showdoc #國外官方鏡像安裝命令 #docker pull star7th/showdoc #新建存放showdoc數據的目錄 mkdir /home/docker/howdoc_data mkdir /home/docker/showdoc_data/html chmod 777 -R /home/docker/showdoc_data #啟動showdoc容器。啟動完了后別忘記后面還有轉移數據的步驟。 docker run -d --name showdoc -p 4999:80 -v /home/docker/showdoc_data/html:/var/www/html/ registry.docker-cn.com/star7th/showdoc #轉移數據。執行這里的時候留意命令行界面有沒有權限禁止的錯誤提示。 #如果有，則檢查權限，或者安全限制（比如說可能selinux會禁止docker進程寫文件） docker exec showdoc \cp -fr /showdoc_data/html/ /var/www/ # 權限 chmod 777 -R /showdoc_data
完成上面步驟后, 使用瀏覽器訪問 http://localhost:4999
缺省管理員賬號密碼為: showdoc/123456
如果目錄不可寫等錯誤信息, 需要進入docker 容器中, 開放幾個目錄的寫權限.
報錯信息:
目錄 [ ./server/Application/Runtime/ ] 不可寫！
開放幾個目錄的寫權限的步驟:
docker exec -i -t showdoc /bin/sh chmod 777 -R /var/www/html/server/Application chmod 777 -R /var/www/html/install chmod 777 -R /var/www/html/Public/Uploads/ chmod 777 -R /var/www/html/Sqlite/