问题域/PD-469

静态站点部署

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 排版质量