文章简介
一直想开发或者找一个开源的软件，功能就类似看云一样，用来搭建属于一套自己的文档管理系统，将自己平常的东西集中化管理，形成一个手册。于是找到了mindoc这样一款不错的文档管理系统软件。本文大致介绍一下如何安装，基本的功能介绍。
功能介绍
主要功能包括文档管理、导出、团队管理、文章管理等功能。特别适合团队或者个人做一个知识库文档管理系统。
搭建环境
mindoc支持Linux和Windows系统环境，我这里使用的是Linux系统。系统的配置信息如下: Centos7.4； MySQL5.7; MySQL属于独立搭建的，如果不会的可以参考一下个人之前分享的一篇文章Linux搭建MySQL环境 ,其他的东西也没了，属于一个纯净的Linux系统。
搭建步骤
拉取源码
解压并配置环境
tar -zxvf mindoc_linux_amd64.zip找到config目录下面的app.config文件，如果不存在该文件，应该有一个app.config.example文件，将该文件复制一分，命名为app.conf即可.
cp app.conf.example app.conf#支持MySQL和sqlite3两种数据库，如果是sqlite3 则 db_database 标识数据库的物理目录db_adapter="${MINDOC_DB_ADAPTER||mysql}"db_host="${MINDOC_DB_HOST||127.0.0.1}"db_port="${MINDOC_DB_PORT||3306}"db_database="${MINDOC_DB_DATABASE||mindoc}"db_username="${MINDOC_DB_USERNAME||root}"db_password="${MINDOC_DB_PASSWORD||}"我这里使用的MySQL，因此将adapter改为mysql即可。下面的一些信息改成MySQL实际的配置信息即可。其他的配置信息就根据自己实际需要来做修改即可。
配置MySQL信息
# 创建mysql数据库create database mindoc;# 创建mysql用户CREATE USER 'username'@'host' IDENTIFIED BY 'password';# 授权给新建的mysql用户grant all ON databasename.tablename TO 'username'@'host';# 刷新全新啊flush privileges;注意事项
- username：创建的MySQL用户名称。
- host: MySQL用户授权地址，如果新建的MySQL用户只能本地登录，则使用127.0.0.1即可。如果需要允许该用户远程登录，则使用使用%。
- password：MySQL用户的密码
- databasename：新建MySQL用户授权对应的数据库。这里直接写新建的数据库mindoc即可。如果是授权所有数据库，则使用*表示。
- tablename：授权数据库对应的数据表，如果只是授权新建MySQL操作部分表，直接写表名，一般都是授权所有表，直接写*即可。
- grant all：这里指的给新建的MySQL用户，授予所有的权限。如果只是部分授权，例如增删改查，则使用insert,delete,update,select 代替，每一个权限之间用","隔开。
安装启动
初始化数据 进入mindoc解压的根目录，会发现有一个mindoc_linux_amd64文件，该文件为启动文件。执行下面的命令:
./mindoc_linux_amd64 install该命令的作用时初始化一些数据到MySQL中。就类似PHP很多软件，通过界面来安装应用。
启动服务
./mindoc_linux_amd64问题出现，在启动的过程中可能会出现如下的情况:
OperationalError: (_mysql_exceptions.OperationalError) (1055, "Expression #1 ofSELECT list is not in GROUP BY clause and contains nonaggregated column 'db.table.create_time' which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by") [SQL: u'SELECT table.create_time AS table_create_time, table.count AS table_count \nFROM table \nWHERE table.cluster_id = %s AND table.create_time > %s GROUP BY table.count'] [parameters: (1, datetime.datetime(2000, 1, 1, 0, 0))]在实际的过程中错误的语言不是这样的，在安装时忘记记录了，不过大致的错误信息是这样的。只要关注下面这一段错误码，就行了。1055, "Expression #1 of SELECT list is not in GROUP BY clause and contains nonaggregated column 'db.table.create_time' which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by"
解决问题。
mysql> show variables like 'sql_mode';+---------------+-------------------------------------------------------------------------------------------------------------------------------------------+| Variable_name | Value |+---------------+-------------------------------------------------------------------------------------------------------------------------------------------+| sql_mode | ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION |+---------------+-------------------------------------------------------------------------------------------------------------------------------------------+1 row in set (0.00 sec)执行下面的命令，将该sql_mode的配置信息改外其他的模式：
set @@sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION此时，再来查询该环境变量的值，就是如下的值了:
mysql> show variables like 'sql_mode';+---------------+------------------------------------------------------------------------------------------------------------------------+| Variable_name | Value |+---------------+------------------------------------------------------------------------------------------------------------------------+| sql_mode | STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION |+---------------+------------------------------------------------------------------------------------------------------------------------+1 row in set (0.00 sec)记得修改配置之后，一定的重启MySQL服务，否则是不会生效的。
重启mindoc服务。
./mindoc_linux_amd64如果需要将该服务以守护进程的方式启动，则在后面加一个 &即可。
使用mindoc
上面正常将服务启动并安装，接下来使用下面的链接即可访问:
# ip为你服务器ip地址，如果是本地则使用localhost，或者127.0.0.1ip:8181下面是几张页面的截图，由于功能很好上手使用，这里就不单独介绍如何使用功能了。 