（七）mkdocs学习——其他技巧

mkdocs学习笔记系列

• （一）MkDocs 学习——快速开始
• （二）MkDocs学习笔记——撰写文档
• （三）MkDocs学习——配置主题
• （四）MkDocs学习——自定义主题
• （五）MkDocs学习——配置文件
• （六）MkDocs学习——部署文档
• （七）mkdocs学习——其他技巧

部署技巧

当我们修改好文档时，需要执行mkdocs gh-deploy命令才能将其部署到GitHub Page上。

我们还可以采用CI持续集成工具在github上自动部署，即在根目录加上 .github/workflow目录，然后创建ci.yml文件，参考如下例子：

name: ci 
on:
  push:
    branches: 
      - master # 监测的分支
jobs:
  deploy:
    runs-on: ubuntu-latest # 拉去虚拟环境镜像
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-python@v2
        with:
          python-version: 3.x
      - run: pip install -r requirements.txt # 虚拟环境安装依赖
      - run: mkdocs gh-deploy --force # 会在虚拟环境部署站点，无需本地使用此命令

如此，在每次master分支push新东西都将引起一次CI持续集成的action，同时其中15行会再引起一次 gh-deploy action