안녕하세요,
공식 Git 저장소에서 Mint 테마를 업데이트하는 중 문제가 발생했습니다.
환경 정보
- Discourse 버전:
3.6.0.beta3-latest(tests-passed) - 테마 소스: GitHub - discourse/discourse-mint-theme: A modern theme with a hint of mint · GitHub (기본 브랜치)
- 설치 방법:
/admin/customize/themes→ “Install” → “From a git repository URL”
문제 사항
관리자 UI(/admin/customize/themes)에서 Mint 테마의 **“최신 버전으로 업데이트”**를 클릭하면 업데이트가 실패하며 다음과 같은 오류 다이얼로그가 표시됩니다:
테마 스크린샷은 .jpg, .jpeg, .gif, .png 형식 중 하나여야 합니다. light.webp 스크린샷은 유효하지 않은 형식입니다.
about.json 파일에서 테마는 현재 다음과 같이 참조하고 있습니다:
"screenshots": [
"screenshots/light.webp",
"screenshots/dark.webp"
]
그러나 Discourse 테마 문서에 따르면 테마 스크린샷은 jpg, jpeg, gif, png 형식만 허용되므로 .webp 형식은 코어 검증 과정에서 거부됩니다.
재현 단계
- /admin/customize/themes에서 공식 Git 저장소에서 Mint 테마를 설치합니다.
- Mint 테마 항목으로 이동합니다.
- **“최신 버전으로 업데이트”**를 클릭합니다.
- light.webp가 유효하지 않은 형식이라는 오류 다이얼로그를 확인합니다.
제안하는 수정 사항
스크린샷을 PNG로 변환하고 about.json을 그에 맞게 업데이트하는 PR을 열었습니다:
- screenshots/light.webp → screenshots/light.png
- screenshots/dark.webp → screenshots/dark.png
about.json업데이트 내용:
"screenshots": [
"screenshots/light.png",
"screenshots/dark.png"
]
이 변경 사항으로 관리자 UI에서 테마가 정상적으로 업데이트되고 스크린샷이 올바르게 표시됩니다.
스크린샷 처리에 권장되는 방식이 있거나(혹은 향후 코어에서 .webp가 지원될 예정이라면) PR을 조정할 수 있습니다.