chore: replace legacy docs workflow with unified GitHub Pages deployment, update docs

Author: LessUp

.github/workflows/build.yml .github/workflows/ci.yml.github/workflows/build.yml renamed to .github/workflows/ci.yml

@@ -9,6 +9,13 @@ on:
 env:
   BUILD_TYPE: Release
 
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   build:
     name: ${{ matrix.os }} - ${{ matrix.compiler }}

.github/workflows/docs.yml .github/workflows/pages.yml.github/workflows/docs.yml renamed to .github/workflows/pages.yml

@@ -12,7 +12,10 @@ on:
       - "CONTRIBUTING.md"
       - "CONTRIBUTING.zh.md"
       - "book.json"
-      - ".github/workflows/docs.yml"
+      - ".gitbook.yaml"
+      - "package.json"
+      - "package-lock.json"
+      - ".github/workflows/pages.yml"
   workflow_dispatch:
 
 permissions:
@@ -29,13 +32,35 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          sparse-checkout: |
+            docs/en
+            docs/zh
+            examples/01-cmake-modern/README.md
+            examples/02-memory-cache/README.md
+            examples/03-modern-cpp/README.md
+            examples/04-simd-vectorization/README.md
+            examples/05-concurrency/README.md
+            README.md
+            README.zh-CN.md
+            SUMMARY.md
+            CONTRIBUTING.md
+            CONTRIBUTING.zh.md
+            book.json
+            .gitbook.yaml
+            package.json
+            package-lock.json
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 22
+          cache: npm
 
       - name: Install honkit
-        run: npm install honkit
+        run: npm ci
 
       - name: Build docs
         run: npx honkit build . _site

README.md

@@ -5,7 +5,7 @@ English | [简体中文](README.zh-CN.md) | [GitBook Sync Guide](docs/en/gitbook
 [![Build](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/build.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&label=Build)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/build.yml)
 [![Benchmarks](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/benchmark.yml?branch=main&style=for-the-badge&logo=speedtest&logoColor=white&label=Benchmarks)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/benchmark.yml)
 [![Sanitizers](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/sanitizers.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&label=Sanitizers)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/sanitizers.yml)
-[![Docs](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/docs.yml?branch=main&style=for-the-badge&logo=githubpages&logoColor=white&label=Docs)](https://lessup.github.io/cpp-high-performance-guide/)
+[![Docs](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/pages.yml?branch=main&style=for-the-badge&logo=githubpages&logoColor=white&label=Docs)](https://lessup.github.io/cpp-high-performance-guide/)
 
 A comprehensive collection of high-performance computing optimization examples and best practices for modern C++20.
 

README.zh-CN.md

@@ -5,7 +5,7 @@
 [![Build](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/build.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&label=Build)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/build.yml)
 [![Benchmarks](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/benchmark.yml?branch=main&style=for-the-badge&logo=speedtest&logoColor=white&label=Benchmarks)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/benchmark.yml)
 [![Sanitizers](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/sanitizers.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&label=Sanitizers)](https://github.com/LessUp/cpp-high-performance-guide/actions/workflows/sanitizers.yml)
-[![Docs](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/docs.yml?branch=main&style=for-the-badge&logo=githubpages&logoColor=white&label=Docs)](https://lessup.github.io/cpp-high-performance-guide/)
+[![Docs](https://img.shields.io/github/actions/workflow/status/LessUp/cpp-high-performance-guide/pages.yml?branch=main&style=for-the-badge&logo=githubpages&logoColor=white&label=Docs)](https://lessup.github.io/cpp-high-performance-guide/)
 
 面向现代 C++20 的高性能计算优化示例与最佳实践合集。
 

changelog/2026-03-10_pages-optimization.md

@@ -0,0 +1,22 @@
+# 2026-03-10 GitHub Pages 优化
+
+## 变更
+
+### GitHub Pages 工作流优化 (`pages.yml`)
+- **Sparse-checkout**：仅检出文档相关文件（docs/、examples/*/README.md、README.md 等），跳过 tests/、benchmarks/、cmake/、src/ 等大目录，显著减少 CI 检出时间和磁盘占用。
+- **npm 缓存**：`actions/setup-node` 启用 `cache: npm`，后续构建复用 node_modules 缓存，加速 honkit 安装。
+- **锁定 HonKit 版本**：新增 `package.json` + `package-lock.json`，将 honkit 固定为 `^3.7.1`，使用 `npm ci` 替代 `npm install`，确保可复现构建。
+- **补全 paths 触发条件**：新增 `.gitbook.yaml`、`package.json`、`package-lock.json` 触发路径。
+
+### Docs 徽章修复
+- 修复 `README.md` 和 `README.zh-CN.md` 中 Docs 徽章链接：`docs.yml` → `pages.yml`，与实际工作流文件名一致。
+
+### 新增文件
+- `package.json` — 声明 honkit 开发依赖，提供 `docs:build` / `docs:serve` 脚本。
+- `package-lock.json` — 锁定依赖版本，支持 npm 缓存和可复现安装。
+
+## 原因
+
+- 原工作流每次全量检出整个仓库（含 C++ 源码、测试、基准测试），仅为构建 Markdown 文档，浪费 CI 资源。
+- `npm install honkit` 无版本锁定，每次构建可能安装不同版本，存在不可复现风险。
+- Docs 徽章引用了不存在的 `docs.yml`，导致徽章状态始终显示异常。