feat(ci): 支持禁用 GitHub Pages 部署

为 GitHub Pages 部署步骤添加条件判断,通过 ENABLE_GITHUB_PAGES 变量控制
This commit is contained in:
rbetree
2026-01-17 21:10:02 +08:00
parent 06bbf3336c
commit c6937429b8
2 changed files with 22 additions and 1 deletions

View File

@@ -131,14 +131,22 @@ jobs:
# exit 1
fi
# GitHub Pages 部署步骤(仅在启用时执行)
# 说明:
# - 如果你使用 Vercel/Cloudflare Pages 等第三方平台部署,可以跳过这些步骤
# - 设置 repository variable ENABLE_GITHUB_PAGES=false 来禁用 GitHub Pages 部署
# - 默认启用 GitHub Pages 部署以保持向后兼容
- name: Setup Pages
if: ${{ vars.ENABLE_GITHUB_PAGES != 'false' }}
uses: actions/configure-pages@v4
- name: Upload artifact
if: ${{ vars.ENABLE_GITHUB_PAGES != 'false' }}
uses: actions/upload-pages-artifact@v3
with:
path: 'dist'
- name: Deploy to GitHub Pages
if: ${{ vars.ENABLE_GITHUB_PAGES != 'false' }}
id: deployment
uses: actions/deploy-pages@v4

View File

@@ -507,6 +507,19 @@ server {
- 设置构建命令为`npm run build`
- 设置输出目录为`dist`
**如果您只使用第三方平台部署(不使用 GitHub Pages**
为避免 GitHub Actions 中的 Pages 配置错误,您可以禁用 GitHub Pages 部署步骤:
1. 进入仓库的 Settings -> Secrets and variables -> Actions
2. 点击 "Variables" 标签页
3. 点击 "New repository variable"
4. 名称填写:`ENABLE_GITHUB_PAGES`
5. 值填写:`false`
6. 点击 "Add variable"
设置后GitHub Actions 仍会自动构建网站包括书签处理、RSS 同步等),但会跳过 GitHub Pages 部署步骤,避免报错。第三方平台(如 Vercel/Cloudflare Pages会自动检测到代码变化并部署。
> 如果你希望在构建时刷新“时效性数据”RSS 文章聚合、projects 仓库统计),请将构建命令改为:
>
> ```bash