添加 kramdown_enhancer 插件

[neveler]

添加 kramdown_enhancer 插件

变更

1. 移除 nokogiri 依赖项
2. 整合 auto-alert auto-link 插件
   • 现在插件不会额外对引用块插入 “注意” “谨慎” 等粗体字样
3. 支持 PNG、JPEG、TIFF 三种格式的图片自动生成 WEBP 格式图片
4. 支持存在 WEBP 格式的图片优先使用 WEBP

Note

变更 3 通过引入新的依赖实现，需要注意的是该依赖仅在特定环境下方可使用，请在确认自己的环境可用的前提下通过设置环境变量 ENABLE_WEBP_AUTO_CONVERSION 为 true 方式启用。
https://github.com/le0pard/webp-ffi

Note

本 PR 中包含了手动转换为 WebP 的 GIF 文件，这些文件是在 win 平台下由 gif2webp 工具 gif2webp input.gif -o input.gif.webp 手动转换生成的。

resolve #318

---

https://link-docs.hmcl.workers.dev

[neveler]

鉴于等待黄鱼审核可能会拉长本 PR 的审核周期，故此使用了由 drone 提供的环境变量 DRONE 用于判断构建环境是否启用 WEBP 以避免对 drone.yml 文件的修改。

[zkitefly]

WebP.encode 所得到的产物 webp 压缩率怎么样？

---

自动转换 webp 后原图片文件会清除吗，这样可以减轻源服务器的储存压力吗？（有压力吗？）

[neveler]

WebP.encode 所得到的产物 webp 压缩率怎么样？

这个我没有统计过，不过这个压缩可以通过 quality 参数调节，我没指定默认应该是 100

https://github.com/le0pard/webp-ffi/blob/167b865e1f8f7a589cd0964fb57aae4627cfe578/lib/webp/options.rb#L47

自动转换 webp 后原图片文件会清除吗，这样可以减轻源服务器的储存压力吗？（有压力吗？）

不会清除原文件，当前是通过把 img 包在 picture 里，如浏览器不支持 webp 会自动回退到原文件。

<picture>
  <source srcset="/assets/img/docs/isolation/img1.png.webp" type="image/webp">
  <img src="/assets/img/docs/isolation/img1.png" alt="">
</picture>

[neveler]

目前的 md 解析器似乎不支持 mermaid 代码块（虽然项目里也没有）不知道是否有兴趣添加这方面的支持。

我觉得在更新日志页放个版本生命周期的甘蔗图似乎也有点用。

[zkitefly]

目前的 md 解析器似乎不支持 mermaid 代码块（虽然项目里也没有）不知道是否有兴趣添加这方面的支持。

我觉得在更新日志页放个版本生命周期的甘蔗图似乎也有点用。

如该是关于 版本生命周期的甘蔗图 而支持 mermaid 代码块，那就要看看 @Glavo 有没有打算整该图表

[neveler]

如该是关于 版本生命周期的甘蔗图 而支持 mermaid 代码块，那就要看看 @Glavo 有没有打算整该图表

我给个示例图，时间是随便填的。

---
displayMode: compact
---
gantt
    title HMCL 版本生命周期
    section 3.13
        开发阶段: 3-13-dev, after 3-12-dev, 15d
        预览阶段: 3-13-preview, after 3-13-dev, 10d
        维护阶段: 3-13-release, after 3-13-preview, 30d
        3.13.0.134:milestone, isadded, after 3-12-dev, 0d
    section 3.12
        开发阶段: 3-12-dev, 2025-12-25, 15d
        预览阶段: 3-12-preview, after 3-12-dev, 10d
        维护阶段: 3-12-release, after 3-12-preview, 30d
        3.12.0.132:milestone, 3-12-0-132, 2025-12-25, 0d
        3.12.0.133:milestone, 3-12-0-133, 2026-01-02, 0d
        3.12.1:milestone, 3-12-1, after 3-12-dev, 0d
        3.12.2:milestone, 3-12-2, after 3-12-preview, 0d
        3.12.3:milestone, 3-12-3, 2026-02-01, 0d

Loading