作为一名IT从业者,无论是在公司团队中,还是在平时自己写一些笔记、博客等文档,我都习惯使用markdown来进行书写。在使用过许多支持markdown语法的系统或软件(如Typora、未知、我来、思源、觅道等)后,我总觉得它们不能满足我的需求。直到我发现了MinDoc这款针对IT团队开发的简单好用的开源文档管理系统。我们下面将介绍一下这个项目及如何使用docker-compose 快速部署。
项目具体介绍大家可看官网文档
官网地址:https://www.iminho.me/
项目地址:https://github.com/mindoc-org/mindoc
文档地址:https://www.iminho.me/wiki/docs/mindoc/mindoc-summary.md
演示站点:http://doc.iminho.me
测试用户:admin 密码:123456
_20230823065149.png
步骤 1:安装Docker和Docker Compose
如果您还没有安装Docker和Docker Compose,您需要先安装它们。可以在官方网站上找到适用于您操作系统的安装指南。
步骤 2:创建数据库 mindoc_db
准备一个mysql数据库,如果没有mysql 数据库的话可以参考我们之前的文章 使用 Docker Compose 部署 MySQL 8.0
搭建,搭建好之后创建一个数据库 mindoc_db
步骤 3:创建Docker Compose文件
docker-comopose.yml
version: "3.3"
services:
mindoc:
image: registry.cn-hangzhou.aliyuncs.com/mindoc-org/mindoc:v2.1
environment:
TZ: Asia/Shanghai
restart: always
ports:
- "8181:8181"
volumes:
- ./data/mindoc/conf:/mindoc/conf
- ./data/mindoc/static:/mindoc/static
- ./data/mindoc/views:/mindoc/views
- ./data/mindoc/uploads:/mindoc/uploads
- ./data/mindoc/runtime:/mindoc/runtime
- ./data/mindoc/database:/mindoc/database
environment:
- MINDOC_RUN_MODE=prod
- MINDOC_DB_ADAPTER=mysql
- MINDOC_DB_HOST=192.168.10.106
- MINDOC_DB_PORT=3306
- MINDOC_DB_DATABASE=mindoc_db
- MINDOC_DB_USERNAME=root
- MINDOC_DB_PASSWORD=123456
- MINDOC_CACHE=true
- MINDOC_CACHE_PROVIDER=file
- MINDOC_ENABLE_EXPORT=true
步骤 4:启动MinDoc
在包含 docker-compose.yml 文件的文件夹中,打开终端或命令提示符,运行以下命令来启动MinDoc:
docker-compose up -d
步骤 5:完成MinDoc部署
启动之后设置挂载文件夹data的权限
chmod -R 777 data
访问系统地址 http://192.168.10.108:8181/ 默认用户:admin 密码:123456
_20230823070430.png
具体功能介绍大家可阅读官网文档,我比较喜欢的它的md编辑器对于 HTML标签的支持,流程图、思维导图等的支持、历史版本的恢复合并及多级导航功能
_20230823071656.png
_20230823072327.png
_20230823072418.png
_20230823072602.png
_20230823072816.png