大家好,我是Mandy。今日给大家引荐一款开源、合适个人和小型团队的文档、常识、笔记在线办理体系。

之前写了一篇思想导图的东西,后台有收到读者的私信,在问询是否有能够适用团队、支撑私有化布置的文档办理体系,恰好最近个人也在由于资料过多,难以办理的问题。本来是想个人开发这样一套体系,尽管功用不复杂,但也要时间去开发,所以想到去找一套合适这样场景的开源体系。

提到文档办理体系,市面上也有十分多的渠道,功用也十分的强大。例如语雀文档、看云文档、飞书文档、腾讯文档等等,这些文档尽管不需求自己去建立体系、功用十分的强大、在一定程度上也能够免费运用,但不太契合私有化布置的要求,而且过于依赖渠道,渠道变化也会跟着变化,一起里面的一些图片、图形、思想导图很难迁移到其他的渠道,便放弃挑选第三方渠道。

今日要共享的一款开源文档办理体系叫做MrDoc,MrDoc是一个合适个人和小型团队的文档、常识、笔记在线文档办理体系。这个体系运用的是Python开发,建立也十分的简略。你彻底不用担心不会Python,而忧虑体系建立,官方也有几种建立方法,从我个人建立的方法来说,引荐运用docker建立,差不多几分钟就能建立成功。

开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系

东西介绍

MrDoc 觅思文档,是一款自托管、私有布置的在线文档办理体系和常识库。整个体系分为开源版和专业版,不过开源版已经很满意许多的业务场景。总结下来它有这样的几个特点:

东西优势

开源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 编写、共享和分发你的在线教程,体系化、体系化地输出自己的常识。

开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系

支撑渠道

1、web端

经过网页web端,你能够一处编写,随时经过阅览器即可拜访,方便快捷。

2、桌面客户端

能够经过桌面客户端,脱离阅览器标签页的纷乱搅扰,沉浸式地编写文档。

3、阅览器扩展

一起是支撑阅览器扩展的方法,支撑顺手快速编写文档、剪藏网页内容。

4、手机APP

支撑Windows、Mac桌面客户端,以及iOS和Android等设备,快捷的移动和碎片化文档办理,不再受时空限制。

开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系

综上所述,这样是我为什么挑选MrDoc的原因,接下来就开始共享怎么建立MrDoc文档办理体系。

体系建立

关于MrDoc文档办理体系,官网也有十分详细的教程,你也能够直接依照官方教程建立即可。这儿我就不多介绍,简略演示一下运用Docker在Linux体系上的建立过程。

开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系

这儿我就只演示开源版的建立过程,关于专业的建立也差不多。

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

效果预览

这儿罗列几张官网的预览效果图。

开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系
开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系
开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系
开源MrDoc,一个合适个人和小型团队的文档、常识、笔记在线办理体系