Deploy Ghost Theme with GitHub Actions 透過 GitHub Actions 部署 Ghost 主題

一直以來 Ghost 的官方主題都是免費開源且發佈在 GitHub 上，我們可以 Fork 到我的 Repositories 倉庫中也能作出修改，又或是不修改確保網站使用的主題是最新的。

目前所知 Ghost 有不少安裝主題的方法

1. 上傳主題 zip ，絕大多數的 Ghost 主題都能用。
2. 在 Setting > Design & Branding 中直接安裝主題，只有免費的官方主題可以用。
3. 在 https://ghost.org/themes 的免費主題，選擇安裝輸入網站url即可。
4. GitHub Actions 更新

GitHub Actions 🆕

用 GitHub Actions 更新讓後透過 ghost admin api 部署到做到主題自動部署。

首先登入 GitHub，然後找到自己心儀的 Ghost 主題，例如 Alto。

Instructions 步驟 🚶‍♂️

1. 首先到 Settings > Integrations > Create Custom Integration ，獲取 Admin API Key & Admin URL。[image]
2. 到 https://github.com/TryGhost/Alto 分叉 Fork 到 Repository 中。
3. 添加 Repository Secret - [image] [image]
   1. Settings > Security > Secrets & variables > Actions > New repository secrets
   2. 創建 GHOST_ADMIN_API_KEY 在 Secrets 中添加之前在 Ghost Integration 獲取的 Admin API Key
   3. 創建 GHOST_ADMIN_API_URL 在 Secret 中添加之前在 Ghost Integration 獲取的 Admin URL。
4. 回到 Repository 中新增 deploy theme.yml
   1. 建立新文件.github/workflows/deploy-theme.yml 加入Deploy Theme.yml 設置，commit 即可, 過不了多久完成部署後，可以看到有一 ✅。[image]
5. 完成後便可以在已安裝主題中找到 Alto 主題。

name: Deploy Theme
on:
  push:
    branches:
      - master
      - main
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Deploy Ghost Theme
        uses: TryGhost/action-deploy-theme@v1
        with:
          api-url: ${{ secrets.GHOST_ADMIN_API_URL }}
          api-key: ${{ secrets.GHOST_ADMIN_API_KEY }}

總結 🔚

用了 GitHub actions 讓部署主題變得很簡單，除了一開始比較多前期準備工作之外，其他的幾乎是不用操心，如果要加入功能的話（例如 Table of Contents），透過 GitHub 部署新功能。