自动发布你的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仓库中的settingssecrets可以设置一个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
Copyright by SKYNE all right reserved,powered by Gitbook 2022-01-06

results matching ""

    No results matching ""