MinDoc:针对IT团队的文档、笔记系统

骑猪看日落 2023-10-15 08:47 35阅读 0赞

作为一名IT从业者，无论是在公司团队中，还是在平时自己写一些笔记、博客等文档，我都习惯使用markdown来进行书写。在使用过许多支持markdown语法的系统或软件（如Typora、未知、我来、思源、觅道等）后，我总觉得它们不能满足我的需求。直到我发现了MinDoc这款针对IT团队开发的简单好用的开源文档管理系统。我们下面将介绍一下这个项目及如何使用docker-compose 快速部署。

#### MinDoc 简介 ####

项目具体介绍大家可看官网文档

官网地址：[ https://www.iminho.me/][https_www.iminho.me]

项目地址：[https://github.com/mindoc-org/mindoc][https_github.com_mindoc-org_mindoc]

文档地址： [https://www.iminho.me/wiki/docs/mindoc/mindoc-summary.md][https_www.iminho.me_wiki_docs_mindoc_mindoc-summary.md]

演示站点：[http://doc.iminho.me][http_doc.iminho.me]

测试用户:admin 密码:123456

![\_20230823065149.png][20230823065149.png]

#### 部署MinDoc ####

**步骤 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][20230823070430.png]

#### 使用介绍 ####

具体功能介绍大家可阅读官网文档，我比较喜欢的它的md编辑器对于 HTML标签的支持，流程图、思维导图等的支持、历史版本的恢复合并及多级导航功能

*  HTML标签

![\_20230823071656.png][20230823071656.png]

*  思维导图

![\_20230823072327.png][20230823072327.png]

![\_20230823072418.png][20230823072418.png]

*  流程图

![\_20230823072602.png][20230823072602.png]

*  历史版本

![\_20230823072816.png][20230823072816.png]

[https_www.iminho.me]: https://www.iminho.me/
[https_github.com_mindoc-org_mindoc]: https://github.com/mindoc-org/mindoc
[https_www.iminho.me_wiki_docs_mindoc_mindoc-summary.md]: https://www.iminho.me/wiki/docs/mindoc/mindoc-summary.md
[http_doc.iminho.me]: http://doc.iminho.me
[20230823065149.png]: https://img-blog.csdnimg.cn/img_convert/079e8518d540e51d4984b4d65df09383.png
[20230823070430.png]: https://img-blog.csdnimg.cn/img_convert/0519d3471a61398bb57f2783e07601e0.png
[20230823071656.png]: https://img-blog.csdnimg.cn/img_convert/203fdabf824aa916e27b3de2a43d467c.png
[20230823072327.png]: https://img-blog.csdnimg.cn/img_convert/1e2502a842aa8abf51561f46d429034c.png
[20230823072418.png]: https://img-blog.csdnimg.cn/img_convert/5a082375cf46e06225be05ea7a69e570.png
[20230823072602.png]: https://img-blog.csdnimg.cn/img_convert/574989648536c0005f2082daee68f6ab.png
[20230823072816.png]: https://img-blog.csdnimg.cn/img_convert/d389c79635bb9b18dbc22cfcf7162748.png