Jekyll

背景 这个博客从 2013 年底开始，使用 Jekyll 托管在 GitHub Pages 上，经历了几次主题变更。最近一次使用的是 jekyll-theme-chirpy 7.1.1。 积累了 55 篇文章后，决定重新审视技术栈选型，期望找到一个简单、优雅、有技术范的方案。 2026 年静态博客生态 在选型之前，整理了当前主流的静态站点生成器（SSG）对比： SSG 语言 构建速度 特点 Jekyll Ruby 中等 GitHub Pages 原生支持，生态最成熟 Hugo Go 极快 (<1ms/页) 单二进制，零依赖 Astro JS/TS 快 默认零 JS 输出，Island Architecture 11ty JS 快 灵活，多模板引擎 Zola Rust 极快 单二进制，内置 Sass/语法高亮 为什么选 Hugo + PaperMod 经过评估，最终选择 Hugo + PaperMod： 构建速度 — 54 篇文章构建时间 <100ms，Jekyll 需要数秒 PaperMod 主题 — 极简优雅，专注内容，暗色模式完美 零 Ruby 依赖 — hugo 单个二进制文件，装完即用 多语言原生支持 — Hugo 内置 i18n 机制，对中英双语友好 活跃维护 — PaperMod 社区活跃，2026 年仍在持续更新 迁移过程 1. 项目结构变化 1 2 3 4 5 6 7 8 # Jekyll 结构 # Hugo 结构 ├── _config.yml ├── hugo.yaml ├── _posts/ ├── content/posts/ ├── _data/ ├── static/ ├── _plugins/ ├── themes/PaperMod/ ├── _tabs/ ├── archetypes/ ├── Gemfile └── layouts/ └── assets/ 2. Front Matter 标准化 Jekyll 时期 front matter 格式不统一，迁移时统一为： ...

这是本站的第一篇博客。当时参考了许多 Jekyll 模板，借鉴 Pure 设计了一套自己的模板，托管在 GitHub 上。 源码：haoxiqiang-template Jekyll 简介 Jekyll 是一个静态站点生成器，将 Markdown、Liquid 模板等纯文本转换为完整的静态网站，无需数据库支持。结合 GitHub Pages 可免费托管博客。 功能支持 代码高亮 Jekyll 内置基于 Rouge 的代码高亮： 1 2 3 4 5 def print_hi(name) puts "Hi, #{name}" end print_hi('Tom') #=> prints 'Hi, Tom' LaTeX 公式 页面声明 latex: true 后可使用 MathJax 渲染数学公式： $$ \begin{aligned} \dot{x} &= \sigma(y-x) \ \dot{y} &= \rho x - y - xz \ \dot{z} &= -\beta z + xy \end{aligned} $$ $$ a^2 + b^2 = c^2 $$ When $a \ne 0$, there are two solutions to $ax^2 + bx + c = 0$. 预览分割线 使用 ` ...