用Mkdocs搭建个人网站

使用工具：Mkdocs + Github + 宝塔

1. 前言

1.1 总述

本网站的搭建方式分为三步：

1) 通过Mkdocs构建静态网站

2) 上传到Github构建Github Pages

3) 在服务器上定时拉取Github资源实现部署

如果没有服务器，只需要实现 1)和 2)即可实现网站的部署。不过这种方法部署的网站在Github（外网）上，国内访问不稳定。如果有服务器实现 3)部署，网站的访问质量会稳定很多。

下面按照上面三步顺序进行说明。

1.2 准备

一台电脑 + Github账号 + 一台服务器（可选项）

1) 一台电脑

常用设备，用于安装Mkdocs，本地编写Wiki文档、博客，方便保存文件。

2) Github账号

备份代码，同时构建Github Pages.

3) 一台服务器（可选）

网站部署的位置。

2. 通过Mkdocs构建静态网站

本地电脑安装Mkdocs

Mkdocs的安装需要Python环境，本文默认已经拥有Python环境。默认安装好了

选择一个主题

Mkdocs生成网站文件

将生成的文件上传服务器

生成的文件都在site文件夹内，接下来把文件夹的所有文件上传至/www/wwwroot/[webname]/文件夹内即可。

这里为了方便，直接通过宝塔上传。其他方案，比如Terminus或者VSCode通过SSH连接上服务器上传也可以，目的是将文件上传。

3. 上传到Github并构建Github Pages

新建Github仓库

4. 配置服务器

在服务器上安装宝塔

宝塔是一款方便配置站点环境的集成面板工具，对于不熟悉网站相关操作的新手来说比较友好。本文使用宝塔来配置服务器上所需要的相关环境。

官网说明：https://www.bt.cn/new/download.html

Linux安装指令如下：

Bash

if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

在宝塔面板配置服务器环境

参考资料^{1 2 3 4}

---

1. 尝试修改 mkdocs-material 网页的字体的过程记录——Ranald Luo ↩

2. mkdocs material 超全配置——wnc的咖啡馆 ↩

3. Material for Mkdocs: Setup——Material官方教程 ↩

4. Google Font——Google ↩