Migrating the Site from Jekyll to Hugo

With the blessing of founder @biergaizi, @Zakkaus took over day-to-day maintenance of this site in 2025 and migrated it from Jekyll to Hugo.

Why Switch to Hugo

Jekyll needs a Ruby environment, builds are on the slow side, and its theme scene isn’t as lively as it used to be. Hugo is a single Go binary—builds are fast, deployment is simple, and multilingual support is built in. We went with the Blowfish theme.

What Got Migrated

• The _posts directory moved to Hugo’s Page Bundles (content/posts/<slug>/index.zh-cn.md)
• Front matter went from YAML to TOML
• Simplified and Traditional Chinese live side by side (zh-CN / zh-TW)
• Author data got pulled together under data/authors/
• Deployment moved to GitHub Actions, with the contributor list refreshed automatically on a schedule

Note: that’s the layout from the original Jekyll → Hugo migration. After the site migrated to Hextra in 2026 it changed again: front matter is all YAML now, content is split into per-language directories (content/zh-cn/, content/zh-tw/, files all named index.md), and author credits moved into the front matter as a map (no more data/authors/).

Feedback

• Telegram group: @gentoo_zh
• Telegram channel: @gentoocn
• File an Issue / PR: GitHub

Thanks to @biergaizi and @zhcj for founding and long maintaining the Gentoo Chinese Community, and to the developers of the Blowfish theme.