在Github Pages中部署你的博客

优缺点

优点:免费、提交文章后自动部署(CI/CD)
缺点:需要科学上网、国内无法备案,无法使用国内CDN

部署步骤

0.需要支持科学上网,不然访问github可能会超时。

1.安装Git

2.在博客项目的根目录创建.github/workflows目录,在里面创建CI.yml文件(名称任意命名,但后缀一定要.yml)

.github
  - workflows
    CI.yml  

CI.yml文件内容如下:

name: A TO A:GH_PAGES
on: [push]
jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@master

      - name: Build and Deploy
        uses: jenkey2011/vuepress-deploy@master
        env:
          ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN }}
          TARGET_REPO: your_account/note # 你的仓库名称
          TARGET_BRANCH: gh_pages
          BUILD_SCRIPT: npm install && npm run docs:build
          BUILD_DIR: docs/.vuepress/dist/

3.到Github创建同名的远程仓库

注意,如果创建的仓库为私人仓库,则无法免费使用Github Pages的服务来部署你的Vuepress项目

4.创建本地仓库,并添加远程仓库

git init  
git remote add origin git@github.com:***/note.git  

5.在github里,点开头像->settings->developer settings->personal access token->generate token 创建一个新的密钥,然后复制它,或者记下来。

6.回到你的github项目,settings->secrets and variables->actions->new repository secrets,添加一个名称为ACCESS_TOKEN的token,将刚刚你复制的密钥放进去,保存。

7.push你的代码到远程仓库

git push origin master

8.在github项目,settings->pages->branchs,选择gh-pages分支,save。等待一段时间后,刷新页面,就会显示你的vuepress已经部署成功。

参考

vuepress官方文档:https://vuepress.vuejs.org/zh/guide/getting-started.htmlopen in new window

Last Updated:
Contributors: dongyz8