MinDoc 项目常见问题解决方案

MinDoc 项目常见问题解决方案

mindoc 项目地址: https://gitcode.com/gh_mirrors/min/mindoc

项目基础介绍

MinDoc 是一款针对 IT 团队开发的简单好用的文档管理系统。它最初是基于 PHP 框架 Laravel 开发的 SmartWiki 文档系统，但由于 PHP 的部署对普通用户来说较为复杂，因此改用 Golang 开发。MinDoc 可以用来存储日常接口文档、数据库字典、手册说明等文档，内置项目管理、用户管理、权限管理等功能，能够满足大部分中小团队的文档管理需求。

主要的编程语言是 Golang，框架基于 Beego。

新手使用注意事项及解决方案

1. 环境变量设置问题

问题描述：在安装 MinDoc 时，如果服务器上没有安装 Golang 程序，可能会遇到环境变量设置问题。

解决步骤：

1. 手动设置一个环境变量，键名为 ZONEINFO，值为 MinDoc 根目录下的 /lib/time/zoneinfo.zip。
2. 确保环境变量设置正确后，重新启动 MinDoc。

2. 数据库配置问题

问题描述：在使用 MySQL 存储数据时，可能会遇到编码问题，导致数据无法正确存储。

解决步骤：

1. 确保 MySQL 数据库的编码为 utf8mb4_general_ci。
2. 在安装前，将数据库配置填充到项目目录下的 conf/app.conf 中。
3. 如果使用 SQLite 数据库，则直接在配置文件中配置数据库路径即可。

3. 编译安装问题

问题描述：对于没有 Golang 使用经验的用户，可能会在编译安装过程中遇到问题。

解决步骤：

1. 从 MinDoc 发布页面 下载编译好的程序。
2. 如果有 Golang 开发经验，建议通过编译安装。要求 Golang 版本不小于 1.15.1（需支持 CGO、go mod 和 import _ "time/tzdata"），推荐 Go 版本为 1.18.1。
3. 注意：CentOS7 上 GLibC 版本低，常规编译版本不能使用，需要自行源码编译或使用 musl 编译版本。

总结

通过以上解决方案，新手用户可以更好地理解和使用 MinDoc 项目，避免在安装和配置过程中遇到常见问题。

mindoc 项目地址: https://gitcode.com/gh_mirrors/min/mindoc