Hexo-based anime-style blog theme, released under the MIT license
hexo-theme-shana — Hexo Blog Template
By ShanaMaid
hexo-theme-shana is a Hexo-based blog theme oriented toward anime style and PC experience, released under the MIT license, featuring a GalMenu right-click menu, background animation, and customizable code highlighting.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Built-in GalMenu: right-click on PC, long press on mobile, can be toggled with optional sound effects
Provides standard blog pages such as home, archive, tags, and categories, plus sidebar widget configuration
Supports custom replacement of code highlighting styles and background images
Enables math formulas by replacing the renderer and adding math: true
Template Details
hexo-theme-shana is a Hexo blog theme created by the author to celebrate Shana's 2016 victory as moe champion, and the repository is released under the MIT license. The theme is positioned as anime style, explicitly prioritizing PC experience over mobile, and does not consider compatibility with older browsers; because it includes many animations, low-end phones may experience lag when accessing on mobile.
In terms of features and configuration, the theme provides standard blog pages such as home, archive, tags, and categories, and supports configuration items including sidebar (can be set to left), widgets such as navigation and about, post excerpt links, fancybox, RSS, social links and friend links, avatar, Google Analytics, CNZZ analytics, and leancloud visit count statistics. The theme includes GalMenu: on PC it is brought up by right-click, on mobile by long press, and can be controlled via galmenu and mp3play switches to enable/disable and sound effects. Code highlighting styles and background images can be replaced in highlight.styl and bganimation/bg.css respectively.
Regarding usage limitations, the third-party comment system was replaced from NetEase Cloud Comments to Youyan, and Youyan does not support HTTPS, so blogs with HTTPS enabled will not have it take effect even if the uyan configuration is filled in; the author also did not adopt Sohu Changyan because it requires a filing number, and GitHub Pages has no filing number. If another comment system is needed, the comment section in article.ejs must be modified manually. Enabling math formulas requires uninstalling hexo-renderer-marked and switching to hexo-renderer-markdown-it-plus, and adding math: true to the post head. Installation is done by cloning the repository into themes/shana, setting language: zh-CN and theme: shana in the Hexo root _config.yml, and copying the tags and categories folders under the theme's _source into the site's source directory.
Is it right for your project?
Use Cases
- Building a personal anime-style blog primarily for PC reading
- Hexo sites that want to use a right-click menu (GalMenu) as an in-site navigation entry
- Technical blogs that need to display math formulas in posts and customize code highlighting styles
- Personal sites hosted on GitHub Pages that need to configure avatar, social links, and friend links
Suitable For
- Users who build blogs with Hexo and prefer anime visual style
- Bloggers who mainly access from PC and can accept mobile animation overhead
- Developers willing to manually modify theme files (such as comments, background, highlighting)
- Users deploying blogs in environments without a filing number, such as GitHub Pages
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Clone the repository into the Hexo site's themes/shana directory, and set language: zh-CN and theme: shana in the root _config.yml
- 2
Copy the tags and categories folders under themes/shana/_source/ into the Hexo root source folder
- 3
To enable math formulas, uninstall hexo-renderer-marked, install hexo-renderer-markdown-it-plus, and add math: true to the post head
- 4
Youyan comments do not support HTTPS; blogs with HTTPS enabled will not have it take effect even if the uyan configuration is filled in; to use another comment system, modify article.ejs manually
- 5
To update the theme, run git pull origin master in the themes/shana directory
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis 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 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
- The Youyan comment system does not support HTTPS, so blogs with HTTPS enabled cannot use this comment feature even if the uyan configuration is filled in, and must switch to another comment solution.
- The author did not integrate Sohu Changyan comments because it requires a filing number, which environments without a filing number such as GitHub Pages cannot satisfy.
- To use another third-party comment system, the theme's article.ejs file must be modified manually; the theme itself does not provide an out-of-the-box alternative comment integration.
- Enabling math formulas requires uninstalling hexo-renderer-marked and installing hexo-renderer-markdown-it-plus, which changes the site's Markdown renderer dependency.
- The theme includes many animation effects, and low-end phones may experience lag when accessing on mobile, limiting the mobile experience.
- The theme is not compatible with older browsers, and visitors using old browsers may not be able to display or use it properly.
- 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
友言评论不支持https协议,所以挂了小绿锁的博客即使填写了配置中的`uyan`也无效。
Original README
不考虑搜狐畅言的原因是因为使用需要填写备案号,github pages是没有备案号的。
Original README
如果需要自定义的三方评论的请自行修改`hexo-theme-shana\layout\_partial\article.ejs`中的最后一部分
Original README
卸载`hexo-renderer-marked`,替换为`hexo-renderer-markdown-it-plus`
Original README
由于比较多的`animation`,低配手机在移动端访问的时候可能会出现卡顿。
Original README
https://github.com/ShanaMaid/hexo-theme-shana/blob/master/LICENSEhttps://github.com/ShanaMaid/hexo-theme-shana/blob/master/README.mdshana主题不考虑兼容低版本浏览器
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-01. 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 · 68 / 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
- 2021-05-17
- Screenshot last checked
- 2026-10-01
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
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: 97c303bf9a5ff640cc3253d8323893865ff8498072b54704e5c6b32b4c39028e
2026-10-01T03:24:14.679Z
Source file / repository# 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或者提出改进建议以及你的疑问
Explore similar templates
Compare previews and descriptions within the same stack and category.

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
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
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 is a futuristic Hexo blog theme built around aurora gradients and a magazine-style grid layout.
Hexo · Blog

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 is a minimalist Hexo blog theme that mimics the texture of A4 paper, emphasizing simplicity, small size, and minimal configuration.
Hexo · Blog
