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

showdoc 简介
==========================
在线文档管理系统很多, 比如阿里的语雀、腾讯的 TAPD 平台也包括文档管理功能, 但这些系统需要联网的, 企业内文档协作工具不是很多, 最有名的是收费的 confluence 了, 禅道有文档管理功能, 但功能较弱, 比较适合附件上传管理.

这里介绍 Showdoc 这款开源(免费)文档管理系统, 可以部署企业内部, 后台使用 php + sqlite, 支持 Windows/Linux/Docker 部署形式. 
showdoc 的功能:
1. 文档编辑语法采用 markdown, 编辑器做的挺不错. 
2. 支持文档版本管理
3. 可以将文档导出为 word 软件格式
4. 权限控制: 可以新建公开项目和私密项目, 可以管理项目成员. 
5. 文档搜索功能: 可以在一个项目搜索文档, 支持全文搜索, 但不支持跨项目的搜索.

 

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

简要说明:

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

自动脚本脚本利用docker来安装运行环境,适用于linux服务器。如果你的服务器没有docker服务,脚本会尝试安装之。安装docker的过程可能有些慢。如果你已经安装过docker,脚本会省略部分步骤,从而加快showdoc安装进度。

当脚本安装docker失败时,你可以手动安装好docker后再执行脚本 。若装好了docker后还是再失败,则可根据此教程一步步地安装和调试: https://www.showdoc.cc/help?page_id=65610

如果服务器系统本身不支持docker,则只能通过手动安装PHP环境的方式来运行showdoc:https://www.showdoc.cc/help?page_id=13732

 

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

安装方法:

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

  #下载脚本并赋予权限
   wget https://www.showdoc.cc/script/showdoc;chmod +x showdoc;
  #默认安装中文版。如果想安装英文版,请加上en参数,如 ./showdoc en
  ./showdoc

 

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

安装后说明: 

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

#创建本地项目目录
mkdir -p /showdoc_data/html

#启动showdoc容器。启动完了后别忘记后面还有转移数据的步骤。 docker run
-d --name showdoc -p 4999:80 -v /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

  

安装好后,showdoc的数据都会存放在 /showdoc_data/html 目录下。./showdoc 脚本可放置在任何目录,方便以后使用。也可以重新从官方地址下载。

你可以打开 http://xxx.com:4999 来访问showdoc (xxx.com为你的服务器域名或者IP)。账户密码是showdoc/123456,登录后你便可以看到右上方的管理后台入口。建议登录后修改密码。

 

版权声明:本文为starfish29原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/starfish29/p/10640803.html