静态站点部署
Static Site Generation & Deployment
自动生成Markdown报告并通过CI/CD部署为静态站点
子问题
1.Markdown报告的模板化生成
2.Jekyll front matter注入
3.GitHub Actions自动化工作流
4.定时触发与手动触发支持
5.H1 标题与 Jekyll title 的去重处理
6.双工作流职责分离(生成+部署 vs 纯部署)
7.双存储冗余(原始备份 + Jekyll post)
8.Emoji favicon 的 SVG data URI 注入
各项目的解法1 solutions
Signals
横向对比
| 维度 | Horizon |
|---|---|
| 部署工具 | peaceiris/actions-gh-pages@v4 + git worktree 双轨 |
| 站点生成器 | Jekyll(GitHub Pages 内置 Cayman 主题 + kramdown) |
| 内容注入方式 | 管线末端程序化注入 front matter,H1 剥离防重复 |
| 多语言支持 | front matter lang 字段 + Liquid where 过滤器双语路由 |
| 历史累积策略 | keep_files: true 增量发布,不清空 gh-pages 历史 |
| 本地部署 | git worktree 临时目录操作 gh-pages,零分支切换 |
最佳实践
1.使用peaceiris/actions-gh-pages简化部署
2.keep_files保留历史摘要
3.git worktree实现无切换分支部署
4.管线末端注入 front matter,保持内容生成与部署格式解耦
5.双工作流分离:daily-summary 负责全管线,deploy-docs 负责快速发布
6.future: true 配置避免时区差异导致文章不显示
7.Pangu 间距提升双语 Markdown 排版质量