Skip to content
master
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

记录你心中的奇迹,书写你自己的篇章


停更说明

Miracles 目前已经停止更新,正在着手开发新的主题,可以当作 Miracles 的第二代版本 —— Miracle!,除非有严重的 bug,这个版本基本是不会再维护了。

如果你喜欢这个主题,你可以给我点一个 star,或者支持一下新的 Miracle!,不过这是一款付费的主题,继承了 Miracles 的设计风格,标准版价格是 44 元,详细信息可以看:https://blog.guhub.cn/p/miracle-on-sale.html


🎨 特色

  • 响应式 / 自适应设计
  • Pjax 全站无刷新
  • Ajax 评论无刷新
  • 支持系统切换夜间模式
  • 调用 bilibili API 显示追番页面
  • 前台登录
  • 图片懒加载
  • 代码高亮 / 行号
  • 不错的兼容性
    • 夜间模式下的 Pio 插件按钮样式
    • 夜间模式下的 Aplayer 播放器
    • Bilibili 外链长宽比例
  • 良好的阅读体验
    • 阅读时长估计
    • 字数统计
    • 两种可供选择的字体(思源宋体/黑体)
  • 不错的自定义性能
    • 两种可供选择的导航栏
    • 多种图片懒加载动画供选择
    • 黑白滤镜(哀悼模式)
  • 灵活的友情链接功能
  • 方便排版的短代码
  • 后台设置备份

预览

作者博客 | Miracles 常用页面元素示例

🚀 使用

  1. Star 本项目(遵循 SATA-BNP 开源协议)
  2. 下载最新的 Release
  3. 确保自身 PHP 环境在 7.1.0 及以上版本,并装有 CURL 拓展(否则一些功能无法正常使用)
  4. 解压后,确认目录名为Miracles(M 大写)
  5. 将文件夹放入 Typecho 根目录下的usr/themes/
  6. 到后台-外观-可用的主题中,启用主题
  7. 根据 wiki 配置主题
使用开发版

直接下载仓库,或者使用 git 命令行进行克隆。

$ git clone https://github.com/BigCoke233/miracles.git

不推荐使用开发版,因为可能有不确定的不稳定因素,并且不一定有有利改动
如果你使用开发版出现任何问题,欢迎通过 issue 反馈,在等待回复期间请使用发行版

遇到问题

如果在使用过程中遇到了任何问题,可以先阅读本主题的 Wiki,并进行一些简单的确认:清理浏览器缓存,更换网络环境,确保 Console 内没有提示访问不到文件等自身原因。如果你无法靠自己解决问题,可以尝试联系作者,但记住开发者没有为你解决问题的义务,只是出于好心的帮助。
在确认你遇到的现象确实是一个 Bug 后,请在 Issues 提交问题,并为该问题尽可能的描述清楚,按照提供的 issue 模板进行填写,谢谢配合。

关于版权

主题基于 SATA-BNP 协议开源,使用前你需要给这个项目点一个 Star,使用或转发时请保留版权信息,禁止倒卖。若需二次开发后发布,请邮件通知我hi#guhub.cn,并保留原作者版权信息及仓库链接。在最近(2020-5-28),我将 SATA 协议修改为了 SATA-BNP 协议,即不能将软件用作任何政治相关的用途,特别是政治宣传,但是按原文转载相关政治家的书籍、文章,不含有任何倾向的解读也是可以接受的。同时,如果发现有侵权行为,请告知我,屡教不改者将被列入黑名单,删除版权的用户不会在遇到问题时受到来自作者的帮助,在后期可能会加入删除版权网站设置项失效的惩罚。

更新日志

Ver.1.6.0 Your best nightmare

  • 新增:支持自定义「导航栏图标按钮」
  • 新增:文章目录(使用 {:toc:} 在文中插入目录)
  • 新增:归档页面中添加「文章分类」栏目
  • 新增:支持快速写入<details>的短代码,并使用垫片优化兼容性
  • 新增:加入 html 压缩
  • 新增:多语言功能
  • 新增:兼容 typecho 评论反垃圾
  • 新增:高级设置
  • 新增:可选择主题字体 CDN 了
  • 新增:可以使用 TimThumb 裁剪文章缩略图了(需要在高级设置 themeConfig.php 里打开)
  • 优化:夜间模式下,notice 块的背景色
  • 优化:导航栏毛玻璃效果调整
  • 优化:导航栏透明度调整
  • 优化:将 kbd 的短代吗语法修改为 [[kbd]]
  • 优化:用 canvas 替换代码块的 mac 按钮图片
  • 优化:鼠标移动到文章卡片标题上时显示完整标题
  • 优化:将 FancyBox 和 Lazyload 替换为 gazeimg
  • 优化:归档页面,折叠往年的文章列表
  • 优化:用 localStorage 储存 theme,代替 cookie #57
  • 优化:在 php 层检测 faviconDark,避免前台出现 404 报错
  • 优化:模板设置备份中,判断 $_POST['type'] 存在后再进行备份处理,防止不必要的报错和其他风险
  • 优化:归档页面 meta 元信息
  • 优化:改进番剧页面(Done by Kengwang)
  • 优化:将 title 改为 hint.css 提供的 tooltip
  • 优化:将鼠标悬停在文章元信息上时,会显示对应的 tooltip
  • 优化:用 alertify.js 替换自己的提示框
  • 优化:页面/文章评论列表隐藏时,不显示评论数
  • 优化:将设置项「Pjax 完成后执行事件」更改为更准确的「Pjax 回调函数」
  • 修复:一个存在了超久的拼写错误(paresNav=>parseNav)
  • 修复:archive 页面(即分类、标签、搜索等)文章头图问题
  • 修复:暴力解决访问密码文章时被 pjax 强制刷新的问题
  • 修复:评论区 owo 表情换行
  • 修复:标签、分类页面不显示文章缩略图
  • 修复:删除不必要的判断
  • 修复:自定义随机图失效
  • 修复:解决随机颜文字可能报错的问题
  • 修复:评论列表缺失 #comments id

所有历史版本的更新日志请查看这里

📝 计划

  • 优化:用 localStorage 替换储存夜间/日落模式等的 cookie
  • 新增:支持快速写入<details>的短代码,并使用垫片优化兼容性
  • 新增:添加语言包功能,通过 php 数组储存各个语言版本的文字
  • 优化:文章缩略图自动剪裁
  • 优化:页面/文章评论列表隐藏时,不显示评论数
  • 优化:支持用 jsDelivr 加速主题内置图片的速度
  • 增加:内置站点缓存规则
  • 优化:「说说页面」的样式
  • 新增:图片横向排版「相册功能」(参考:https://blog.imalan.cn/archives/282/)
  • 新增:全站加密功能
  • 新增:支持 PWA - 渐进式 Web 应用
  • 新增:嵌入 GitHub 仓库 / 用户(以卡片形式展示)
  • 新增:根据 cid 嵌入本站文章(以卡片形式展示)
  • 新增:文章目录
  • 优化:密码提示(可在加密文章中自定义对密码的提示)
  • 新增:全站公告
  • 优化:对日间模式/日落模式/夜间模式的切换通过下拉面板操作,并支持禁用主题跟随系统设置
  • 新增:导航支持下拉面板
  • 优化:优化夜间模式的切换机制

💖 鸣谢

这些都是在开发过程中给予我帮助的项目和大佬!

开源项目

贡献者

这里只列出贡献「相对较大」的贡献者,所有的贡献者名单请到这里查看

贡献者 贡献内容
@BigCoke233 (Eltrac) 原作者 / 主要维护者
@outtimes 提供各种有用的功能
@ohmyga233 实现 Ajax 评论无刷新
@kengwang 提供追番页面

参考

VOID | Castle | Holakit | Material | Mirages

🔮 相关

演示站点:我的博客(博客是第二代版本)
介绍文章:Miracles —— 生为奇迹
说明文档:Wiki.md | Notion(被墙了,故停止维护)
更新日志:change-log.md
侵权网站:black-list.md

🎁 捐助

你可以通过爱发电向我投食,用金钱催更;或是在 Open Collective 上为 Miracles 进行捐献
又或者是用支付宝扫码支付,感谢投食,~~据说砸得越多更新越快~~~


Copyright © 2019-2020 Eltrac, released under SATA-BNP License.

You can’t perform that action at this time.