KenanZhuandClaude Opus 4.8
77854ee0ed
The build-preview.go now uses discoverThemes() to find all theme directories under themes/ automatically. The manual step of adding themes to a slice is no longer needed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
Участие в разработке — Gitea Mail Templates
Способы участия
Добавление нового стиля
- Создайте директорию стиля:
themes/<имя-стиля>/ - Скопируйте структуру из существующего стиля
- Реализуйте все 11
.tmplфайлов с уникальным дизайном - Перегенерируйте превью:
go run ./tools/build-preview.go(скрипт автоматически находит все темы вthemes/) - Добавьте тему в
<select id="sel-theme">вpreview/index.html - Отправьте PR со скриншотами
Рекомендации по стилю
- Каждый стиль должен включать все 11 типов шаблонов
- Используйте только встроенные функции шаблонов Gitea
- Ключи перевода из официальных файлов локали Gitea (
mail.*) - Не используйте
.DisplayNameгде его нет в контексте (collaborator, transfer, release, workflow_run, assigned, default) - Дизайн для 600px email клиентов
- Тестируйте в Gmail, Outlook, Apple Mail
Баг-репорты
- Проверьте переменные Go в шаблонах
- Сверьте ключи перевода с локалью Gitea
- Убедитесь что
.DisplayNameне используется где не надо - Перегенерируйте превью:
go run ./tools/build-preview.go - Создайте issue с указанием стиля и типа письма
Настройка разработки
Локальный предпросмотр
- Сгенерируйте данные:
go run ./tools/build-preview.go - Откройте
preview/index.htmlв браузере - Переключайте Modern, Gmail, Outlook, Raw source для проверки
Интеграционное тестирование
Разверните на Gitea: Site Administration > Configuration > Mailer > Send Test Email
Соглашение о коммитах
style(<имя>):— изменения шаблонов стиляpreview:— инструменты предпросмотраtools:— Go-скрипт сборкиdocs:— документация и переводыfix:— исправленияproject:— README, LICENSE, мета-файлы
Лицензия
Участвуя, вы соглашаетесь с лицензией MIT.