Kratos-Rebirth 关于主题的 v3 版本发展规划

首先我想向每一位维护者和用户道歉，因长期以来的疏于管理和维护让主题目前正处于一个高不成低不就的状态，很抱歉辜负了各位的期望 :pray:

这个主题的最初想法是我在还不是很懂代码的时候某次突发奇想拼凑出来的，并且由于在移植前（使用的魔改版）它的功能就已经非常丰富，所以到了实际移植做减法的时候留下了非常多的历史遗留问题，可以看到有很多提出 issue 希望新增其他功能或发现现有问题的情况。但一方面我自己已经很久没有更新主题和 blog 了所以甚至对主题感到有些陌生，另一方面由于一些时间排布问题所以并没有非常多的工夫来静下心来重拾这些内容。

但我也不想放弃这最初的美好。既然现有的架构充满了历史的遗憾，那索性推倒重来。所以就有了所谓的 v3 计划：

重新整理整个项目的结构
替换掉可用性不高或已经过时的组件依赖（例如仅为了展示弹窗引入的 layui 或是 ajax 用的 jQuery ，以及部分实现性能糟糕的特效代码）
去掉为了兼容性引入的冗余代码
使用成熟的方案来替代糟糕的手动实现（~~使用 flexsearch 替代手动搜索~~重新整理 hexo 的数据库内容读取代码）
用模块化的方式引入挂件（例如 aplayer 播放器）支持
提供一个尽可能精简的核心，再慢慢地填充其他的扩展内容
重建开发工作流

这将会是一个非常大的破坏性升级，现有的配置文件格式会被完全重新设计以便更为高效地实现需求；同时也会重写主题的文档，并在 v3 beta 版本推出的时候提供一份可用于参考的迁移说明。

我争取能在 2024 Q4 前推出 alpha 版本的 v3 主题，在 2026 元旦 推出第一个稳定发布版本。由于~~工作和~~生活上的一些琐事，我无法保证一定能稳步进展；但我会努力，无论是出于大家自发的认可（没有为主题做任何的广告也能达到如今的效果，说实话我已经非常震惊了），还是出于对自己初心的珍惜与热爱（这个应该算是我发布在 GitHub 上的第一个较为正式的项目）。

感谢各位一路以来一直的陪伴，期待我们继续一起前行。加油！

关于 v3.0.0 大版本发布前的 Pre-Release 的标签

预计使用四大阶段进行（选中表示已经进入阶段）：

[x] ~~dev 阶段：开发流程中的不稳定版本，随时可能有大的 breaking change ，不推荐开发者之外的用户使用~~ （因为标签字典序问题所以撤销了这个阶段的所有版本 tag ）
[x] alpha 阶段：可能会有一些 breaking change ，也可能会新增一些功能，但基本不会有完全颠覆性的改动，想玩玩看的可以先开始接触起来
[x] beta 阶段：配置和相关选项基本确定，用于列写文档的阶段，这个阶段后期会有一份较为详细的迁移说明以便用户参考
[x] rc 阶段（预计 2025 年 11 月）：该阶段暂停接收新功能改动，以修复现有功能中存在的问题为主

May 19 '24 09:05 Candinya

没事的，V3版本别忘了加入畅言，因为确实方便，如果是早期，我不会推荐畅言，但现在不同了。

May 19 '24 12:05 Linux-qitong

话说文章随机封面是打算删除吗

Jun 02 '24 02:06 ArcticLampyrid

Screenshot_2024-06-02-11-00-59-03_759d22c01f61b30a3a2e41e7176310a8 之前问过，主题未来类似于Next的结构，这是个好的方向，自定义更多。希望到时候不要太复杂就好。

Jun 02 '24 03:06 Linux-qitong

搜索页问题跟踪

[x] 结果列表大小异常
[x] 搜索框宽度未填充满页面区域
[x] 搜索结果高亮正确，无封面

Jun 02 '24 04:06 ArcticLampyrid

话说文章随机封面是打算删除吗

是的，主要是考虑到目前使用的随机图片存在版权隐患，去掉图片的时候也去掉了这个

但 V3 可以自行注入代码，所以未来预计会提供一个简单的示例脚本方便使用

Jun 02 '24 13:06 Candinya

搜索结果未正确应用封面信息

这个其实想的是搜索结果里不需要包含封面信息，主要显示高亮关键词，可能是改样式的时候出了点问题导致左边空出来了一块

Jun 02 '24 13:06 Candinya

大佬加油啊，用了这个主题两年半了，希望越来越好(⁠●⁠♡⁠∀⁠♡⁠)

Jun 03 '24 02:06 RainHoutas

我有点蠢，友链那里没看懂... _data 应该是跟_post一个目录？

最近才换，v2也还没注意友链这块。

我是想加到footer那块，additional_injections 似乎不能加 {% linklist linklistindata %}吧

Sep 22 '24 14:09 ted423

_data 应该是跟_post一个目录？

对的，就是 quickstart 仓库里的 source/_data/linklist.yml 这个文件 https://github.com/kratos-rebirth/quickstart/blob/main/source/_data/linklist.yml

我是想加到footer那块，additional_injections 似乎不能加 {% linklist linklistindata %}吧

是指纯文字（HTML）形式引入吗？使用 linklist 组件做出来的是一个带有样式的块状结构列表，如果是页脚文本的话应该是 footer.components.additional 这里，确实不能用组件而是需要手工设置（但也不麻烦，配置一遍给所有页面可用），可以参考 https://wiki.krt.moe/posts/configurations/#页脚配置

Sep 24 '24 10:09 Candinya

希望能够支持webp以及avif格式的图片显示

Dec 01 '24 09:12 1398listener

希望能够支持webp以及avif格式的图片显示

这个靠的是浏览器吧

Dec 01 '24 12:12 ted423

大佬等正式版出之前更新一下icon库呗，有的社交媒体网站旧图库没有相应的图标而新图库有qwq

Dec 11 '24 09:12 Selkous

大佬等正式版出之前更新一下icon库呗，有的社交媒体网站旧图库没有相应的图标而新图库有qwq

这个图标库的用法有个历史问题，就是它是以 webfont 形式引入的，而这样引入的在加载的时候会卡住渲染进程，图标越多卡住越久。之前尝试过更换使用 tabler icons 库，但测试发现出现了极其明显的卡顿（大概在 3 秒以上，Firefox 比 Chrome 系严重），所以还是就还是用现在这个老库作为泛用图标，并且支持直接引入自定义的 SVG 图标作为补充（可以参见文档里的相关描述，或是参考 quickstart 里的配置，应该是所有 icon: 的字段都可以引入自定义 SVG 图标，遇到哪里有不支持的可以开一个 PR 或是 issue 报一下都行）

Dec 11 '24 14:12 Candinya

大佬等正式版出之前更新一下icon库呗，有的社交媒体网站旧图库没有相应的图标而新图库有qwq

这个图标库的用法有个历史问题，就是它是以 webfont 形式引入的，而这样引入的在加载的时候会卡住渲染进程，图标越多卡住越久。之前尝试过更换使用 tabler icons 库，但测试发现出现了极其明显的卡顿（大概在 3 秒以上，Firefox 比 Chrome 系严重），所以还是就还是用现在这个老库作为泛用图标，并且支持直接引入自定义的 SVG 图标作为补充（可以参见文档里的相关描述，或是参考 quickstart 里的配置，应该是所有 icon: 的字段都可以引入自定义 SVG 图标，遇到哪里有不支持的可以开一个 PR 或是 issue 报一下都行）

好的感谢详细的回复，祝这个主题发展越来越好，推倒重建属实不易🥹

Dec 14 '24 20:12 Selkous