薄荷主题

自定义 主题
,
68 
您好，

我在从官方 Git 仓库更新 Mint 主题时遇到了一个问题。

**环境**

- Discourse 版本：`3.6.0.beta3-latest` (tests-passed)
- 主题来源：https://github.com/discourse/discourse-mint-theme (默认分支)
- 安装方式：通过 `/admin/customize/themes` → “安装” → “从 git 仓库 URL”

**问题**

当我在管理界面（`/admin/customize/themes`）点击 Mint 主题的 **“更新到最新”** 时，更新失败并出现以下错误对话框：

> 主题截图必须是以下格式之一：.jpg、.jpeg、.gif、.png。截图 light.webp 格式无效。

在 `about.json` 中，该主题当前引用：

```json
"screenshots": [
  "screenshots/light.webp",
  "screenshots/dark.webp"
]

然而，根据 Discourse 主题文档，主题截图只允许是 jpg、jpeg、gif 或 png，因此 .webp 被核心验证拒绝了。

重现步骤

  1. 在 /admin/customize/themes 中从官方 Git 仓库安装 Mint 主题。
  2. 进入 Mint 主题条目。
  3. 点击 “更新到最新”。
  4. 观察到关于 light.webp 格式无效的错误对话框。

建议的修复

我已提交一个 PR，将截图转换为 PNG 并相应地更新 about.json：

  • screenshots/light.webp → screenshots/light.png
  • screenshots/dark.webp → screenshots/dark.png
  • about.json 更新为：
"screenshots": [
  "screenshots/light.png",
  "screenshots/dark.png"
]

PR：Use PNG screenshots for Discourse compatibility by ieduer · Pull Request #64 · discourse/discourse-mint-theme · GitHub

进行此更改后，主题在管理界面中可以干净地更新，并且截图可以正确显示。

如果您对如何处理截图有偏好的方式（或者核心未来是否应该支持 .webp），我乐意调整 PR。

1 个赞