==========================
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,登录后你便可以看到右上方的管理后台入口。建议登录后修改密码。