GitPedia

Huxpro.github.io

My Blog / Jekyll Themes / PWA

From Huxpro·Updated June 22, 2026·View on GitHub·

[Hux Blog](https://huangxuan.me) ================================ The project is written primarily in HTML, distributed under the Apache License 2.0 license, first published in 2015. It has gained significant community traction with 7,612 stars and 6,572 forks on GitHub. Key topics include: blog-theme, jekyll-theme, jekyll-themes.

Hux Blog

I never expected this to become popular.

User Manual 👉

Getting Started

  1. You will need Ruby and Bundler to use Jekyll. Following Using Jekyll with Bundler to fullfill the enviromental requirement.

  2. Installed dependencies in the Gemfile:

sh
$ bundle install
  1. Serve the website (localhost:4000 by default):
sh
$ bundle exec jekyll serve # alternatively, npm start

Development (Build From Source)

To modify the theme, you will need Grunt. There are numbers of tasks you can find in the Gruntfile.js, includes minifing JavaScript, compiling .less to .css, adding banners to keep the Apache 2.0 license intact, watching for changes, etc.

Yes, they were inherited and are extremely old-fashioned. There is no modularization and transpilation, etc.

Critical Jekyll-related code are located in _include/ and _layouts/. Most of them are Liquid templates.

This theme uses the default code syntax highlighter of jekyll, Rouge, which is compatible with Pygments theme so just pick any pygments theme css (e.g. from here and replace the content of highlight.less.

Interesting to know more? Checkout the full user manual!

Other Resources

Ports

Starter/Boilerplate

  • Out of date. Helps wanted for updating it on par with the main repo

Translation

License

Apache License 2.0.
Copyright (c) 2015-present Huxpro

Hux Blog is derived from Clean Blog Jekyll Theme (MIT License)
Copyright (c) 2013-2016 Blackrock Digital LLC.

Contributors

Showing top 12 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from Huxpro/huxpro.github.io via the GitHub API.Last fetched: 6/22/2026