州的先生 开源的在线文档系统MrDoc安装使用

一、安装环境

• Win10 X64，测试环境：在本地系统运行

二、前期工具准备

1.1 安装Git

到官网下载相应版本Git并安装

https://git-scm.com/

1.2 安装Python3

到官网下载相应版本Python3并安装

https://www.python.org/downloads/release/python-381/

在使用git bash的时候python是不能直接运行的，为了实现这一点需要永久声明一个别名：

alias python='winpty python.exe'

在git bash里升级pip：

python -m pip install --upgrade pip

1.3 使用git clone命令可以直接将MrDoc的源码克隆到本地计算机上，其命令为：

git clone https://gitee.com/zmister/MrDoc

1.4 打开Git bash命令行界面，进入/Mrdoc/目录下，运行如下pip命令，即可安装所有MrDoc所需的第三方库：

pip install -r requirements.txt

若上面命令安装失败，则手动安装依赖库requirements.txt，在win下安装：

pip install django
pip install Pillow
python -m pip install pytz
pip install sqlparse

三、配置自定义数据库

默认情况下，MrDoc使用Django的SQLite数据库，如果你使用的是MrDoc源码附带的Sqlite数据库，则无需另外配置数据库。

http://mrdoc.zmister.com/project/7/11/

四、初始化数据库

在项目路径下打开命令行界面，运行如下命令生成数据库迁移：

python manage.py makemigrations

接着，运行如下命令执行数据库迁移：

python manage.py migrate

五、创建管理员账户

python manage.py createsuperuser

按照提示输入用户名、电子邮箱地址和密码即可。

六、部署MrDoc

在完成上述步骤之后，即可运行使用MrDoc。

在测试环境中，可以使用Django自带的服务器运行MrDoc，其命令为：

python manage.py runserver