HexoBlog

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.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-01View source

What stands out

A quick read of the recorded project description.

01

Hexo-based anime-style blog theme, released under the MIT license

02

Built-in GalMenu: right-click on PC, long press on mobile, can be toggled with optional sound effects

03

Provides standard blog pages such as home, archive, tags, and categories, plus sidebar widget configuration

04

Supports custom replacement of code highlighting styles and background images

05

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.

HexoBlog

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. 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. 2

    Copy the tags and categories folders under themes/shana/_source/ into the Hexo root source folder

  3. 3

    To enable math formulas, uninstall hexo-renderer-marked, install hexo-renderer-markdown-it-plus, and add math: true to the post head

  4. 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. 5

    To update the theme, run git pull origin master in the themes/shana directory

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 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

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

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

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/)观看效果
![夏娜酱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或者提出改进建议以及你的疑问
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.