记录你心中的奇迹，书写你自己的篇章
---
> **使用主题时，如果需要任何基础功能上的帮助，请先查看[说明文档](https://www.notion.so/eltrac/c7c631e21b3345caa2a09bd2fb5dd4b2)！**
> 我用 Notion 给 Miracles 做了一个主页，欢迎访问：[Miracles 主题](https://www.notion.so/eltrac/Miracles-11ff2db10acc43bba64ba422b309138d)
> 同时，欢迎加入 QQ 交流群：924171480，或者 [Telegram](https://dev.guhub.cn/tg)
## 特色
- 响应式 / 自适应设计
- Pjax 全站无刷新
- Ajax 评论无刷新
- 支持系统切换夜间模式
- 调用 bilibili API 显示追番页面
- 前台登录
- 图片懒加载
- 代码高亮 / 行号
- 不错的兼容性
- 夜间模式下的 Pio 插件按钮样式
- 夜间模式下的 Aplayer 播放器
- Bilibili 外链长宽比例
- 良好的阅读体验
- 阅读时长估计
- 字数统计
- 两种可供选择的字体（思源宋体/黑体）
- 不错的自定义性能
- 两种可供选择的导航栏
- 多种图片懒加载动画供选择
- 黑白滤镜（哀悼模式）
- 灵活的友情链接功能
- 方便排版的短代码
- 后台设置备份
## 使用
1. Star 本项目（遵循 SATA 开源协议）
2. 下载**最新的 [Release](https://github.com/BigCoke233/miracles/releases)**
3. 解压后，**确认目录名为`Miracles`（M 大写）**
4. 将文件夹放入 Typecho 根目录下的`usr/themes/`
5. 到后台-外观-可用的主题中，启用主题
6. **根据 [wiki](https://www.notion.so/eltrac/c7c631e21b3345caa2a09bd2fb5dd4b2)** 配置主题
使用开发版
直接下载仓库，或者使用 git 命令行进行克隆。
```git
$ git clone https://github.com/BigCoke233/miracles.git
```
> 不推荐使用开发版，因为可能有不确定的不稳定因素，并且不一定有有利改动
如果你使用开发版出现任何问题，欢迎通过 issue 反馈，在等待回复期间请使用发行版
遇到问题
如果在使用过程中遇到了任何问题，可以先阅读本主题的 [Wiki](https://www.notion.so/eltrac/c7c631e21b3345caa2a09bd2fb5dd4b2)，并进行一些简单的确认：清理浏览器缓存，更换网络环境，确保 Console 内没有提示访问不到文件等自身原因。如果你无法靠自己解决问题，可以尝试联系作者，但记住**开发者没有为你解决问题的义务，只是出于好心的帮助。**
在确认你遇到的现象确实是一个 Bug 后，请在 [Issues](https://github.com/BigCoke233/miracles/issues) 提交问题，并为该问题尽可能的描述清楚，按照提供的 issue 模板进行填写，谢谢配合。
关于版权
主题基于 SATA 协议开源，使用前你需要给这个项目点一个 Star，使用或转发时**请保留版权信息**，禁止倒卖。若需二次开发后发布，请邮件通知我`hi#guhub.cn`，并保留原作者版权信息及仓库链接。同时，如果发现有侵权行为，请告知我，屡教不改者将被列入[黑名单](docs/black-list.md)，删除版权的用户不会在遇到问题时受到来自作者的帮助，在后期可能会加入删除版权网站设置项失效的惩罚。