GitHub Pages 支持（暂未启用）

仓库当前为私有仓库，GitHub Pages 暂不启用。项目保留子路径构建和 workflow 模板，待仓库公开或确认账户计划与发布策略后再启用。

本地验证子路径构建

npm ci
npm run docs:build:github

该命令设置 SITE_BASE=/github-guides/。生成页面中的资源链接会带项目仓库子路径。

将来启用

1. 确认仓库公开范围、Pages 可用性和正式入口。
2. 把 .github/workflows/pages.yml.example 复制为 .github/workflows/pages.yml。
3. 在 GitHub 仓库 Settings → Pages 中选择 GitHub Actions。
4. 提交 workflow 后检查最小权限和 Pages artifact。
5. 明确 Cloudflare Pages 是主入口还是镜像。

当前 .example 文件不会被 GitHub Actions 自动执行。参考：VitePress GitHub Pages。