简易运行

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

>d 在 Linux 平台中，下述操作中的`pip`、`python`等命令，可能需要替换为`pip3`和`python3`，请自行判断。

## 零、准备

操作系统：

- Windows
- Linux
- macOS

安装 Python 环境：

- [Python 3.7~3.9](https://www.python.org/ "Python 3.7+")

## 一、下载源码

MrDoc 作为一个借鉴、参考和使用了众多开源应用的文档写作系统，基于 `GPL-3.0` 开源协议开源。

MrDoc 将源码托管自开源中国旗下的代码托管平台——码云和流行的代码托管平台——`GitHub`。项目地址为：

- 码云：[https://gitee.com/zmister/MrDoc](https://gitee.com/zmister/MrDoc)
- GitHub：[https://github.com/zmister2016/MrDoc](https://github.com/zmister2016/MrDoc)

### 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 数据库进行数据存储，如果你有使用其他数据库的需求，请参考文档：[自定义数据库配置](http://mrdoc.zmister.com/project-7/doc-1364/)

在项目路径下打开命令行界面，运行如下命令：

```
python manage.py makemigrations
```

接着，运行如下命令：

```
python manage.py migrate
```

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

## 四、创建管理员账户

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

```
python manage.py createsuperuser
```

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

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

## 五、测试运行 MrDoc

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

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

```python
python manage.py runserver 0.0.0.0
```

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

![hehehe](/media//202003/2020-03-29_210228_1585486987.jpg)

如果测试运行没有问题，那么可以将其部署到相应的服务器上，具体可参见[《部署指南》](https://doc.mrdoc.pro/doc/1362/)