Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/liuyib/hexo-theme-stun
🦄 An elegant theme for Hexo
https://github.com/liuyib/hexo-theme-stun
comments hexo hexo-theme languages lazy-loading liuyib responsive-design stun-hexo waterfall-flow
Last synced: 23 days ago
JSON representation
🦄 An elegant theme for Hexo
- Host: GitHub
- URL: https://github.com/liuyib/hexo-theme-stun
- Owner: liuyib
- License: mit
- Created: 2019-05-11T15:12:05.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-02-12T10:56:01.000Z (9 months ago)
- Last Synced: 2024-04-14T09:58:52.049Z (7 months ago)
- Topics: comments, hexo, hexo-theme, languages, lazy-loading, liuyib, responsive-design, stun-hexo, waterfall-flow
- Language: Stylus
- Homepage: https://theme-stun.github.io/docs/
- Size: 2.88 MB
- Stars: 618
- Watchers: 6
- Forks: 124
- Open Issues: 66
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-hexo-themes - liuyib/hexo-theme-stun
- awesome-waline - Stun
README
警告：目前该项目年久失修，请尽量不要使用，建议使用一直处于维护状态的 [NexT](https://github.com/next-theme/hexo-theme-next) 主题，祝好
一个漂亮、简洁的 Hexo 主题
语言: [English](https://github.com/liuyib/hexo-theme-stun/blob/master/README_en-US.md) | [中文简体](https://github.com/liuyib/hexo-theme-stun/blob/master/README.md)
## :sparkles: 演示
- [Liuyib's Blog](https://liuyib.github.io/)
- [Cheeks's Blog](https://www.cheeks.top/)
- [lingan1996's Blog](https://www.lingan1996.top)
- [MikyMing's Blog](https://mikyming.online/)
- [Gemini's Blog](https://geminiplanet.cn/)
- [TimeMachine's Blog](https://timemachine.icu/)
- [Jiangyh's Blog](https://bestjarvan.gitee.io/)
- [Frank's Blog](https://shufanhao.top/)
- [Jun's blog](https://www.jun997.xyz/)
如果你准备长期使用 «Stun» 主题，并希望展示在这里，你只需在 [README](https://github.com/liuyib/hexo-theme-stun/edit/master/README.md) 中填入你的网站，然后提交 PR 即可。
## :crystal_ball: 特性
- 简洁 & 快速 & 易用 & **可定制性高**
- 响应式设计
- [二级导航菜单](https://theme-stun.github.io/docs/zh-CN/advanced/advanced.html#二级导航菜单)
- 支持[图片懒加载](https://theme-stun.github.io/docs/zh-CN/advanced/advanced.html#图片懒加载)
- 支持 [Pjax](https://github.com/defunkt/jquery-pjax)
- 支持 [PWA](https://developers.google.com/web/progressive-web-apps)
- 支持 [Fancybox](https://github.com/fancyapps/fancybox)
- 支持 [Quicklink](https://github.com/GoogleChromeLabs/quicklink)
- 支持 [MathJax](https://www.mathjax.org/)、[KaTex](https://katex.org/)
- 支持 [Gitalk](https://github.com/gitalk/gitalk)、[Valine](https://valine.js.org/)、[Livere](https://livere.com/)、[Disqus](https://disqus.com/)、[Utterances](https://github.com/utterance/utterances) 评论
- 瀑布流式的[相册页面](https://liuyib.github.io/gallery/)
- 内置[谷歌广告](https://www.google.cn/adsense/start/)，一键开启
- 代码高亮，[多种配色](https://theme-stun.github.io/docs/zh-CN/advanced/advanced.html#代码高亮)可选
- 好看的[背景特效](https://theme-stun.github.io/docs/zh-CN/advanced/third-part.html#ribbon)
- 超详细[配置文档](https://theme-stun.github.io/docs/zh-CN/)
## :package: 安装
- 安装 «Stun»
进入 Hexo 根目录，执行指令：
```bash
$ git clone https://github.com/liuyib/hexo-theme-stun.git themes/stun
```
> 该指令会将本仓库中的所有文件克隆下来，其中有很多文件仅用于项目开发，对于普通用户来说完全用不到。因此，如果你想仅克隆主题运行所必需的文件，请用下面的指令代替上面的指令：
>
> ```bash
> $ git clone -b dist https://github.com/liuyib/hexo-theme-stun.git themes/stun
> ```
>
> 注意：这样做不方便以后更新，请谨慎使用。
- 安装依赖 `hexo-renderer-pug`
进入 Hexo 根目录，执行指令：
```bash
$ npm install --save hexo-renderer-pug
```
## :hammer: 使用
修改 Hexo 根目录下的 `_config.yml` 文件：
```yml
theme: stun
```
然后，启动 Hexo 服务器：
```bash
$ hexo clean && hexo s
```
## :art: 更新
```bash
$ cd themes/stun
$ git pull
```
## :page_facing_up: 文档
下面是多个文档镜像（它们是全量同步的），任选其一访问即可。
- Github Pages: [https://theme-stun.github.io/docs/](https://theme-stun.github.io/docs/)
- Gitee Pages: [https://theme-stun.gitee.io/docs/](https://theme-stun.gitee.io/docs/)
## :question: 问题
如果遇到问题，首先请仔细阅读[文档](https://theme-stun.github.io/docs/zh-CN/)，或者查看[常见问题](https://github.com/liuyib/hexo-theme-stun/blob/master/FAQ.md)。当以上的方法都无法帮助你时，再去提出 `issue`:hugs:。
## :handshake: 贡献
在提出 Pull request 之前，请务必先阅读[贡献指南](https://theme-stun.github.io/docs/zh-CN/contribute/contribute.html)。
感谢所有为 «Stun» 做出贡献的人！
## :computer: 浏览器支持
| 
IE | 
Edge | 
Firefox | 
Chrome | 
Safari | 
Opera |
| :---: | :---: | :---: |:---: | :---: | :---: |
| Not Supported | 12+ | 41+ | 45+ | 10+ | 32+ |
## :star: Star 历史趋势
[](https://starchart.cc/liuyib/hexo-theme-stun.svg)
## :page_with_curl: 开源协议
[MIT](https://github.com/liuyib/hexo-theme-stun/blob/master/LICENSE) Copyright (c) 2019-present liuyib
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fliuyib%2Fhexo-theme-stun?ref=badge_large)