Hexo Theme Particle

hexo-theme-particle is a Hexo blog theme developed by korilin that provides three built-in color styles — full, night, and maiden — for running a static blog on the Hexo generator.

What is hexo-theme-particle?

hexo-theme-particle is a theme for the Hexo static site generator. It was created by the developer korilin after setting up multiple blogs, and it is distributed as a GitHub repository. The theme accepts Hexo site configuration and markdown posts, then renders a static blog with a configurable style: full, night, or maiden, with full as the default when the style field is missing or invalid. The author has stopped maintaining the project but states it should still be usable.

Key Features

• Three color styles — Choose full, night, or maiden via the style setting in the theme config; incorrect values fall back to full.
• Vue.js and Ant Design Vue icons — Navigation menu entries use Ant Design Vue icons, supporting the outlined and filled themes; icons without a theme property leave it blank.
• Built-in Gitalk comments — The theme includes Gitalk by default, configurable with GitHub clientID, clientSecret, repo, owner, and admin values.
• Customizable home header — Toggle the top info block with head_block_enable, and set a background using a CSS string such as background-image:url('../home.jpg') (with quotes) or background:black.
• Post sidebar info card — Show a description list, icon links (Ant Design icons or custom 118x18 pixel images), and friend links in a card beside articles.
• Footer with ICP filing — Configure the site start year and optional Chinese ICP filing code for self-hosted domains on servers in China.
• Stylus-based theming — Styles are written in Stylus with separate color files per theme; you can add a new color scheme by creating new-theme.styl and new-color.styl files and editing layout.ejs.

Who should use hexo-theme-particle?

• Hexo bloggers who want a ready-made theme with several visual styles, without building a theme from scratch.
• Multilingual or multi-blog owners — the author used it for three separate blogs (Chinese, English, and Japanese technical notes) with different styles per blog.
• Developers comfortable editing Stylus and EJS who want to create a custom color variant by extending the theme's existing style files.

What can you do with hexo-theme-particle?

• Personal bloggers: Install the theme and write markdown posts in Hexo to publish a static blog with navigation, tags, categories, and Gitalk comments.
• Self-hosted blog operators: Configure the footer ICP code to comply with Chinese regulatory requirements when using a custom domain.
• Theme customizers: Build a new color style by adding two Stylus files and a matching branch in layout.ejs.

How does hexo-theme-particle work?

Clone the repository into the themes/particle directory, disable Hexo's built-in highlight in _config.yml, then set the active theme to particle in the root Hexo config. After that, configure options such as style, menu, card, footer, and gitalk in the theme's _config.yml. Generate the site with hexo g after clearing the cache with hexo cl to see the changes.