最近在搭建知识库,然后捣鼓了这个mkdocs

先从头说,首先是配置环境,直接pip install即可

估计是直接上传到pip可以直接获取的地方了,这样一install然后全部依赖就都有了

然后是新建一个知识库,最后部署用的是mkdocs gh-deploy,或者本地预览用mkdocs build

这个mkdocs gh-deploy的逻辑是把编译成html的文件放在.\site\目录下,然后上传到分支

branch

但是主分支不会变

于是乎写了个批处理,直接丢环境变量里面了

1
2
3
4
5
6
7
8
9
10
11
12
#!/bin/bash

# 进入指定的目录
cd /home/coper/KnowledgeBase/ || exit 1

# 执行 git 操作
git add .
git commit -m "Auto Commit"
git push

# 部署 MkDocs
mkdocs gh-deploy

同时,为了避免重复上传,还需要把./site/加入到.gitignore

这样,就完成了一键部署