Ghost 博客升级到3.0后,启用了一项重要功能:利用 Github Actions 功能部署主题。

在以往版本,用户如果要修改主题,需要不断的通过把修改后的主题压缩包通过后台上传,费工费时,有时还会出现权限不足问题。

利用Github Actions,则可以利用Github 在代码管理和远程调试中的便捷性,对主题进行即时更新调试。

  1. 通过Ghost Admin创建自定义集成应用,生成一组Ghost Admin API凭据。

  2. 在GitHub上,导航到主题存储库»“设置”»“secrets”。创建一个名为GHOST_ADMIN_API_URL包含 API URL 的密钥,以及一个名为 GHOST_ADMIN_API_KEY包含 Admin API Key 的密钥。

  3. 详细Github Actions 参考阮一峰写的教程 ,如果Github 设置中没有secrets ,可以到这个网址申请测试资格 。

  4. 设置好密钥后,在GitHub 官方市场](https://github.com/marketplace?type=actions) 收索Ghost 官方主题部署actions,复制示例配置中的.github/workflows/deploy-theme.yml,放在主题到repositories根目录中。

    name: Deploy Theme
    on:
      push:	
        branches:	
          - master
    jobs:
      deploy:
        runs-on: ubuntu-18.04
        steps:
          - uses: actions/checkout@master
          - uses: TryGhost/action-deploy-theme@v1.0.0
            with:
              api-url: ${{ secrets.GHOST_ADMIN_API_URL }}
              api-key: ${{ secrets.GHOST_ADMIN_API_KEY }}
    
  5. Github +Ghost 会自动部署新主题,在Ghost 后台 design 中即可看到新的主题出现,激活该主题, 以后,每次修改推送主题源码,GitHub Actions 都会自动运行,将构建产物发布到主题,不再需要上传压缩包。