自动发布你的Gitbook

1.发布步骤

• 1.Github已配置好 Github-Pages
• 2.Github设置Personal access tokens
• 3.仓库设置Actions secrets
• 4.创建Github Actions的配置文件
• 5.推送代码

1.1配置Github-Pages

• 略

1.2配置Personal access tokens

• 创建个人访问令牌
• 参考上述文档进行创建Personal access tokens，注意设置过去时间，最好定期更换Personal access tokens
• Personal access tokens可以代替命令行或者API中的密码，因此一定要注意Personal access tokens的安全性

1.3配置Actions secrets

• secrets是项目中的加密环境变量
• 可以将配置的Personal access tokens的值作为secrets从而可以被Actions脚本读取到，获取权限推送代码
• 在 username.github.io仓库中的settings、secrets可以设置一个Actions secrets
• 创建时Name字段建议为: ACCESS_TOKEN, Value即为Personal access tokens的值

1.4创建Github Actions的配置文件

• 在这里我们使用Github Action For Gitbook来定义我们的workflow
• 在仓库根目录下的新建.github/workflows目录并添加gitbook-action.yml文件

gitbook-action.yml

name: 'Gitbook Action Build'
on:
  push:
    branches:
      - master  # trigger branch
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout action
      uses: actions/checkout@v2
    - name: Gitbook Action           # https://github.com/ZanderZhao/gitbook-action/releases
      uses: ZanderZhao/gitbook-action@v1.2.4  # -> or ZanderZhao/gitbook-action@master.  If not use master click above, use latest please 
      with:                                   #    or fork this repo and use YourName/gitbook-action@master
        token: ${{ secrets.ACCESS_TOKEN }}  # -> remember add this in settings/secrets as following

1.5.推送代码

• 推送代码: 略
• 查看username.github.io仓库中的 Actions页面即可看到正在运行的workflows
• workflow运行失败与否都会邮件通知你
• 至此，就可以专注于写作
• 熟练的情况下，你甚至不需要本地预览你的Gitbook