Hexo博客

hexo-theme-shana — Hexo 博客模板

作者 ShanaMaid

hexo-theme-shana 是一个以 Hexo 为基础、面向二次元风格与 PC 端体验的博客主题,采用 MIT 许可,包含 GalMenu 右键菜单、背景动画与代码高亮自定义等特性。

看看你的网站会是什么样

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

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

01

以 Hexo 为基础的二次元风格博客主题,采用 MIT 许可发布

02

内置 GalMenu:PC 端右键调出、移动端长按触发,可开关并可选音效

03

提供首页、归档、标签、分类等常规博客页面与侧边栏 widget 配置

04

支持代码高亮样式与背景图片的自定义替换

05

可通过替换渲染器并添加 math: true 启用数学公式

模板详细介绍

hexo-theme-shana 是作者为庆贺「夏娜酱」2016 年加冕萌王而制作的 Hexo 博客主题,仓库以 MIT 许可发布。主题定位为二次元风格,明确以 PC 端体验为主、移动端次之,并且不考虑兼容低版本浏览器;由于包含较多 animation,低配手机在移动端访问时可能出现卡顿。

功能与配置方面,主题提供首页、归档、标签、分类等常规博客页面,支持侧边栏(可设为 left)、导航与 about 等 widget、文章摘要链接、fancybox、RSS、社交链接与友情链接、头像、Google Analytics、CNZZ 站长统计、leancloud 访问次数统计等配置项。主题内置 GalMenu:PC 端通过右键调出,移动端长按触发,并可通过 galmenu 与 mp3play 开关控制是否启用及音效。代码高亮样式与背景图片分别可在 highlight.styl 与 bganimation/bg.css 中自行替换。

使用限制方面,三方评论由网易云替换为友言,而友言不支持 https,因此启用 HTTPS 的博客即使填写 uyan 配置也不会生效;作者也未采用搜狐畅言,因为其需要备案号,而 GitHub Pages 没有备案号。若需其他评论系统,需要自行修改 article.ejs 中的评论部分。启用数学公式需要卸载 hexo-renderer-marked 并改用 hexo-renderer-markdown-it-plus,并在文章 head 添加 math: true。安装方式为将仓库克隆到 themes/shana,并在 Hexo 根目录 _config.yml 中设置 language: zh-CN 与 theme: shana,同时把主题 _source 下的 tags 与 categories 文件夹拷贝到站点 source 目录。

Hexo博客

适合你的项目吗?

适用场景

  • 搭建以 PC 端阅读为主的个人二次元风格博客
  • 希望用右键菜单(GalMenu)作为站内导航入口的 Hexo 站点
  • 需要在文章中展示数学公式并自定义代码高亮样式的技术博客
  • 使用 GitHub Pages 托管、需要配置头像、社交链接与友情链接的个人站点

适合人群

  • 使用 Hexo 搭建博客并偏好二次元视觉风格的用户
  • 以 PC 端访问为主、能接受移动端动画开销的博主
  • 愿意手动修改主题文件(如评论、背景、高亮)的开发者
  • 使用 GitHub Pages 等无备案号环境部署博客的用户

上手与定制指南

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

  1. 1

    将仓库克隆到 Hexo 站点的 themes/shana 目录,并在根目录 _config.yml 中设置 language: zh-CN 与 theme: shana

  2. 2

    把 themes/shana/_source/ 下的 tags 和 categories 文件夹拷贝到 Hexo 根目录的 source 文件夹

  3. 3

    启用数学公式需卸载 hexo-renderer-marked、安装 hexo-renderer-markdown-it-plus,并在文章 head 添加 math: true

  4. 4

    友言评论不支持 https,启用 HTTPS 的博客即使填写 uyan 配置也不会生效;如需其他评论系统需自行修改 article.ejs

  5. 5

    更新主题可在 themes/shana 目录执行 git pull origin master

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

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

使用时需要遵守

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

额外费用与待核对事项

  • 友言评论系统不支持 HTTPS,因此启用 HTTPS 的博客即使填写 uyan 配置也无法使用该评论功能,需自行改用其他评论方案。
  • 作者未集成搜狐畅言评论,因为其要求填写备案号,而 GitHub Pages 等无备案号环境无法满足该要求。
  • 若需使用其他第三方评论系统,必须自行修改主题的 article.ejs 文件,主题本身不提供开箱即用的替代评论集成。
  • 启用数学公式需卸载 hexo-renderer-marked 并安装 hexo-renderer-markdown-it-plus,会改变站点的 Markdown 渲染器依赖。
  • 主题包含较多动画效果,低配置手机在移动端访问时可能出现卡顿,移动端体验受限。
  • 主题不兼容低版本浏览器,使用旧版浏览器的访问者可能无法正常显示或使用。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

友言评论不支持https协议,所以挂了小绿锁的博客即使填写了配置中的`uyan`也无效。

README 原文

不考虑搜狐畅言的原因是因为使用需要填写备案号,github pages是没有备案号的。

README 原文

如果需要自定义的三方评论的请自行修改`hexo-theme-shana\layout\_partial\article.ejs`中的最后一部分

README 原文

卸载`hexo-renderer-marked`,替换为`hexo-renderer-markdown-it-plus`

README 原文

由于比较多的`animation`,低配手机在移动端访问的时候可能会出现卡顿。

README 原文

shana主题不考虑兼容低版本浏览器

README 原文
https://github.com/ShanaMaid/hexo-theme-shana/blob/master/LICENSEhttps://github.com/ShanaMaid/hexo-theme-shana/blob/master/README.md

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

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料一般 · 68 / 100
技术栈
Hexo
网站类型
博客
这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间
2021-05-17
截图检查日期
2026-10-01

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

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

查看当时使用的来源资料

SHA-256: 97c303bf9a5ff640cc3253d8323893865ff8498072b54704e5c6b32b4c39028e

2026-10-01T03:24:14.679Z

来源文件 / 仓库
# hexo-theme-shana
`shana`是以`hexo 3.2`为基础制作的主题,为庆贺`夏娜酱`2016年加冕萌王而诞生的,由于比较多的`animation`,低配手机在移动端访问的时候可能会出现卡顿。你可以访问[我的博客](http://blog.shanamaid.top/)观看效果
![夏娜酱2016年加冕萌王](http://wx1.sinaimg.cn/mw690/dc58f491ly1fepnf3l0thj20dc0i0jsr.jpg)
——————————————————————————————————

## 关于主题
- shana主题不考虑兼容低版本浏览器
- 追求PC端体验,移动端次之
- 打造二次元主题


## 效果图
![首页](http://wx3.sinaimg.cn/mw690/dc58f491ly1fepnf7f6crj20xf0hmh6y.jpg)
![归档页](http://wx2.sinaimg.cn/mw690/dc58f491ly1fepnf4xyptj20xj0hjtrb.jpg)
![标签页](http://wx1.sinaimg.cn/mw690/dc58f491ly1fepnf6fmrxj20si0dmn9s.jpg)
![代码高亮](http://wx1.sinaimg.cn/mw690/dc58f491ly1fepnf5te0hj20x90hiwu4.jpg)
![GalMenu菜单](http://wx3.sinaimg.cn/mw690/dc58f491ly1fepnf3082qj20x40h87od.jpg)


动态特效请访问[我的博客](https://shanamaid.github.io/)观看效果,右键调出`GalMenu`


## 使用
### 安装
```
 git clone https://github.com/ShanaMaid/hexo-theme-shana themes/shana
```

### 配置
修改hexo根目录下的 `_config.yml`
```  
`language: zh-CN`

`theme: shana`
```
同时将`themes/shana/_source/`的`tags`和`categories`文件夹拷贝到hexo根目录下的`source`文件夹下

### 更新
```
cd themes/shana

git pull origin master
```

## 配置文件
```
# Header
menu:
  Home: /
  Archives: /archives
  Categories: /categories
  Tags: /tags
rss: /atom.xml

# Content
excerpt_link: Read More
fancybox: true

# Sidebar
sidebar: left
widgets:
- nav
- about

# display widgets at the bottom of index pages (pagination == 2)
index_widgets:
# - category
# - tagcloud
# - archive

# widget behavior
archive_type: 'monthly'
show_count: false

# Miscellaneous
google_analytics:
favicon: /favicon.png
twitter:
google_plus:
fb_admins:
fb_app_id:


# GalMenu - PC端右键调出,移动端长按
# galmenu决定是否开启
# mp3play决定是否开启音效
galmenu: true
mp3play: false
gaymenu_item:
- name: 首页
  url : /
- name: 标签
  url : /tags
- name: 分类
  url : /categories
- name: 归档
  url : /archives
- name: xxx
  url : xxxxxxxxx
- name: xxxx
  url : xxxxxxx

# 社交链接
social:
- url: http://github.com/ShanaMaid
  name: Github

# 友情链接
# name : url
link_title: 友情链接
links:
  ShanaMaid: http://blog.shanamaid.top/


# Sidebar Avatar
# in theme directory(source/images): /images/avatar.jpg
# in site  directory(source/uploads): /uploads/avatar.jpg
# 头像
avatar: https://avatars0.githubusercontent.com/u/20333903?v=3&s=460


# 网站统计
# 站长统计 填写id
# eg: 
# CNZZ: 123456789
CNZZ: 

# 评论
# 评论
# 友言uid
uyan: 

# leadcloud访问次数统计
# 
leancloud_visitors:
  enable: false
  app_id: 
  app_key: 
```
## 启用数学公式

卸载`hexo-renderer-marked`,替换为`hexo-renderer-markdown-it-plus`

``` bash
npm un hexo-renderer-marked --save
npm i hexo-renderer-markdown-it-plus --save
```

在需要启用数学公式的博客的head添加math: true

编辑站点的配置文件

``` yaml
# hexo/_config.yml
markdown_it_plus:
  highlight: true
  html: true
  xhtmlOut: true
  breaks: true
  langPrefix:
  linkify: true
  typographer:
  quotes: “”‘’
  pre_class: highlight
```



## 自定义代码高亮

`hexo-theme-shana\source\css_partial\highlight.styl`

![](https://user-images.githubusercontent.com/20333903/28317264-c8a80a28-6bf8-11e7-88f9-f1ef542f5118.png)

## 自定义背景图片
`hexo-theme-shana\source\plugin\bganimation\bg.css`

替换里面的图片url就可以了


## 关于三方评论
由于网易云倒闭,三方评论替换为友言。


友言评论不支持https协议,所以挂了小绿锁的博客即使填写了配置中的`uyan`也无效。

不考虑搜狐畅言的原因是因为使用需要填写备案号,github pages是没有备案号的。

如果需要自定义的三方评论的请自行修改`hexo-theme-shana\layout\_partial\article.ejs`中的最后一部分

```
<% if (!index && post.comments && theme.uyan){ %>
  <div id="comments" class="comments">
    <div id="uyan_frame"></div>
  </div>
<script type="text/javascript" src="http://v2.uyan.cc/code/uyan.js?uid=<%- theme.uyan %>"></script>
<% } %>
```

博主博客挂了小绿锁因此很长一段时间不会支持评论了,任何有关主题的问题直接在该项目下发issue吧!


## 支持与改进
你可以通过发起`issue`来反映主题的BUG或者提出改进建议以及你的疑问
反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。