Blog Migration: From Jekyll Chirpy to Hugo PaperMod

Fri, 26 Jun 2026 00:00:00 +0000

Documenting the migration from Jekyll + Chirpy to Hugo + PaperMod, including selection analysis and GitHub Pages best practices in 2026

Building a Blog with Jekyll

Sat, 21 Dec 2013 22:19:05 +0000

This is the first post of this blog. I referenced many Jekyll templates at the time, adapted a custom theme inspired by Pure, and hosted it on GitHub.

Source code: haoxiqiang-template

Jekyll Overview

Jekyll is a static site generator that converts plain text (Markdown, Liquid templates) into a complete static website without requiring a database. Combined with GitHub Pages, it provides free blog hosting.

Features

Code Highlighting

Jekyll has built-in syntax highlighting powered by Rouge:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom'

LaTeX Math Rendering

Set latex: true in the page front matter to enable MathJax rendering:

$$ \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$.

Excerpt Separator

Use `