chore(init): scaffold Gitea mail templates — 110 templates, 10 visual styles, drop-in deployment

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-03 18:10:22 +08:00
commit a2742887e8
@@ -0,0 +1,59 @@
+# Участие в разработке — Gitea Mail Templates
+
+## Способы участия
+
+### Добавление нового стиля
+
+1. Создайте директорию стиля: `themes/<имя-стиля>/`
+2. Скопируйте структуру из существующего стиля
+3. Реализуйте все 11 `.tmpl` файлов с уникальным дизайном
+4. Добавьте тему в слайс `themes` в `tools/build-preview.go`
+5. Перегенерируйте превью: `go run ./tools/build-preview.go`
+6. Добавьте тему в `<select id="sel-theme">` в `preview/index.html`
+7. Отправьте PR со скриншотами
+
+### Рекомендации по стилю
+
+- Каждый стиль должен включать **все 11 типов шаблонов**
+- Используйте только встроенные функции шаблонов Gitea
+- Ключи перевода из официальных файлов локали Gitea (`mail.*`)
+- **Не используйте `.DisplayName`** где его нет в контексте (collaborator, transfer, release, workflow_run, assigned, default)
+- Дизайн для 600px email клиентов
+- Тестируйте в Gmail, Outlook, Apple Mail
+
+### Баг-репорты
+
+1. Проверьте переменные Go в шаблонах
+2. Сверьте ключи перевода с локалью Gitea
+3. Убедитесь что `.DisplayName` не используется где не надо
+4. Перегенерируйте превью: `go run ./tools/build-preview.go`
+5. Создайте issue с указанием стиля и типа письма
+
+---
+
+## Настройка разработки
+
+### Локальный предпросмотр
+
+1. Сгенерируйте данные: `go run ./tools/build-preview.go`
+2. Откройте `preview/index.html` в браузере
+3. Переключайте Modern, Gmail, Outlook, Raw source для проверки
+
+### Интеграционное тестирование
+
+Разверните на Gitea: **Site Administration > Configuration > Mailer > Send Test Email**
+
+---
+
+## Соглашение о коммитах
+
+- `style(<имя>):` — изменения шаблонов стиля
+- `preview:` — инструменты предпросмотра
+- `tools:` — Go-скрипт сборки
+- `docs:` — документация и переводы
+- `fix:` — исправления
+- `project:` — README, LICENSE, мета-файлы
+
+## Лицензия
+
+Участвуя, вы соглашаетесь с лицензией MIT.