HexoBlog

hexo-blog-theme — Hexo Blog Template

By breght-van-baelen

Beautiful-hexo is a blog theme ported from Beautiful-jekyll to Hexo. It has a clean style, supports archives, tags, RSS, and sitemap generation, and includes built-in NetEase Gentie comment configuration.

Open Source SiteDownload Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews
Author preview
Author-provided previewTop of page

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

A Hexo blog theme ported from Beautiful-jekyll, maintaining a clean typographic style

02

Relies on plugins such as hexo-generator-archive and hexo-generator-tag to generate archives and tag pages

03

Outputs RSS and sitemap through hexo-generator-feed and hexo-generator-sitemap

04

Supports hexo-browsersync for automatic refresh during local development

05

Includes built-in NetEase Gentie comment configuration, requiring productKey to be filled in the theme _config.yml

06

The tags page requires manually creating source/tags/index.md and adding an entry to the navigation bar

Template Details

Beautiful-hexo is a Hexo blog theme ported from Beautiful-jekyll. In the README, the author describes its positioning as "simple and elegant." The theme itself does not include a separate build process; it is used as the theme directory of a Hexo site, with the theme switched and the archive generator configured through the site root _config.yml.

In terms of functionality, the README explicitly mentions the need to install plugins such as hexo-generator-archive, hexo-renderer-jade, hexo-generator-tag, hexo-generator-feed, hexo-generator-sitemap, and hexo-browsersync, indicating that the theme relies on these plugins to generate archives, tags, RSS, and sitemaps and to support browser synchronization. For comments, it provides a configuration method for NetEase Gentie (netease-gentie), requiring comment.netease.productKey to be set in the theme's _config.yml, and during testing the website domain must match the settings in the NetEase Gentie backend. The tags page requires manually creating a tags folder and index.md in the source directory, and adding an entry in the theme configuration's navbar-links.

In terms of limitations, the README does not specify the theme's browser compatibility range, responsive breakpoints, or performance metrics; the preview image comes from images/hexo-preview.png in the repository and serves only as a visual reference. The theme configuration options are described in the README as "short and clear," but they are not listed item by item; the actual available configuration should be based on the _config.yml in the repository.

HexoBlog

Is it right for your project?

Use Cases

  • Building a personal blog with Hexo and wanting to apply a clean theme
  • Needing basic blog features such as archives, tags, RSS, and sitemap
  • Wanting to integrate NetEase Gentie as the article comment system
  • Previewing page changes locally with hexo-browsersync

Suitable For

  • Users who already use Hexo and are familiar with _config.yml configuration
  • Blog authors who prefer clean typography and do not need complex front-end interactions
  • Users willing to manually install multiple Hexo plugins and create a tags page according to the README

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    First run hexo init site and enter the site directory, then install hexo-generator-archive, hexo-renderer-jade, hexo-generator-tag, hexo-generator-feed, hexo-generator-sitemap, and hexo-browsersync

  2. 2

    Clone the theme to themes/beautiful-hexo, and set theme to beautiful-hexo in the site _config.yml

  3. 3

    Configure archive_generator in the site _config.yml, setting per_page to 0 and yearly, monthly, and daily to false

  4. 4

    If NetEase Gentie comments are needed, set comment.netease.productKey in the theme _config.yml, and ensure the test domain matches the settings in the NetEase Gentie backend

  5. 5

    Create source/tags/index.md with title and layout: tags, then add Tags: /tags to navbar-links in the theme _config.yml

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Using the NetEase Gentie comment feature requires configuring comment.netease.productKey in the theme _config.yml, meaning it depends on the external NetEase Gentie service and requires applying for the corresponding productKey.
  • When testing NetEase Gentie comments, the website domain must match the domain set in the NetEase Gentie backend; otherwise, comments cannot load properly.
  • Local testing of NetEase Gentie requires modifying /etc/hosts to point the test domain to 127.0.0.1 and running Hexo on port 80, which is a limitation of integrating with an external service.
  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Setup `comment.netease.productKey` in theme's `_config.yml`.

Original README

you have to ensure your website hostname match settings of netease-gentie

Original README

add flollowing lines in /etc/hosts:

Original README
https://github.com/breght-van-baelen/hexo-blog-theme/blob/main/LICENSEhttps://github.com/breght-van-baelen/hexo-blog-theme/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 60 / 100
Technologies
Hexo
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2025-11-11
Screenshot last checked
2026-10-02

No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.

The catalog identifies Hexo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 4303762aa1b14862b8580075fbd5b5d88e82c9ea87846b5290343335e7fa377d

2026-10-02T19:11:17.780Z

Source file / repository
# Beautiful-hexo

Beautiful-hexo is a simple elegant hexo theme ported from [Beautiful-jekyll](http://deanattali.com/beautiful-jekyll) which written by [Dean Attali](http://deanattali.com/aboutme). Nice work!

![hexo-preview](images/hexo-preview.png)

### Install

```
hexo init site 
cd site
npm install --save hexo-generator-archive hexo-renderer-jade hexo-generator-tag hexo-generator-feed hexo-generator-sitemap hexo-browsersync 
git clone --depth 1 https://github.com/twoyao/beautiful-hexo.git themes/beautiful-hexo
```


Modify `_config.yml` change `theme` to `beautiful-hexo` and configure hexo-generator-archive :

```
theme: beautiful-hexo

archive_generator:
    per_page: 0
    yearly: false
    monthly: false
    daily: false
```

### Comment

#### netease-gentie

Setup `comment.netease.productKey` in theme's `_config.yml`. For test, you have to ensure your website hostname match settings of netease-gentie. 
To do so, add flollowing lines in /etc/hosts:

```
127.0.0.1 notes.example.com
```

And run hexo at 80 port: `sudo hexo s --debug -p 80`. After test, you may revert hosts file.

### Tags page

For displaying a page with all blog tags, create a folder named `tags` at `source` folder with the following `index.md` inside:


```
---
title: "Tags"
layout: "tags"
---
```

Don't forget to update your `navbar-links` at `beautiful-hexo` `_config.yml` file:

```
navbar-links:
    ...
    Tags: /tags
```

Theme config file is brief and clear. 
If you have any question, check [hexo online document](https://hexo.io/).
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hexo-theme-matery

hexo-theme-matery

hexo-theme-matery is a Material Design, responsive Hexo blog theme with homepage carousel, waterfall post list, timeline archive, word cloud tags, radar chart categories, and an about page.

Hexo · Blog

hexo-theme-cactus

hexo-theme-cactus

Cactus is a responsive Hexo theme for personal websites and blogs, maintained by probberechts. It offers four color schemes (dark, light, white, classic), configurable navigation, homepage post lists, project lists, social links, and copyright year ranges.

Hexo · Blog

hexo-theme-volantis

hexo-theme-volantis

Volantis is a blog theme for Hexo, distributed as the npm package hexo-theme-volantis and enabled by setting theme to volantis in the Hexo site's _config.yml. It requires Hexo 7.3+, hexo-cli 4.3+, Node.js 22.x LTS+, and npm 10.x LTS+.

Hexo · Blog

hexo-theme-aurora

hexo-theme-aurora

Hexo Theme Aurora is a futuristic Hexo blog theme built around aurora gradients and a magazine-style grid layout.

Hexo · Blog

hexo-theme-Claudia

hexo-theme-Claudia

Claudia is a Hexo blog theme focused on a clean look and easy configuration. It automatically follows the device's dark mode and claims a 90+ Lighthouse score.

Hexo · Blog

hexo-theme-A4

hexo-theme-A4

hexo-theme-A4 is a minimalist Hexo blog theme that mimics the texture of A4 paper, emphasizing simplicity, small size, and minimal configuration.

Hexo · Blog