Hexo博客

hexo-theme-amazing — Hexo 博客模板

作者 removeif

hexo-theme-amazing 是一个基于 Hexo 的博客主题，在 icarus 主题基础上修改并增加了评论、影音、友链、加密文章等功能。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图

桌面端首页1 / 3

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-01查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

基于 icarus 主题修改，新增热门推荐、最新评论、影音、友链等模块

支持 gitalk 和 valine 评论，热门推荐仅支持 gitalk

提供置顶文章、加密文章、相关文章推荐、深色主题切换等功能

可配置看板娘、侧边栏网易云歌单、pjax 局部刷新

包含碎碎念、相册、留言板等页面模板，可选择性使用

采用 MIT 许可，允许免费使用、修改、商用和分发

模板详细介绍

hexo-theme-amazing 是 removeif 开发的 Hexo 博客主题，源码在 icarus 主题基础上修改，并参照其他博客增加了若干新元素。主题仓库为纯主题仓库，完整博客源码已不再维护，但提供 site 分支的 demo 源码。

主题在 icarus 基础上新增了 gitalk 最新评论 widget、首页热门推荐、影音模块、友链模块、关于页面时间轴、看板娘、归档页文章贡献概览、置顶文章、文章列表评论数、相关文章推荐、深色主题切换、加密文章、碎碎念、透明无界样式、pjax、侧边栏网易云歌单、banner 等。评论支持 gitalk 和 valine，热门推荐仅支持 gitalk。

使用前需要详细阅读主题配置文件 _config.yml，并按照文档配置全局和主题参数。主题提供 ex_pages 文件夹中的页面模板，可选择性复制到博客目录。部分功能如置顶需要修改 hexo-generator-index 依赖文件，加密文章不会出现在最新文章列表和推荐列表中。主题采用 MIT 许可，允许免费使用、修改、商用和分发，但第三方素材需自行核对许可。

Hexo博客

适合你的项目吗？

适用场景

搭建个人技术博客，需要评论、推荐、影音等扩展功能
希望基于 icarus 主题进行定制，增加置顶、加密、深色模式等特性
需要快速生成关于、友链、相册、碎碎念等独立页面
想要集成 gitalk 或 valine 评论系统并展示最新评论和热门文章

适合人群

熟悉 Hexo 静态博客生成器的用户
需要中文博客主题并愿意阅读配置文档的开发者
希望使用 MIT 许可主题进行二次修改或商用的个人或团队
对评论、影音、友链等模块有定制需求的内容创作者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
通过 git clone 或 npm 安装主题，并配置博客 _config.yml 和主题 _config.amazing.yml
2
将主题 ex_pages 文件夹中的页面模板复制到博客 source 目录，并按需调整菜单配置
3
使用 gitalk 评论需配置 owner、repo、client_id、client_secret 等参数，并手动初始化 issue
4
置顶功能需要修改 node_modules/hexo-generator-index/lib/generator.js 文件
5
加密文章需在文章头部添加 encrypt、password 等字段，且不会出现在最新文章和推荐列表中

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

热门推荐功能仅支持 gitalk 评论系统，最新评论功能支持 gitalk 和 valine；若使用其他评论系统则无法使用这些功能。
使用 gitalk 评论需在部署后手动到每篇文章评论处点击初始化 issue，否则评论无法正常显示。
置顶文章功能需要手动修改 node_modules 中 hexo-generator-index 的 generator.js 文件，升级依赖后修改可能丢失。
加密文章不会出现在最新文章列表和文章推荐列表中，需设置 top: -1 使其排在首页最后。
侧边栏背景音乐依赖网易云歌单，需配置网易云歌单 id，属于外部服务依赖。
gitalk 评论需要配置 GitHub OAuth 应用的 client_id 和 client_secret，需自行申请并承担相应账号配置。
本仓库仅为纯主题仓库，完整博客主题仓库已不再维护，完整博客源码需另寻 site 分支 demo。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

热门推荐仅支持gitalk，最新评论支持gitalk & valine
README 原文

对于gitalk部署博客后需要到相应文章评论处点击初始化issue评论，完成评论的初始化。
README 原文

修改依赖包中文件removeif/node_modules/hexo-generator-index/lib/generator.js如下
README 原文

加密文章不会出现在最新文章列表widget中，也不会出现在文章中推荐列表中
README 原文

side_music_netease_id: 2364053447 #侧边栏网易云歌单id
README 原文

client_id: xxx # (required) OAuth application client id
README 原文

本仓库为纯主题仓库，博客主题完整仓库(已不维护)请移步为[hexo-theme-icarus-removeif]
README 原文

https://github.com/removeif/hexo-theme-amazing/blob/master/LICENSE https://github.com/removeif/hexo-theme-amazing/blob/master/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 85 / 100
技术栈: Hexo
网站类型: 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2025-01-14
截图检查日期: 2026-10-01

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Hexo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: a5f4047fdb02fac91a65469193b89999479f2d3ef965dd3554976030ff9d0a2c

2026-10-01T03:19:59.185Z

来源文件 / 仓库

<p align="center" class="mb-2">
AMAZING
<br> A simple, delicate, and modern theme for the static site generator Hexo.
<br>
<a href="https://removeif.github.io/">Preview</a> |
<a href="https://github.com/removeif/hexo-theme-amazing/discussions">Discuss on GitHub</a>
<br>
</p>

![](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2020/20200923152909.png)

![](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2020/20200923153450.png)

### 写在前面

博客源码在主题[icarus](http://github.com/ppoffice/hexo-theme-icarus)基础之上参照各网友博客，以及自己的一些想法做出的一些修改以及增加部分新元素。除了以下配置，其余配置请到[icarus官网查看](http://github.com/ppoffice/hexo-theme-icarus)。
因为修改了原作者源码，有什么问题请先联系我，不要去麻烦原作者了，能自己解决的问题就不要麻烦别人了，每个人的时间都很宝贵。  
膜拜和感谢所有模块的原作者,orz👻,辛苦了。  
**使用之前请详细阅读此文档，以及主题配置文件_config.yml**  
**使用之前请详细阅读此文档，以及主题配置文件_config.yml**  
**使用之前请详细阅读此文档，以及主题配置文件_config.yml**  
**相关使用问题也在此[issue](https://github.com/removeif/hexo-theme-amazing/issues/16)有说明，请先查看**

**本仓库为纯主题仓库，博客主题完整仓库(已不维护)请移步为[hexo-theme-icarus-removeif](https://github.com/removeif/hexo-theme-icarus-removeif)**  
**master分支已在信息流中加入adsense广告配置**  
**提供site分支博客demo源码**

线上博客：[欢迎围观](https://removeif.github.io/)，[博客源码Live Demo](https://removeif.github.io/removeif-demo/)

### 一、icarus主题之上主要改动
+ 新增gitalk最新评论widget
+ 首页增加热门推荐
+ 增加弹性配置影音（可加音乐、视频）模块
+ 丰富弹性配置about页面
+ 新增弹性配置友链模块
+ 整体布局左右拉伸了一点，紧凑一些
+ 文章页双栏模式、固定导航栏
+ 引入可配置看板娘
+ 归档页加入了一个文章贡献概览
+ 置顶文章的设置
+ 文章列表评论数显示
+ 文章中推荐文章模块配置 
+ 增加深色主题切换
+ 加入加密文章
+ 碎碎念功能
+ 透明无界样式
+ 简化部分widget数据，加入`查看全部`按钮
+ gitalk评论增加评论开关，评论列表中标记博主
+ 加入pjax提升页面访问体验，配置文件中可开启关闭
+ 侧边栏加入可配置网易云歌单音乐插件，配合pjax可以实现页面间切换背景音乐不间断
+ 文章中加入相关文章模块，取分类相同的最新的5条文章
+ 支持valine最新评论以及文章评论数显示
+ utteranc评论随博客主题切换自动切换深色主题
+ 首页增加可配置banner
+ 有问题可以在线询问[gitter.im](https://gitter.im/hexo-theme-amazing/community)
+ `还有什么新的，好的feature欢迎大家随时提出来，有能力有时间就做出来`

### 二、部分配置说明：

#### 安装方法
博客下 直接clone
```jshelllanguage
git clone https://github.com/removeif/hexo-theme-amazing.git themes/amazing
```

或者通过 npm 安装
```jshelllanguage
npm i hexo-theme-amazing  
hexo config theme amazing // 提示缺少依赖就按提示的安装相应依赖即可
// 博客目录下增加 博客配置文件_config.yml，以及主题配置文件_config.amazing.yml进行配置即可 
```
#### 开始部分配置：
**敲黑板！！！！首先全局以及主题中的`_config.yml`配置成自己的对应参数。**  

把主题中ex_pages文件夹中的文件复制到博客主目录相应目录下面。包含了文章模板、关于页、相册页、友链、留言板、音乐、影音、碎碎念页面（各个页面的.md文件可自定义修改内容），可以自己选择性需要哪些页面复制哪些过去，同时对应配置主题中`_config.yml`需要删除以及保留相应的menu，如下配置
```yaml
navbar:
    # Naviagtion menu items
    menu:
        首页: /
        归档: /archives
        分类: /categories
        标签: /tags
        影音: /media
        相册: /album
        友链: /friend
        碎碎念: /self-talking
        留言: /message
        关于: /about
```
#### 1.热门推荐，最新评论：
**热门推荐仅支持gitalk，最新评论支持gitalk & valine**
对应主题中的`_config.yml`要开启如下配置（此为gitalk，valine配置文件中也有示例），xxx换成自己的，否则无效。**对于gitalk部署博客后需要到相应文章评论处点击初始化issue评论，完成评论的初始化。**
```yaml
comment:
    type: gitalk
    owner: xxx         # (required) GitHub user name
    repo: xxx          # (required) GitHub repository name
    client_id: xxx     # (required) OAuth application client id
    client_secret: xxx # (required) OAuth application client secret
    admin: xxx  #此账户一般为用户名 GitHub user name 文章中能创建issue需要此用户登录才可以，点了创建issue后刷新一遍才能看到！！！！
    create_issue_manually: true
    distraction_free_mode: true
    has_hot_recommend: true # 是否有热门推荐
    has_latest_comment: true #是否有最新评论
```
说明：
+ `has_hot_recommend: true` 是否开启首页热评，false-不开启，true-开启
+ `has_latest_comment: true` 是否开启最新评论，false-不开启，true-开启
+ 热门推荐数据为评论数最多的文章，🔥后面的数字：根据文章的评论数*101 。  
+ 最新评论：为该仓库下，所有issue中的最新评论。  
+ 目前的最新评论有1分钟的本地缓存，评论后可能1分钟后才能看见最新评论，出于性能优化，每次请求接口处理还是挺耗时，comment-issue-data.js中可以自己去掉。  

#### 2.友链数据文件：
文件路径：themes/amazing/source/js/friend.js  
相应格式增加自己需要的数据。  
友链数据中，"valid": 0 代表异常网站，"valid": 1或者不填此字段代表正常网站，可以自己配置；"stopTime": "2019.09.09"代表异常时访问的时间
```text
{
"date": "2019.09.09",
"stopTime": "2019.09.09",
"src": "https://cdn.jsdelivr.net/gh/removeif/removeif.github.io/images/tuzi.jpg",
"name": "@辣椒の酱",
"desc": "后端开发，技术分享。",
"url": "https://removeif.github.io/",
"valid": 0
}
```

#### 3.影音数据文件：
文件路径： 
音乐：themes/amazing/source/json_data/music.json  
视频：themes/amazing/source/json_data/video.json    
相应格式增加自己需要的数据。    
        
#### 4.关于页面时间轴记录数据文件：
文件路径：themes/amazing/source/json_data/record.json   
相应格式增加自己需要的数据。

#### 5.看板娘配置
主题中的`_config.yml`配置如下设置
```text
has_live_2D_switch: true #live2D开关 true为打开,false为关闭
```

#### 6.置顶设置：
.md文章头部数据中加入top值，top值越大越靠前，大于0显示置顶图标。
修改依赖包中文件removeif/node_modules/hexo-generator-index/lib/generator.js如下：
```js 
'use strict';
const pagination = require('hexo-pagination');
module.exports = function(locals){
    var config = this.config;
    var posts = locals.posts;
    posts.data = posts.data.sort(function(a, b) {
        if(a.top == undefined){
            a.top = 0;
        }
        if(b.top == undefined){
            b.top = 0;
        }
        if(a.top == b.top){
            return b.date - a.date;
        }else{
           return b.top - a.top;
        }
    });
    var paginationDir = config.pagination_dir || 'page';
    return pagination('', posts, {
        perPage: config.index_generator.per_page,
        layout: ['index', 'archive'],
        format: paginationDir + '/%d/',
        data: {
            __index: true
        }
    });
};
```
#### 7.配置文章中推荐文章模块  
根据配置的recommend值（必须大于0），值越大越靠前，相等取最新的，最多取5条。recommend（6.中top值也在下面示例）配置在.md文章头中，如下  
```yaml
title: 博客源码分享
top: 1
toc: true
recommend: 1 
keywords: categories-github
date: 2019-09-19 22:10:43
thumbnail: https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20190919221611.png
tags: 工具教程
categories: [工具教程,主题工具]
```
#### 8.文章中某个代码块折叠的方法
代码块头部加入标记 `>folded`，如下代码块中使用。
```java main.java >folded
    // 使用示例，.md 文件中头行标记">folded"
    // ```java main.java >folded
    // import main.java
    // private static void main(){
    //     // test
    //     int i = 0;
    //     return i;
    // }
    // \\``` 
```
#### 9.加入加密文章
如下需要加密的文章头部加入以下代码
```text
---
title: 2019成长记01
top: -1
toc: true
keywords: categories-java
encrypt: true
password: 123456 #此处为文章密码
abstract: 咦，这是一篇加密文章，好像需要输入密码才能查看呢！
message: 嗨，请准确无误地输入密码查看哟！
wrong_pass_message: 不好意思，密码没对哦，在检查检查呢！
wrong_hash_message: 不好意思，信息无法验证！
---
```
注：**加密文章不会出现在最新文章列表widget中，也不会出现在文章中推荐列表中，首页列表中需要设置top: -1 让它排在最后比较合理一些。**
#### 10.碎碎念的使用
在github中，创建碎碎念issue，并且打上对应的label（`eg:Gitalk,666666`）如下图，此处666666对应下面配置代码中的id，填写到：博客目录/source/self-talking/index.md文件中如下对应位置，其余配置也要改成自己的，如clientID等。
![](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2020/20200310182707.png)
```js
<script>
    $.getScript("/js/gitalk_self.min.js", function () {
        var gitalk = new Gitalk({
            clientID: '46a9f3481b46ea0129d8',
            clientSecret: '79c7c9cb847e141757d7864453bcbf89f0655b24',
            id: '666666',
            repo: 'issue_database',
            owner: 'removeif',
            admin: "removeif",
            createIssueManually: true,
            distractionFreeMode: false
        });
        gitalk.render('comment-container1');
    });
</script>
```
如下：
![碎碎念](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2020/20200119181607.png)
#### 11.本博客样式（透明无界）
只需要放开themes/amazing/source/css/base.styl文件中以下样式代码注释即可，默认是注释的没启用
```css 
//=================本博客使用样式   start

// 首页去图
.body_hot_comment .comment-content .card-comment-item .ava, .media-left, .is-6-widescreen .card-image {
    display: none;
}

hover-color = #deeafb;
// 去card
.card {
    background-color: unset;
    box-shadow: unset;
}

.navbar, footer.footer {
    background-color: unset;
}

body:not(.night) .navbar:hover,
body:not(.night) .footer:hover,
body:not(.night) .card:hover,
body:not(.night) .pagination:hover,
body:not(.night) .post-navigation:hover{
    background-color: hover-color;
    box-shadow: 0 4px 10px rgba(0,0,0,0.05),0 0 1px rgba(0,0,0,0.1);
}

.pagination, .post-navigation{
    padding: 10px;
}

.pagination .pagination-link:not(.is-current), .pagination .pagination-previous, .pagination .pagination-next {
    background-color:rgba(255,255,255,0);
}

.timeline .media:last-child:after {
    background: unset;
}
.content .gt-container .gt-comment-admin .gt-comment-content {
    border: 2px solid #deeafb;
}

//=================本博客使用样式   end
```
如下：
![无界样式](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2020/20200218084713.png)
#### 精简部分widget数据
widget中的归档和分类和标签精简了，数据多时不太协调，改为了分别展示5条和10条和20条，增加了查看全部。
![查看全部](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2020/20200119181201.png)

#### gitalk评论增加评论开关，评论列表中标记博主
需要关闭评论的在文章头部加入 `comments: false`,原来已经评论的依然会显示，如下
![](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2020/20200211151129.png)

原来已有博客文章的迁移，只需要把原来对应的文章放到source/_posts里即可。然后去对应文章下面创建评论issue。  
#### 其余配置
完整配置，请仔细阅读主题中**_config.yml**
```yaml
has_hitokoto: true #左边一言开关，true-开，false-关 
has_latest_modify_time: true #是否显示最后修改时间 true开启，false-关闭   
busuanzi_only_count: false #当上面plugins中busuanzi: true时，此配置busuanzi_only_count为true时，网站不显示不蒜子统计数据，但是会每次统计。false时显示统计数据。
has_copyright: true # 文中是否显示copyright true开启，false-关闭   
# http://sachinchoolur.github.io/lightGallery/docs/api.html 
lightgallery_is_full: true #图片灯箱是否显示完整的插件(包括放大，分享等)，true-显示，false-显示简洁版
website_start_time: 2018/11/11 00:00:00 #网站运行开始时间,不填不显示
footer_registered_no: 测试-川ICP备20001070号-1 #备案号
footer_copyright_dsec: true #footer 版权说明 true-开 false-关
has_live_2D_switch: true #live2D开关 true-开 false-关
side_music_netease_id: 2364053447 #侧边栏网易云歌单id
use_pjax: false #是否开启pjax，false-不开启，true-开启，开启后局部更新网页信息，切换页面背景音乐不间断等特性
```
#### 以上配置好后
```yaml
$ npm install #安装依赖包（只需要执行一次）可直接把本文最后的json文件内容复制到博客下面的依赖文件package.json后在执行此命令，如果原来已有node_modules文件夹，请先删除在执行此命令
$ hexo clean #清除缓存
$ hexo g #编译 
$ hexo s #启动服务 
$ hexo d #推到远程 
```
安装依赖包（只需要执行一次），以后修改了代码 只需要执行后面几条就好。  

### 写在后面
如果你有问题请反馈: [issues](https://github.com/removeif/hexo-theme-amazing/issues) （请务必先于issues中寻找答案）  
如果你喜欢该主题: [star](https://github.com/removeif/hexo-theme-amazing)  
如果你想定制主题: [fork](https://github.com/removeif/hexo-theme-amazing) 
### License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/removeif/hexo-theme-amazing/blob/master/LICENSE) file for details.

### 其余主题彩蛋
**文章中横竖图demo；对于横竖图推荐分开使用，且长宽一致的，如统一手机拍照、电脑截图**
使用方法：md文章中放入以下代码
```html

+ 横竖图

<div class="justified-gallery">

![张芷溪](http://wx1.sinaimg.cn/large/b5d1b710ly1g6bz7n92s7j212w0nr1kx.jpg) ![李一桐](http://wx2.sinaimg.cn/mw1024/005RAHfgly1fvfc4f19qfj33402c0qv9.jpg) ![gakki](http://wx1.sinaimg.cn/mw1024/70396e5agy1g5qe457i6yj21660ogtap.jpg) ![李一桐](http://wx1.sinaimg.cn/mw1024/005RAHfgly1fuzz17s2q3j32e43cku0x.jpg) ![彭小苒](http://wx1.sinaimg.cn/mw1024/d79c9b94ly1g1pb1uthr5j21f02iox6t.jpg)</div>

+ 横图4

<div class="img-x">

![v4](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191022182226.png) ![v3](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191018114126.png) ![v4](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191022182226.png) ![v3](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191018114126.png)</div>

+ 竖图5

<div class="img-y">

![电池](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191024145940.jpg) ![打王者荣耀](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191024141906.jpg) ![支付宝付款](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191024141926.jpg) ![锤子便签](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191024145956.jpg) ![电池](https://cdn.jsdelivr.net/gh/removeif/blog_image/img/2019/20191024145940.jpg)</div>

```
#### 效果如下（多图左右拉查看）
[查看效果](https://removeif.github.io/theme/%E5%8D%9A%E5%AE%A2%E6%BA%90%E7%A0%81%E5%88%86%E4%BA%AB.html#效果如下（多图左右拉查看）)

反馈内容错误