MrDoc 基于 Python3 语言的 Django 框架编写而成,在安装 MrDoc 之前,请确保目标计算机上安装有 Python3 编程语言。

在 Linux 平台中,下述操作中的pippython等命令,可能需要替换为pip3python3,请自行判断。

零、准备

操作系统:

  • 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 所需的第三方库:

bash
pip install -r requirements.txt

三、初始化数据库

在安装完所需的第三方库并配置好数据库信息之后,我们需要对数据库进行初始化。

觅思文档默认使用 sqlite 数据库进行数据存储,如果你有使用其他数据库的需求,请参考文档:自定义数据库配置

在项目路径下打开命令行界面,运行如下命令:

python manage.py makemigrations

接着,运行如下命令:

python manage.py migrate

执行完毕之后,数据库就初始化完成了。

四、创建管理员账户

在初始化完数据库之后,需要创建一个管理员账户来管理整个 MrDoc,在项目路径下打开命令行终端,运行如下命令:

python manage.py createsuperuser

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

输入的密码不会显示在终端,输入完成后回车即可。

五、测试运行 MrDoc

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

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

python
python manage.py runserver 0.0.0.0

运行上述命令,访问本机的 IP 地址,如果出现如下图所示的页面,表示 MrDoc 已经安装成功:

hehehe

如果测试运行没有问题,那么可以将其部署到相应的服务器上,具体可参见《部署指南》


州的先生 2023年4月14日 20:59 收藏文档