关于MrDoc
MrDoc 是基于Python开发的在线文档系统。
MrDoc 适合作为个人和中小型团队的私有云文档、云笔记和知识管理工具,致力于成为优秀的私有化在线文档部署方案。
你可以简单粗暴地将 MrDoc 视为「可私有部署的语雀」和「可在线编辑文档的GitBook」。
MrDoc支持web端、浏览器插件、桌面端、安卓、小程序等多种访问方式,今天我们就来介绍下MrDoc的私有化部署(web模式)。
MrDoc主页:mrdoc.pro/
部署MrDoc
前置准备
首先我们得准备一台可上网的云服务器。
安装Docker
我们需要在准备好的云服务器中安装docker。我使用的是CentOS。
# 升级软件和内核,防止后续安装出现问题 yum -y update:升级所有包同时也升级软件和系统内核 yum -y upgrade:只升级所有包,不升级软件和系统内核 # 安装Docker依赖 yum install -y yum-utils device-mapper-persistent-data lvm2 # 添加docker yum源 yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo # 查看可用的docker版本 yum list docker-ce --showduplicates | sort -r # 选择一个版本安装 yum -y install docker-ce-20.10.9-3.el7 复制代码
启动docker、设置开机启动docker
systemctl start docker systemctl enable docker 复制代码
查看docker状态
systemctl status docker 复制代码
修改docker镜像源
我们首先打开daemon.json文件,vim /etc/docker/daemon.json
,然后向其中输入以下内容:
{ "registry-mirrors": [ "http://hub-mirror.c.163.com", "https://docker.mirrors.ustc.edu.cn", "https://registry.docker-cn.com" ] } 复制代码
然后保存退出,使用命令systemctl restart docker
重启docker服务。
使用命令docker info
查看镜像仓库信息。
启动MrDoc
MrDoc官方镜像地址(uwsgi):hub.docker.com/r/zmister/m…
MrDoc开源镜像地址(nginx):registry.hub.docker.com/r/jonnyan40…
更多部署方式:www.mrdoc.fun/doc/18/
本次我们选择nginx方式部署。使用如下命令启动:
docker run -d --name mrdoc -p 10086:10086 jonnyan404/mrdoc-nginx 复制代码
耐心等待一会...使用docker ps
就可以看到已经启动的MrDoc容器了。
访问MrDoc
我们在浏览器访问服务器ip+10086即可打开MrDoc首页。
配置MrDoc
配置管理员
我们在服务器中执行命令docker exec -it mrdoc python manage.py createsuperuser
创建管理员用户。
配置完后使用管理员账号进行登录。
后台管理
登录成功后,点击个人头像进入后台管理。
在后台管理中,我们可以对文档,模板,用户,系统等进行设置管理。
点击个人头像,选择返回首页,即可返回到MrDoc首页。
创建文集
文集就是文章的集合。如果你想要创建独立页面,那你选择创建文档即可。
我们点击新建,选择创建文集。
我们选择创建并添加文档,然后就可以开始编写文档了。
如上,我们能够发现MrDoc比较好的几个特点。
- MrDoc非常友好的支持了echarts图表。而且图片也能自动从粘贴板插入。
- MrDoc支持从word、txt、markdown、缓存等形式导入文档
最后
MrDoc作为开源的私有文档系统,可以说是非常好用了。和mm-wiki相比各有优缺,大家可以根据自己的需求自行选择。
点击这里了解更多实用开发工具。