Skip to content

Conversation

@neveler
Copy link
Contributor

@neveler neveler commented Nov 20, 2025

优先使用 WebP 版本的图片

Note

本 PR 并不包含实际的 webp 文件,可以配合 #350

介绍

插件在构建时会扫描所有 src/assets/ 开头的 <img> 标签,并在存在 WebP 版本时将其改写为 <picture> 以优先使用 WebP 格式的图片。

若图片路径为 /assets/test/a.png,则对应的 WebP 版本路径应为 /assets/test/a.png.webp

预览

https://neveler.github.io/HMCL-docs/PR16/faq.html

https://github.com/neveler/HMCL-docs/blob/dev-webp-test/assets/img/docs/about-questions/img.png.webp

<picture><source srcset="/HMCL-docs/PR16/assets/img/docs/about-questions/img.png.webp" type="image/webp"><img src="/HMCL-docs/PR16/assets/img/docs/about-questions/img.png" alt=""></picture>

Closes #318

@neveler neveler changed the title 优先使用 WebP 版本的图片(如果可用) 优先使用 WebP 版本的图片 Nov 20, 2025
@Glavo
Copy link
Member

Glavo commented Nov 20, 2025

GitHub 今年 8 月的更新后,GitHub 现在对 WebP 有良好的原生支持。而且我们也更新了 HMCL 主页,现在仅使用 WebP 图片。我觉得没有必要在 HMCL-docs 中使用 PNG 图片了。

@neveler
Copy link
Contributor Author

neveler commented Nov 20, 2025

GitHub 今年 8 月的更新后,GitHub 现在对 WebP 有良好的原生支持。而且我们也更新了 HMCL 主页,现在仅使用 WebP 图片。我觉得没有必要在 HMCL-docs 中使用 PNG 图片了。

在生产图片时 WebP 似乎并不是主流的图片格式。无论是常见的截图工具、设计工具,还是系统级的截图快捷方式,默认产物几乎都不会是 WebP。这意味着贡献者在创建文档或提交图片时,大概率仍需先在本地进行格式转换,增加了额外步骤和潜在阻力。

基于这一点,我仍计划提交一个基于 GitHub Action 实现的自动为非 WebP 图片生成对应的 WebP 版本的 PR 这样既能保持网站的图片优先 WebP 以节省网络流量又能避免社区贡献者可能的手动处理格式转换的负担。

@Glavo
Copy link
Member

Glavo commented Nov 22, 2025

基于这一点,我仍计划提交一个基于 GitHub Action 实现的自动为非 WebP 图片生成对应的 WebP 版本的 PR 这样既能保持网站的图片优先 WebP 以节省网络流量又能避免社区贡献者可能的手动处理格式转换的负担。

我还是觉得意义不大,这种自动 PR 也可能会给贡献者带来困扰。我觉得 PR 开发过程中外部贡献者完全可以使用 PNG/JPEG/GIF 等图片,在合并前由有权限修改 PR 的贡献者转换一次就行了。

@neveler
Copy link
Contributor Author

neveler commented Nov 23, 2025

这种自动 PR 也可能会给贡献者带来困扰。

可以具体说说是什么困扰吗?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

全面迁移至 Webp

2 participants