研究资料归档系统搭建记录
背景 为了更好地整理和归档研究调研内容，决定将散落在飞书文档中的报告统一迁移到一个可公开访问、易于维护的静态网站。目标是： 双平台部署：GitHub Pages（主站）+ Cloudflare Pages（备份） 科技风格：简洁、快速、支持暗色模式 零成本：利用免费托管服务 易于维护：Markdown 写作，Git 版本控制 技术选型 对比了多个静态网站生成器： 方案 优点 缺点 Jekyll (Chirpy) GitHub Pages 原生支持 构建较慢，Ruby 依赖 Hugo (PaperMod) 极速构建，单二进制文件 学习成本略高 Astro 现代化，性能好 相对较新，生态较小 最终选择 Hugo + PaperMod，原因： 构建速度极快（毫秒级） PaperMod 主题简洁美观，科技风格 支持搜索、标签、归档等完整功能 单二进制文件，部署简单 部署架构 1 2 3 4 5 6 7 GitHub Repository │ ├─── GitHub Actions ─── Hugo Build ─── GitHub Pages │ (baseURL: github.io) │ └─── Cloudflare Pages ─── Hugo Build ─── CF CDN (baseURL: pages.dev) 关键配置 1. Hugo 配置 (hugo.toml) 1 2 3 4 5 6 7 8 9 10 11 baseURL = 'https://research-archive.pages.dev/' languageCode = 'zh-CN' title = '胡巧信的技术研究' theme = 'PaperMod' [params] defaultTheme = 'dark' ShowReadingTime = true ShowPostNavLinks = true ShowBreadCrumbs = true # ... 其他参数 注意：baseURL 设置为 Cloudflare 地址作为默认值。 ...