Fix 404 Error of English pages by github Actions.

Author: RenchZhao

.github/workflows/jekyll.yml

@@ -0,0 +1,81 @@
+# 工作流名称
+name: Deploy Jekyll site to Pages
+
+# 触发条件
+on:
+  # 在推送到默认分支时触发
+  push:
+    branches: ["main"]
+  # 允许手动触发
+  workflow_dispatch:
+
+# 权限设置
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# 并发设置，确保只有一个部署在进行
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+# 任务定义
+jobs:
+  # 构建任务
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      # 1. 检出代码
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      # 2. 设置 Ruby 环境
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.0' # 指定 Ruby 版本
+          bundler-cache: true # 自动运行 bundle install
+          cache-version: 0 # 缓存版本
+
+      # 3. 设置 Node.js 环境（如果需要）
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      # 4. 安装依赖
+      - name: Install dependencies
+        run: |
+          bundle install
+          npm install -g jekyll
+
+      # 5. 构建站点
+      - name: Build with Jekyll
+        run: bundle exec jekyll build --baseurl ""
+        env:
+          JEKYLL_ENV: production
+
+      # 6. 上传构建产物
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "./_site"
+
+  # 部署任务
+  deploy:
+    # 依赖构建任务
+    needs: build
+    
+    # 部署环境
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    
+    runs-on: ubuntu-latest
+    
+    steps:
+      # 1. 部署到 GitHub Pages
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

DEPLOY.md

@@ -0,0 +1,84 @@
+# GitHub Pages 部署配置指南
+
+## 问题描述
+
+使用 GitHub Pages 默认的 Jekyll 构建环境时，polyglot 插件无法正常工作，导致英文页面无法生成在 `/en/` 目录下。
+
+## 解决方案
+
+使用 GitHub Actions 自定义构建流程，确保使用正确的 Ruby 环境和插件。
+
+## 配置步骤
+
+### 1. 确保 workflow 文件已创建
+
+检查 `.github/workflows/jekyll.yml` 文件是否存在。这个文件定义了自定义构建流程。
+
+### 2. 配置 GitHub Pages 使用 GitHub Actions
+
+1. 打开 GitHub 仓库页面
+2. 点击 **Settings** > **Pages**
+3. 在 **Build and deployment** 部分：
+   - **Source**: 选择 "GitHub Actions"（而不是 "Deploy from a branch"）
+4. 保存设置
+
+### 3. 提交并推送 workflow 文件
+
+```bash
+git add .github/workflows/jekyll.yml
+git commit -m "Add GitHub Actions workflow for Jekyll build"
+git push origin main
+```
+
+### 4. 验证部署
+
+1. 推送后，GitHub Actions 会自动触发构建
+2. 查看构建进度：
+   - 打开 GitHub 仓库页面
+   - 点击 **Actions** 标签
+   - 查看 "Deploy Jekyll site to Pages" 工作流
+3. 构建成功后，访问网站验证：
+   - 中文首页: `https://renchzhao.github.io/`
+   - 英文首页: `https://renchzhao.github.io/en/`
+   - 中文简历: `https://renchzhao.github.io/cv/`
+   - 英文简历: `https://renchzhao.github.io/en/cv/`
+
+## 工作原理
+
+GitHub Actions workflow 会：
+
+1. **检出代码**: 获取最新的仓库代码
+2. **设置 Ruby 环境**: 安装指定版本的 Ruby 和 bundler
+3. **安装依赖**: 运行 `bundle install` 安装所有 gem 包，包括 polyglot
+4. **构建站点**: 运行 `bundle exec jekyll build` 构建静态网站
+5. **部署**: 将构建结果上传到 GitHub Pages
+
+## 故障排除
+
+### 构建失败
+
+如果构建失败：
+
+1. 查看 Actions 日志，找出错误信息
+2. 确保 Gemfile 中包含了所有必要的插件
+3. 确保 _config.yml 配置正确
+
+### 页面未生成
+
+如果某些页面未生成：
+
+1. 检查页面的 Front Matter 是否包含 `lang` 属性
+2. 检查 permalink 配置是否正确（不应包含语言前缀）
+3. 检查文件路径是否正确
+
+## 参考资料
+
+- [GitHub Pages 官方文档](https://docs.github.com/zh/pages)
+- [Jekyll 构建流程](https://jekyllrb.com/docs/continuous-integration/github-actions/)
+- [polyglot 插件文档](https://github.com/untra/polyglot)
+
+## 许可证
+
+本项目基于 Jekyll 框架开发，Jekyll 采用 MIT 许可证。
+原始版权信息如下：
+> Copyright (c) 2008-present Tom Preston-Werner and Jekyll contributors