警告：目前该项目年久失修，请尽量不要使用，建议使用一直处于维护状态的 NexT 主题，祝好

语言: English | 中文简体

:sparkles: 演示

• Liuyib's Blog
• Cheeks's Blog
• lingan1996's Blog
• MikyMing's Blog
• Gemini's Blog
• TimeMachine's Blog

如果你准备长期使用 «Stun» 主题，并希望展示在这里，你只需在 README 中填入你的网站，然后提交 PR 即可。

:crystal_ball: 特性

• 简洁 & 快速 & 易用 & 可定制性高
• 响应式设计
• 二级导航菜单
• 支持图片懒加载
• 支持 Pjax
• 支持 PWA
• 支持 Fancybox
• 支持 Quicklink
• 支持 MathJax、KaTex
• 支持 Gitalk、Valine、Livere、Disqus、Utterances 评论
• 瀑布流式的相册页面
• 内置谷歌广告，一键开启
• 代码高亮，多种配色可选
• 好看的背景特效
• 超详细配置文档

:package: 安装

• 安装 «Stun»

  进入 Hexo 根目录，执行指令：

  $ git clone https://github.com/liuyib/hexo-theme-stun.git themes/stun

  该指令会将本仓库中的所有文件克隆下来，其中有很多文件仅用于项目开发，对于普通用户来说完全用不到。因此，如果你想仅克隆主题运行所必需的文件，请用下面的指令代替上面的指令：

  $ git clone -b dist https://github.com/liuyib/hexo-theme-stun.git themes/stun

  注意：这样做不方便以后更新，请谨慎使用。

• 安装依赖 hexo-renderer-pug

  进入 Hexo 根目录，执行指令：

  $ npm install --save hexo-renderer-pug

:hammer: 使用

修改 Hexo 根目录下的 _config.yml 文件：

theme: stun

然后，启动 Hexo 服务器：

$ hexo clean && hexo s

:art: 更新

$ cd themes/stun

$ git pull

:page_facing_up: 文档

下面是多个文档镜像（它们是全量同步的），任选其一访问即可。

• Github Pages: https://theme-stun.github.io/docs/
• Gitee Pages: https://theme-stun.gitee.io/docs/

:question: 问题

如果遇到问题，首先请仔细阅读文档，或者查看常见问题。当以上的方法都无法帮助你时，再去提出 issue:hugs:。

:handshake: 贡献

在提出 Pull request 之前，请务必先阅读贡献指南。

感谢所有为 «Stun» 做出贡献的人！

:computer: 浏览器支持

| IE | Edge | Firefox | Chrome | Safari | Opera | | :---: | :---: | :---: |:---: | :---: | :---: | | Not Supported | 12+ | 41+ | 45+ | 10+ | 32+ |

:star: Star 历史趋势

:page_with_curl: 开源协议

MIT Copyright (c) 2019-present liuyib