MrDoc 基于 Python3
语言的 Django
框架编写而成,在安装 MrDoc 之前,请确保目标计算机上安装有 Python3
编程语言。
在 Linux 平台中,下述操作中的
pip
、python
等命令,可能需要替换为pip3
和python3
,请自行判断。
零、准备
操作系统:
- Windows
- Linux
- macOS
安装 Python 环境:
一、下载源码
MrDoc 开源版将源码托管自开源中国旗下的代码托管平台——码云和流行的代码托管平台——GitHub
。项目地址为:
1.1、安装Git
MrDoc 推荐使用 Git 工具进行项目代码的获取和更新。
如果你的计算机安装有 Git,可以跳到下一步;
如果你的计算机没有安装 Git,可以前往 Git 官网(https://git-scm.com/ )查询安装方法,然后进入下一步。
1.2、拉取项目源码
如果你的计算机上安装有 Git
工具,那么使用 git clone
命令可以直接将 MrDoc 的源码克隆到本地计算机上,其命令为:
git clone https://gitee.com/zmister/MrDoc
二、安装所需第三方库
MrDoc 安装所需的所有第三方库均通过 requirements 文件进行了描述,打开命令行界面,在/Mrdoc/目录下,运行如下 pip
命令,即可安装所有 MrDoc 所需的第三方库:
pip install -r requirements.txt
三、初始化数据库
在安装完所需的第三方库并配置好数据库信息之后,我们需要对数据库进行初始化。
觅思文档默认使用 sqlite 数据库进行数据存储,如果你有使用其他数据库的需求,请参考文档:自定义数据库配置
在项目路径下打开命令行界面,运行如下命令:
python manage.py makemigrations
接着,运行如下命令:
python manage.py migrate
执行完毕之后,数据库就初始化完成了。
四、创建管理员账户
在初始化完数据库之后,需要创建一个管理员账户来管理整个 MrDoc,在项目路径下打开命令行终端,运行如下命令:
python manage.py createsuperuser
按照提示输入用户名、电子邮箱地址和密码即可。
输入的密码不会显示在终端,输入完成后回车即可。
五、测试运行 MrDoc
在完成上述步骤之后,即可运行使用 MrDoc。
在测试环境中,可以使用 Django 自带的服务器运行 MrDoc,其命令为:
python manage.py runserver 0.0.0.0
运行上述命令,访问本机的 IP 地址,如果出现如下图所示的页面,表示 MrDoc
已经安装成功:
如果测试运行没有问题,那么可以将其部署到相应的服务器上,具体可参见《部署指南》