git clone --depth=1 https://github.com/theme-shoka-x/astro-blog-shokax.git
cd ./astro-blog-shokax
pnpm install
pnpm run dev

{
  "name": "你的-worker-名稱",
  "compatibility_date": "2026-07-30",
  "assets": {
    "directory": "./dist",
    "not_found_handling": "404-page"
  }
}

npx wrangler deploy --assets ./dist --name 你的-worker-名稱 --compatibility-date 2026-07-30

name: Deploy Astro ShokaX to GitHub Pages

# 當有新的提交推送到 main 分支時觸發；
# 另外加上 workflow_dispatch，讓你可以在 Actions 頁面手動觸發
# （例如沒有新的提交，但想重新發布一次）
on:
  push:
    branches:
      - main
  workflow_dispatch:

# 從 Actions 直接發布 Pages 需要這三個權限：
# pages: write   用來發布
# id-token: write 用來讓 deploy-pages 取得 OIDC 身分驗證
# contents: read  用來 checkout 原始碼
permissions:
  contents: read
  pages: write
  id-token: write

# 同一時間只允許一個部署。這裡刻意用 false：新的推送只會跳過還在排隊的舊 run，
# 但不會中斷正在發布中的部署（中途取消 deploy-pages 有可能讓 Pages 環境卡住）
concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  # 拆成 build 與 deploy 兩個作業，deploy 用 needs: build 等待建置完成。
  # 兩個作業都在最新版本的 Ubuntu 環境中執行。
  build:
    runs-on: ubuntu-latest
    # 為 build 設置 20 分鐘的超時限制
    timeout-minutes: 20
    steps:
      # 1. 使用 actions/checkout 把倉庫中的所有檔案和目錄複製到 GitHub Actions 執行器的工作目錄中
      - name: Checkout Repository
        uses: actions/checkout@v7

      # 2. 設置 pnpm 與 Node.js
      - name: Set up pnpm
        uses: pnpm/action-setup@v4
        with:
          version: 11.22.0

      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "22"
          cache: pnpm

      # 3. build 之前，configure-pages 會把 Pages 的設定注入建置環境
      - name: Configure Pages
        uses: actions/configure-pages@v6

      # 4. 依照 pnpm-lock.yaml 安裝依賴。
      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      # 5. 建置站點並產生 Pagefind 搜尋索引
      - name: Build
        run: pnpm run build

      # 6. 上傳 dist/ 目錄下的產物（編譯後的靜態網頁）作為 Pages artifact
      - name: Upload artifact
        uses: actions/upload-pages-artifact@v5
        with:
          path: ./dist

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      # 7. deploy-pages 會把上一步的 artifact 部署到 Pages
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v5

name: Deploy Astro ShokaX to Public Repo

on:
  push:
    branches:
      - main
  workflow_dispatch:

concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v7

      - name: Set up pnpm
        uses: pnpm/action-setup@v4
        with:
          version: 11.22.0

      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "22"
          cache: pnpm

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      - name: Build
        run: pnpm run build

      # 用剛才存進 Secrets 的 `API_TOKEN_GITHUB` 進行身份驗證
      # 把 `dist/` 推送到公開倉庫（例如 `minz71/minz71.github.io`）的 `main` 分支
      - name: Pushes to another repository
        uses: cpina/github-action-push-to-another-repository@main
        env:
          API_TOKEN_GITHUB: ${{ secrets.API_TOKEN_GITHUB }}
        with:
          source-directory: "./dist"
          destination-github-username: "minz71"
          destination-repository-name: "minz71.github.io"
          user-email: XXX@gmail.com
          target-branch: main