大家好,我是Mandy。今日给大家引荐一款开源、合适个人和小型团队的文档、常识、笔记在线办理体系。
之前写了一篇思想导图的东西,后台有收到读者的私信,在问询是否有能够适用团队、支撑私有化布置的文档办理体系,恰好最近个人也在由于资料过多,难以办理的问题。本来是想个人开发这样一套体系,尽管功用不复杂,但也要时间去开发,所以想到去找一套合适这样场景的开源体系。
提到文档办理体系,市面上也有十分多的渠道,功用也十分的强大。例如语雀文档、看云文档、飞书文档、腾讯文档等等,这些文档尽管不需求自己去建立体系、功用十分的强大、在一定程度上也能够免费运用,但不太契合私有化布置的要求,而且过于依赖渠道,渠道变化也会跟着变化,一起里面的一些图片、图形、思想导图很难迁移到其他的渠道,便放弃挑选第三方渠道。
今日要共享的一款开源文档办理体系叫做MrDoc
,MrDoc是一个合适个人和小型团队的文档、常识、笔记在线文档办理体系。这个体系运用的是Python开发,建立也十分的简略。你彻底不用担心不会Python,而忧虑体系建立,官方也有几种建立方法,从我个人建立的方法来说,引荐运用docker建立,差不多几分钟就能建立成功。
东西介绍
MrDoc 觅思文档,是一款自托管、私有布置的在线文档办理体系和常识库。整个体系分为开源版和专业版,不过开源版已经很满意许多的业务场景。总结下来它有这样的几个特点:
东西优势
1、书写快捷
支撑运用「Markdown」和「富文本」创立文本文档,运用「在线表格」创立在线表格记载表格数据,文档的创作简便且高效。
2、沉浸阅览
在双栏式阅览界面中,你能够在左边栏快速检查和挑选纲要,在右方阅览文档内容,像读书一样阅览文档,带来特殊的阅览体会。
3、权限管控
支撑多种方法对文集、文档的阅览权限(公开、私密、指定用户可见、拜访码可见)、协作权限(初级协作、高档协作)以及用户的创作权限进行操控,为所欲为对权限进行管控!
4、导入导出
文档导入,方便你迁移保存本地文档和第三方体系的文档。文档导出,则满意在非线上环境下的文档运用需求。(第三方体系的数据导入功用开发中)。
5、全渠道支撑
除了网页Web端,还支撑阅览器扩展、桌面客户端(Windows、Linux、macOS)、APP端(安卓、IOS)、小程序端,基本完成全渠道和多终端同步。
6、素材办理
支撑图片和附件的办理,支撑附件格局白名单配置,支撑第三方OSS存储配置,支撑PDF、Office和常见文本文件的附件预览。
7、私有化布置
应用布置在自己的计算机设备(云服务器、本地服务器、电视盒子、群晖……)和网络中(公网、内网),数据彻底自己掌握,不用担心隐私和数据走漏、SaaS产品忽然停止服务。
8、继续更新
产品在继续地迭代开发和更新,Web 端稳定坚持每月发布一个新版本的节奏,其他终端依据功用开发和 Bug 修正状况不定期进行新版本发布。
运用场景
1、常识办理
将常识按文集进行归类,无限层级文档,用在常识办理上,让常识不再碎片化和零星化。
2、团队文档
将 MrDoc 用作团队内部的文档库房,汇聚团队技能,沉淀团队经验,堆集团队数字财物。
3、产品手册
书本化的结构,合适作为产品的说明手册来呈现,特别是有多个产品需求编写文档手册的时分。
4、在线教程
用 MrDoc 编写、共享和分发你的在线教程,体系化、体系化地输出自己的常识。
支撑渠道
1、web端
经过网页web端,你能够一处编写,随时经过阅览器即可拜访,方便快捷。
2、桌面客户端
能够经过桌面客户端,脱离阅览器标签页的纷乱搅扰,沉浸式地编写文档。
3、阅览器扩展
一起是支撑阅览器扩展的方法,支撑顺手快速编写文档、剪藏网页内容。
4、手机APP
支撑Windows、Mac桌面客户端,以及iOS和Android等设备,快捷的移动和碎片化文档办理,不再受时空限制。
综上所述,这样是我为什么挑选MrDoc的原因,接下来就开始共享怎么建立MrDoc文档办理体系。
体系建立
关于MrDoc文档办理体系,官网也有十分详细的教程,你也能够直接依照官方教程建立即可。这儿我就不多介绍,简略演示一下运用Docker在Linux体系上的建立过程。
这儿我就只演示开源版的建立过程,关于专业的建立也差不多。
1、克隆代码到服务器本地
# /home/wwwroot是你装置的目录,依据你需求挑选即可,没有什么要求
cd /home/wwwroot && git clone https://gitee.com/zmister/MrDoc.git
这儿需求注意一下,后续的所有操作都是在/home/wwwroot目录下面。
2、导入Docker镜像
docker pull zmister/mrdoc:v6
3、运转Docker容器
docker run -d --name mrdoc -p 10086:10086 -v /opt/MrDoc:/app/MrDoc zmister/mrdoc:v6
这儿第一个10086是你主机的端口号,第二个10086是容器也是MrDoc的服务端口。第一个端口号能够依据你自己的需求修正,只要本地没有被运用的端口号即可,第二个端口号最好不要修正,运用默认的端口号。
4、创立账号
docker exec -it mrdoc python manage.py createsuperuser
运用上面的指令,会自动弹出指令窗口,让你输入账号。
5、修正密码
docker exec -it mrdoc python manage.py changepassword 用户名
后边的用户名,便是第4步中创立的账号。
6、拜访预览
履行完上诉操作之后,你就能够直接运用http://IP:10086
拜访即可,这儿的10086是前面提到的第一个10086端口号,需求坚持一致。假如你再Linux上建立的,不能正常拜访,这时分你能够关注一下是否是防火墙的问题。
不过不引荐运用IP 端口的方法拜访
,你能够直接运用web服务做一个端口署理,运用域名来拜访。
端口署理
这儿以NGINX
作为web服务器,假设域名是a.baidu.com
。你需求在NGINX中增加如下配置即可。
server{
listen 80;
server_name a.baidu.com;
location / {
proxy_pass http://127.0.0.1:10086;
}
}
配置好之后,重启NGINX服务即可。nginx -s reload
。
效果预览
这儿罗列几张官网的预览效果图。