{"id":17967728,"url":"https://github.com/BigCoke233/miracles","last_synced_at":"2025-03-25T08:31:28.125Z","repository":{"id":37886704,"uuid":"196376409","full_name":"BigCoke233/miracles","owner":"BigCoke233","description":"🎉 Typecho Theme Miracles - 生为奇迹","archived":false,"fork":false,"pushed_at":"2024-07-27T17:33:07.000Z","size":10098,"stargazers_count":517,"open_issues_count":15,"forks_count":48,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-21T00:02:07.301Z","etag":null,"topics":["typecho","typecho-theme"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BigCoke233.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"miracles","custom":["https://afdian.net/@Eltrac"]}},"created_at":"2019-07-11T10:51:16.000Z","updated_at":"2025-03-01T19:04:40.000Z","dependencies_parsed_at":"2024-10-29T14:39:32.582Z","dependency_job_id":null,"html_url":"https://github.com/BigCoke233/miracles","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigCoke233%2Fmiracles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigCoke233%2Fmiracles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigCoke233%2Fmiracles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BigCoke233%2Fmiracles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BigCoke233","download_url":"https://codeload.github.com/BigCoke233/miracles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245426290,"owners_count":20613324,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["typecho","typecho-theme"],"created_at":"2024-10-29T14:09:18.868Z","updated_at":"2025-03-25T08:31:27.328Z","avatar_url":"https://github.com/BigCoke233.png","language":"PHP","funding_links":["https://opencollective.com/miracles","https://afdian.net/@Eltrac"],"categories":["PHP"],"sub_categories":[],"readme":"![](banner.png)\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/build-passing-brightgreen.svg?style=flat-square\"\u003e \n\u003cimg src=\"https://img.shields.io/badge/made%20with-%E2%9D%A4-ff69b4.svg?style=flat-square\"\u003e \n\u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-SATA-blue.svg?style=flat-square\"\u003e\u003c/a\u003e \n\u003ca href=\"https://typecho.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/for-Typecho-blueviolet.svg?style=flat-square\"\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/BigCoke233/miracles/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/BigCoke233/miracles?color=red\u0026style=flat-square\"\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/BigCoke233/miracles/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/BigCoke233/miracles?color=orange\u0026style=flat-square\"\u003e\u003c/a\u003e \n\n\u003cp align=\"center\"\u003e\u003cstrong\u003e记录你心中的奇迹，书写你自己的篇章\u003c/strong\u003e\u003c/p\u003e\n\n---\n\n## 停更说明\n\n~~Miracles 目前已经停止更新，除非有严重的 bug，这个版本基本是不会再维护了。~~\n\n**2022/11/14 更新说明**：因为发现还有人用所以就稍微更新了一下，但没有发布正式版。主要内容是修复 bug 和移除一些不必要的功能，同时替换了 Alertify，使用 [Toaster](https://github.com/BigCoke233/toaster.js)\n\n如果你感兴趣的话，可以支持一下我的[新主题 Matcha](https://github.com/BigCoke233/matcha)。\n\n---\n\n## 🎨 特色\n\n- 响应式 / 自适应设计\n- Pjax 全站无刷新\n- Ajax 评论无刷新\n- 支持系统切换夜间模式\n- 调用 bilibili API 显示追番页面\n- 前台登录\n- 图片懒加载\n- 代码高亮 / 行号\n- 不错的兼容性\n    - 夜间模式下的 Pio 插件按钮样式\n    - 夜间模式下的 Aplayer 播放器\n    - Bilibili 外链长宽比例\n- 良好的阅读体验\n    - 阅读时长估计\n    - 字数统计\n    - 两种可供选择的字体（思源宋体/黑体）\n- 不错的自定义性能\n    - 两种可供选择的导航栏\n    - 多种图片懒加载动画供选择\n    - 黑白滤镜（哀悼模式）\n- 灵活的友情链接功能\n- 方便排版的短代码\n- 后台设置备份\n\n### 预览\n\n[作者博客](https://guhub.cn/) | [Miracles 常用页面元素示例](https://guhub.cn/miracles-content-style-demo.html)\n\n## 🚀 使用\n\n1. Star 本项目（遵循 SATA-BNP 开源协议）\n2. 下载**最新的 [Release](https://github.com/BigCoke233/miracles/releases)**\n3. 确保自身 PHP 环境在 7.1.0 及以上版本，并装有 CURL 拓展（否则一些功能无法正常使用）\n4. 解压后，**确认目录名为`Miracles`（M 大写）**\n5. 将文件夹放入 Typecho 根目录下的`usr/themes/`\n6. 到后台-外观-可用的主题中，启用主题\n7. **根据 [wiki](docs/wiki.md)** 配置主题\n\n\u003cdetails\u003e\u003csummary\u003e使用开发版\u003c/summary\u003e\u003cbr\u003e\n\n直接下载仓库，或者使用 git 命令行进行克隆。\n```git\n$ git clone https://github.com/BigCoke233/miracles.git\n```\n\u003e 不推荐使用开发版，因为可能有不确定的不稳定因素，并且不一定有有利改动\u003cbr\u003e如果你使用开发版出现任何问题，欢迎通过 issue 反馈，在等待回复期间请使用发行版\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003e遇到问题\u003c/summary\u003e\u003cbr\u003e\n\n如果在使用过程中遇到了任何问题，可以先阅读本主题的 [Wiki](docs/wiki.md)，并进行一些简单的确认：清理浏览器缓存，更换网络环境，确保 Console 内没有提示访问不到文件等自身原因。如果你无法靠自己解决问题，可以尝试联系作者，但记住**开发者没有为你解决问题的义务，只是出于好心的帮助。**  \n在确认你遇到的现象确实是一个 Bug 后，请在 [Issues](https://github.com/BigCoke233/miracles/issues) 提交问题，并为该问题尽可能的描述清楚，按照提供的 issue 模板进行填写，谢谢配合。\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003e关于版权\u003c/summary\u003e\u003cbr\u003e\n\n主题基于 SATA-BNP 协议开源，使用前你需要给这个项目点一个 Star，使用或转发时**请保留版权信息**，禁止倒卖。若需二次开发后发布，请邮件通知我`hi#guhub.cn`，并保留原作者版权信息及仓库链接。在最近（2020-5-28），我将 SATA 协议修改为了 SATA-BNP 协议，即不能将软件用作任何政治相关的用途，特别是政治宣传，但是按原文转载相关政治家的书籍、文章，不含有任何倾向的解读也是可以接受的。同时，如果发现有侵权行为，请告知我，屡教不改者将被列入[黑名单](docs/black-list.md)，删除版权的用户不会在遇到问题时受到来自作者的帮助，在后期可能会加入删除版权网站设置项失效的惩罚。\n\n\u003c/details\u003e\n\n### 更新日志\n\n**Ver.1.6.0 Your best nightmare**\n\n- 新增：支持自定义「导航栏图标按钮」\n- 新增：文章目录（使用 {:toc:} 在文中插入目录）\n- 新增：归档页面中添加「文章分类」栏目\n- 新增：支持快速写入`\u003cdetails\u003e`的短代码，并使用垫片优化兼容性\n- 新增：加入 html 压缩\n- 新增：多语言功能\n- 新增：兼容 typecho 评论反垃圾\n- 新增：高级设置\n- 新增：可选择主题字体 CDN 了\n- 新增：可以使用 TimThumb 裁剪文章缩略图了（需要在高级设置 themeConfig.php 里打开）\n- 优化：夜间模式下，notice 块的背景色\n- 优化：导航栏毛玻璃效果调整\n- 优化：导航栏透明度调整\n- 优化：将 kbd 的短代吗语法修改为 [[kbd]]\n- 优化：用 canvas 替换代码块的 mac 按钮图片\n- 优化：鼠标移动到文章卡片标题上时显示完整标题\n- 优化：将 FancyBox 和 Lazyload 替换为 gazeimg\n- 优化：归档页面，折叠往年的文章列表\n- 优化：用 localStorage 储存 theme，代替 cookie [#57](https://github.com/BigCoke233/miracles/issues/57)\n- 优化：在 php 层检测 faviconDark，避免前台出现 404 报错\n- 优化：模板设置备份中，判断 $_POST['type'] 存在后再进行备份处理，防止不必要的报错和其他风险\n- 优化：归档页面 meta 元信息\n- 优化：改进番剧页面（Done by Kengwang）\n- 优化：将 title 改为 hint.css 提供的 tooltip\n- 优化：将鼠标悬停在文章元信息上时，会显示对应的 tooltip\n- 优化：用 alertify.js 替换自己的提示框\n- 优化：页面/文章评论列表隐藏时，不显示评论数\n- 优化：将设置项「Pjax 完成后执行事件」更改为更准确的「Pjax 回调函数」\n- 修复：一个存在了超久的拼写错误（paresNav=\u003eparseNav）\n- 修复：archive 页面（即分类、标签、搜索等）文章头图问题\n- 修复：暴力解决访问密码文章时被 pjax 强制刷新的问题\n- 修复：评论区 owo 表情换行\n- 修复：标签、分类页面不显示文章缩略图\n- 修复：删除不必要的判断\n- 修复：自定义随机图失效\n- 修复：解决随机颜文字可能报错的问题\n- 修复：评论列表缺失 #comments id\n\n\u003e 所有历史版本的更新日志请查看[这里](docs/change-log.md)\n\n## 📝 计划\n\n- [x] 优化：用 localStorage 替换储存夜间/日落模式等的 cookie\n- [x] 新增：支持快速写入`\u003cdetails\u003e`的短代码，并使用[垫片](https://github.com/javan/details-element-polyfill)优化兼容性\n- [x] 新增：添加语言包功能，通过 php 数组储存各个语言版本的文字\n- [x] 优化：文章缩略图自动剪裁\n- [x] 优化：页面/文章评论列表隐藏时，不显示评论数\n- [x] 优化：支持用 jsDelivr 加速主题内置图片的速度\n- [ ] 增加：内置站点缓存规则\n- [ ] 优化：「说说页面」的样式\n- [ ] 新增：图片横向排版「相册功能」（参考：https://blog.imalan.cn/archives/282/）\n- [ ] 新增：全站加密功能\n- [ ] 新增：支持 PWA - 渐进式 Web 应用\n- [ ] 新增：嵌入 GitHub 仓库 / 用户（以卡片形式展示）\n- [ ] 新增：根据 cid 嵌入本站文章（以卡片形式展示）\n- [ ] 新增：文章目录\n- [ ] 优化：密码提示（可在加密文章中自定义对密码的提示）\n- [ ] 新增：全站公告\n- [ ] 优化：对日间模式/日落模式/夜间模式的切换通过下拉面板操作，并支持禁用主题跟随系统设置\n- [ ] 新增：导航支持下拉面板\n- [ ] 优化：优化夜间模式的切换机制\n\n## 💖 鸣谢\n\n\u003e 这些都是在开发过程中给予我帮助的项目和大佬！\n\n### 开源项目\n\n- [jQuery](https://github.com/jquery/jquery) - 若干开源项目和主题内一些 js 的前置\n- [Highlight.js](https://github.com/highlightjs/highlight.js) - 代码高亮\n- [Hightlight-line-numbers](https://github.com/wcoder/highlightjs-line-numbers.js) - 代码行号\n- [Pjax](https://github.com/defunkt/jquery-pjax) - Pjax 预加载\n- [Nprogress](https://github.com/rstacruz/nprogress) - Pjax 滚动条动画\n- [OwO](https://github.com/DIYgod/OwO) - 评论 OwO 表情\n- [Pangu.js](https://github.com/vinta/pangu.js) -分割中英文字符\n- [Normalize.css](http://necolas.github.io/normalize.css/) - 保证不同浏览器上各元素 css 默认效果相同\n- [qrcode.js](https://github.com/davidshimjs/qrcodejs) - 生成文章二维码\n- [gazeimg](https://github.com/ganxiaozhe/gazeimg) - 图片懒加载 \u0026 灯箱\n- [details-element-polyfill](https://github.com/javan/details-element-polyfill) - 优化 details 标签兼容性\n- [hint.css](https://kushagra.dev/lab/hint/) - 工具提示 Tooltip\n- [toaster.js](https://github.com/BigCoke233/toaster.js/) - Toast 提示框\n~~- [alertify](https://github.com/MohammadYounes/AlertifyJS) - 对话框和 snackbar(notifier)~~\n- [TableContents](https://github.com/lutdev/table-contents) - 生成文章目录\n- ~~[LazyLoad](https://github.com/tuupola/lazyload) - 图片懒加载~~（开发版已用新的方案替换）\n- ~~[FancyBox](https://github.com/fancyapps/fancybox) - 文章图片灯箱~~（开发版已用新的方案替换）\n\n### 贡献者\n\n这里只列出贡献「相对较大」的贡献者，所有的贡献者名单请到[这里](https://github.com/BigCoke233/miracles/graphs/contributors)查看\n\n| 贡献者 | 贡献内容 |\n| ------ | ------- |\n| [@BigCoke233 (Eltrac)](https://github.com/BigCoke233) | 原作者 / 主要维护者 |\n| [@outtimes](https://github.com/outtimes) | 提供各种有用的功能 |\n| [@ohmyga233](https://github.com/ohmyga233) | 实现 Ajax 评论无刷新 |\n| [@kengwang](https://github.com/kengwang) | 提供追番页面 |\n\n### 参考\n\n[VOID](https://github.com/AlanDecode/Typecho-Theme-VOID) | [Castle](https://github.com/ohmyga233/castle-Typecho-Theme) | [Holakit](https://github.com/wenxuanjun/Holakit) | [Material](https://github.com/idawnlight/typecho-theme-material) | [Mirages](https://get233.com/archives/mirages-intro.html)\n\n## 🔮 相关\n\n演示站点：~~[我的博客](https://guhub.cn)~~（博客是第二代版本）  \n介绍文章：[Miracles —— 生为奇迹](https://guhub.cn/p/miracles.html)  \n说明文档：[Wiki.md](docs/wiki.md) | [Notion(被墙了,故停止维护)](https://www.notion.so/eltrac/c7c631e21b3345caa2a09bd2fb5dd4b2)   \n更新日志：[change-log.md](docs/change-log.md)  \n侵权网站：[black-list.md](docs/black-list.md)\n\n## 🎁 捐助\n\n你可以通过[爱发电](https://afdian.net/@Eltrac)向我投食，~~用金钱催更~~；或是在 [Open Collective](https://opencollective.com/miracles) 上为 Miracles 进行捐献  \n又或者是用支付宝扫码支付，感谢投食，~~据说砸得越多更新越快~~~\n\n\u003cimg src=\"alipay.png\" width=\"70%\"\u003e\n\n---\n\nCopyright \u0026copy; 2019-2020 [Eltrac](https://github.com/BigCoke233), released under [SATA-BNP License](https://github.com/BigCoke233/miracles/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBigCoke233%2Fmiracles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBigCoke233%2Fmiracles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBigCoke233%2Fmiracles/lists"}