博客搭建 #

为什么选择vitepress？ #

首先是它的构建速度非常快。之前用vuepress，每次构建至少得花11s，现在构建一次200ms左右，对于时常需要编辑代码的我来说，这个效率非常高⚡

其次非常简洁，相比于vuepress花里胡哨的表现形式，vitepress就是单纯文档的应用

创建本地项目 #

创建方法可以参考vitepress官方文档

把本地项目推送到github #

这个如果不懂的话可以百度

自动化部署(git actions) #

请首先看这篇说明。其中有几点注意事项：

创建yaml文件 #

在github项目tab栏点击actions，选择第一个模板。创建的模板yaml文件名字可以随意命名，比如main.yaml、cli.yaml等等（文件内容配置可看我的workflows配置）

配置yaml文件 #

on:
  push:
    branches:
      - main  # 这是项目主分支的名称，如果项目主分支名为master，此处就改为master
  workflow_dispatch:  # 这个选项为手动触发actions，主要用于第一次第一次push没成功，然后手动触发actions事件

...

jobs:
  build-and-deploy:
    strps:
      - name: Deploy
      with:
        ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN }}  
        #此处有两点注意：
        #1、如果此处改为secrets.GITHUB_TOKEN，则无需额外配置ACCESS_TOKEN，但此种方法不安全而且无法兼容travis
        #2、如果此处设为secrets.ACCESS_TOKEN，则需要配置ACCESS_TOKEN

创建personal access token（个人访问令牌） #

官网配置文档

创建secrets.ACCESS_TOKEN #

教程

创建git pages站点仓库 #

官方文档

创建项目gh-pages分支 #

在github的项目上创建gh_pages分支。如不会，请自行百度

设置项目pages #

官方文档

验证 #

• 本地push一次代码，然后看github上的actions的变化

• GitHub上随便修改一个文件内容，提交，然后观察github上的actions的变化