跳到主要内容

发布到 GitHub Pages

目标​

把文档、博客和首页改动通过 GitHub Actions 构建并部署到 GitHub Pages，同时把内容质量检查放在发布前面。

一次性配置​

  1. 配置仓库与 Pages
  2. 选择 GitHub Actions 作为发布方式
  3. 确认默认分支和 Pages 设置

标准发布流程​

  1. 提交内容或代码改动
  2. 先通过 Content Quality 工作流，确认 handbook 生成产物、IA、内容质量和教学视频目录都一致
  3. 再通过站点 build
  4. 合并到 main 或 development
  5. 由 Deploy Docusaurus to GitHub Pages 自动部署

发布前检查​

  • 推荐直接运行：npm run verify:release
  • npm run check:handbooks
  • npm run check:ia
  • npm run check:content
  • npm run test:teaching-videos
  • npm run check:teaching-videos
  • npm run build

如果 Weekly 或手动生成的 Daily 仍然是草稿，确认它们保留 draft: true，不要误当作已发布内容。

风险与边界​

  • 不要跳过内容质量检查直接发布
  • 不要在 handbook 生成产物不同步时直接发布
  • 不要让 IA 结构漂移后只靠 build 兜底
  • 不要把草稿文章当成正式文章合并
  • 不要只看构建通过，而忽略内部链接和文档结构质量

相关文档​