以 Hexo 为基础的二次元风格博客主题,采用 MIT 许可发布
hexo-theme-shana — Hexo 博客模板
作者 ShanaMaid
hexo-theme-shana 是一个以 Hexo 为基础、面向二次元风格与 PC 端体验的博客主题,采用 MIT 许可,包含 GalMenu 右键菜单、背景动画与代码高亮自定义等特性。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
内置 GalMenu:PC 端右键调出、移动端长按触发,可开关并可选音效
提供首页、归档、标签、分类等常规博客页面与侧边栏 widget 配置
支持代码高亮样式与背景图片的自定义替换
可通过替换渲染器并添加 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 目录。
适合你的项目吗?
适用场景
- 搭建以 PC 端阅读为主的个人二次元风格博客
- 希望用右键菜单(GalMenu)作为站内导航入口的 Hexo 站点
- 需要在文章中展示数学公式并自定义代码高亮样式的技术博客
- 使用 GitHub Pages 托管、需要配置头像、社交链接与友情链接的个人站点
适合人群
- 使用 Hexo 搭建博客并偏好二次元视觉风格的用户
- 以 PC 端访问为主、能接受移动端动画开销的博主
- 愿意手动修改主题文件(如评论、背景、高亮)的开发者
- 使用 GitHub Pages 等无备案号环境部署博客的用户
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
将仓库克隆到 Hexo 站点的 themes/shana 目录,并在根目录 _config.yml 中设置 language: zh-CN 与 theme: shana
- 2
把 themes/shana/_source/ 下的 tags 和 categories 文件夹拷贝到 Hexo 根目录的 source 文件夹
- 3
启用数学公式需卸载 hexo-renderer-marked、安装 hexo-renderer-markdown-it-plus,并在文章 head 添加 math: true
- 4
友言评论不支持 https,启用 HTTPS 的博客即使填写 uyan 配置也不会生效;如需其他评论系统需自行修改 article.ejs
- 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 原文
https://github.com/ShanaMaid/hexo-theme-shana/blob/master/LICENSEhttps://github.com/ShanaMaid/hexo-theme-shana/blob/master/README.mdshana主题不考虑兼容低版本浏览器
README 原文
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/)观看效果

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





动态特效请访问[我的博客](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`

## 自定义背景图片
`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或者提出改进建议以及你的疑问
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

hexo-theme-matery
A beautiful hexo blog theme with material design and responsive design.一个基于材料设计和响应式设计而成的全面、美观的Hexo主题。
Hexo · 博客

hexo-theme-cactus
:cactus: A responsive, clean and simple theme for Hexo.
Hexo · 博客

hexo-theme-volantis
A Wonderful Theme for Hexo.
Hexo · 博客

hexo-theme-aurora
Hexo Theme Aurora 是一款以极光色彩和渐变 UI 为核心的 Hexo 博客主题,整体走未来感路线。 它的首页采用杂志式网格布局,文章列表与精选区域层次分明,视觉上更接近个人媒体站点而非传统博客。
Hexo · 博客

hexo-theme-Claudia
Claudia 是一款为 Hexo 设计的博客主题,主打简洁外观与易配置。 它支持自动跟随设备深色模式,并在 README 中宣称拥有 90+ 的 Lighthouse 评分,适合追求轻量与性能的博客作者。
Hexo · 博客

hexo-theme-A4
A hexo theme that looks like an A4 paper.(一个类A4纸张质感的hexo博客主题。 )
Hexo · 博客
