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

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/CONTRIBUTING.ja.md

@@ -0,0 +1,59 @@
+# コントリビューション — Gitea メールテンプレート
+
+## 参加方法
+
+### 新しいスタイルの追加
+
+1. スタイルディレクトリを作成: `themes/<style-name>/`
+2. 既存スタイルからディレクトリ構造をコピー
+3. 11個の `.tmpl` ファイルを独自デザインで実装
+4. `tools/build-preview.go` の `themes` スライスに追加
+5. プレビューを再生成: `go run ./tools/build-preview.go`
+6. `preview/index.html` の `<select id="sel-theme">` に追加
+7. スクリーンショット付きで PR を提出
+
+### スタイルガイドライン
+
+- 各スタイルに **全11種類のテンプレート** を含める
+- Gitea 組み込み関数のみ使用
+- 翻訳キーは Gitea 公式ロケール (`mail.*`) から
+- **`.DisplayName` を使用しない** (collaborator, transfer, release, workflow_run, assigned, default)
+- 600px 幅のメールクライアント向けにデザイン
+- 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(<name>):` — スタイルのテンプレート変更
+- `preview:` — プレビューツールの変更
+- `tools:` — Go ビルドスクリプトの変更
+- `docs:` — ドキュメントと翻訳
+- `fix:` — バグ修正
+- `project:` — README, LICENSE, メタファイル
+
+## ライセンス
+
+貢献により、MIT ライセンスに同意したものとみなします。

docs/CONTRIBUTING.ko.md

@@ -0,0 +1,59 @@
+# 기여 가이드 — Gitea 메일 템플릿
+
+## 기여 방법
+
+### 새 스타일 추가하기
+
+1. 스타일 디렉토리 생성: `themes/<style-name>/`
+2. 기존 스타일에서 디렉토리 구조 복사
+3. 11개 `.tmpl` 파일을 고유한 디자인으로 구현
+4. `tools/build-preview.go`의 `themes` 슬라이스에 추가
+5. 프리뷰 재생성: `go run ./tools/build-preview.go`
+6. `preview/index.html`의 `<select id="sel-theme">`에 추가
+7. 스크린샷과 함께 PR 제출
+
+### 스타일 가이드라인
+
+- 각 스타일에 **11개 템플릿 유형 모두** 포함
+- Gitea 내장 함수만 사용
+- 번역 키는 Gitea 공식 로케일 (`mail.*`) 사용
+- **`.DisplayName` 사용 금지** (collaborator, transfer, release, workflow_run, assigned, default)
+- 600px 너비의 이메일 클라이언트에 맞게 디자인
+- Gmail, Outlook, Apple Mail에서 테스트
+
+### 버그 리포트
+
+1. Go 변수가 올바른지 확인
+2. 번역 키가 Gitea 로케일과 일치하는지 확인
+3. `.DisplayName`이 오용되지 않았는지 확인
+4. 프리뷰 재생성: `go run ./tools/build-preview.go`
+5. 스타일 이름과 메일 유형을 명시하여 이슈 생성
+
+---
+
+## 개발 설정
+
+### 로컬 프리뷰
+
+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(<name>):` — 스타일 템플릿 변경
+- `preview:` — 프리뷰 도구 변경
+- `tools:` — Go 빌드 스크립트 변경
+- `docs:` — 문서 및 번역
+- `fix:` — 버그 수정
+- `project:` — README, LICENSE, 메타 파일
+
+## 라이선스
+
+기여함으로써 MIT 라이선스에 동의하게 됩니다.

docs/CONTRIBUTING.ru.md

@@ -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.

docs/CONTRIBUTING.zh-CN.md

@@ -0,0 +1,66 @@
+# 贡献指南 — Gitea 邮件模板
+
+## 参与方式
+
+### 添加新风格
+
+1. 创建风格目录：`themes/<风格名称>/`
+2. 从现有风格复制目录结构
+3. 用独特的视觉设计实现全部 11 个 `.tmpl` 文件
+4. 在 `tools/build-preview.go` 的 `themes` 切片中添加新主题
+5. 重新生成预览：`go run ./tools/build-preview.go`
+6. 在 `preview/index.html` 的 `<select id="sel-theme">` 中添加选项
+7. 提交包含截图渲染效果的 PR
+
+### 风格指南
+
+- 每个风格必须包含全部 **11 种模板类型**
+- 只使用 Gitea 内置模板函数
+- 翻译键必须来自 Gitea 官方语言文件（`mail.*` 命名空间）
+- **不要在以下模板中使用 `.DisplayName`**：collaborator、transfer、release、workflow_run、assigned、default
+- 面向 600px 宽度的邮件客户端设计
+- 尽可能在 Gmail、Outlook、Apple Mail 中测试
+
+### 报告 Bug
+
+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:` — Bug 修复
+- `project:` — README、LICENSE、元文件
+
+## 许可协议
+
+参与贡献即表示您同意将您的贡献以 MIT 许可证授权。

docs/CONTRIBUTING.zh-TW.md

@@ -0,0 +1,66 @@
+# 貢獻指南 — Gitea 郵件模板
+
+## 參與方式
+
+### 新增風格
+
+1. 建立風格目錄：`themes/<風格名稱>/`
+2. 從現有風格複製目錄結構
+3. 以獨特的視覺設計實作全部 11 個 `.tmpl` 檔案
+4. 在 `tools/build-preview.go` 的 `themes` 切片中新增主題
+5. 重新產生預覽：`go run ./tools/build-preview.go`
+6. 在 `preview/index.html` 的 `<select id="sel-theme">` 中新增選項
+7. 提交包含螢幕截圖的 PR
+
+### 風格指南
+
+- 每個風格必須包含全部 **11 種模板類型**
+- 僅使用 Gitea 內建模板函式
+- 翻譯鍵必須來自 Gitea 官方語系檔案（`mail.*` 命名空間）
+- **請勿在以下模板中使用 `.DisplayName`**：collaborator、transfer、release、workflow_run、assigned、default
+- 針對 600px 寬度的郵件用戶端設計
+- 盡可能在 Gmail、Outlook、Apple Mail 中測試
+
+### 回報 Bug
+
+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:` — Bug 修復
+- `project:` — README、LICENSE、中繼資料檔案
+
+## 授權條款
+
+參與貢獻即表示您同意將您的貢獻以 MIT 授權條款授權。

docs/README.ja.md

@@ -0,0 +1,50 @@
+# Gitea メールテンプレート
+
+[Gitea](https://about.gitea.com) のためのメールテンプレートコレクション。
+
+> **110 ファイル — 10 スタイル、各11種類**
+
+---
+
+## スタイルギャラリー
+
+| プレビュー | スタイル | 対象 | 特徴 |
+|---|---|---|---|
+| ![Horizon](images/horizon.png) | **Horizon** | エンタープライズ | Blue accent, slate, centred cards |
+| ![Terminal](images/terminal.png) | **Terminal** | 開発者 | Dark mode, monospace, green CLI |
+| ![Ember](images/ember.png) | **Ember** | コミュニティ | Warm amber, rounded, inclusive |
+| ![Bloom](images/bloom.png) | **Bloom** | クリエイティブ | Frosted glass, soft blue light |
+| ![Heritage](images/heritage.png) | **Heritage** | 教育/研究 | Navy and gold, serif, classic |
+| ![Neon](images/neon.png) | **Neon** | ゲーム/Web3 | Cyberpunk neon, pink and cyan |
+| ![Mono](images/mono.png) | **Mono** | デザイン/編集 | Swiss brutalist, black-white-red |
+| ![Terra](images/terra.png) | **Terra** | サステナビリティ | Warm earth tones, organic textures |
+| ![Ink](images/ink.png) | **Ink** | 出版/ニュース | Editorial print, navy and gold |
+| ![Aurora](images/aurora.png) | **Aurora** | プレミアムSaaS | Ethereal gradients, purple and teal |
+
+> 画像は[ライブプレビュー](../preview/index.html)からの600px幅のスクリーンショットです。キャプチャ手順は [images/README.md](images/README.md) を参照してください。
+
+[**ライブプレビュー**](../preview/index.html)
+
+---
+
+## インストール
+
+```bash
+cp -r themes/horizon/mail/* /var/lib/gitea/custom/templates/mail/
+systemctl restart gitea
+```
+
+## プレビュー
+
+```bash
+go run ./tools/build-preview.go
+```
+その後 `preview/index.html` を開く。
+
+## 互換性
+
+- **Gitea 1.21+**, 100%互換, 組み込み関数のみ
+
+## ライセンス
+
+MIT — [LICENSE](../LICENSE).

docs/README.ko.md

@@ -0,0 +1,50 @@
+# Gitea 메일 템플릿
+
+[Gitea](https://about.gitea.com) 인스턴스를 위한 메일 템플릿 컬렉션.
+
+> **110 파일 — 10 스타일, 각 11종류**
+
+---
+
+## 스타일 갤러리
+
+| 미리보기 | 스타일 | 대상 | 특징 |
+|---|---|---|---|
+| ![Horizon](images/horizon.png) | **Horizon** | 엔터프라이즈 | Blue accent, slate, centred cards |
+| ![Terminal](images/terminal.png) | **Terminal** | 개발자 | Dark mode, monospace, green CLI |
+| ![Ember](images/ember.png) | **Ember** | 커뮤니티 | Warm amber, rounded, inclusive |
+| ![Bloom](images/bloom.png) | **Bloom** | 크리에이티브 | Frosted glass, soft blue light |
+| ![Heritage](images/heritage.png) | **Heritage** | 교육/연구 | Navy and gold, serif, classic |
+| ![Neon](images/neon.png) | **Neon** | 게임/Web3 | Cyberpunk neon, pink and cyan |
+| ![Mono](images/mono.png) | **Mono** | 디자인/편집 | Swiss brutalist, black-white-red |
+| ![Terra](images/terra.png) | **Terra** | 지속가능성 | Warm earth tones, organic textures |
+| ![Ink](images/ink.png) | **Ink** | 출판/뉴스 | Editorial print, navy and gold |
+| ![Aurora](images/aurora.png) | **Aurora** | 프리미엄SaaS | Ethereal gradients, purple and teal |
+
+> 이미지는 [라이브 프리뷰](../preview/index.html)에서 캡처한 600px 너비 스크린샷입니다. 캡처 방법은 [images/README.md](images/README.md)를 참조하세요.
+
+[**라이브 프리뷰**](../preview/index.html)
+
+---
+
+## 설치
+
+```bash
+cp -r themes/horizon/mail/* /var/lib/gitea/custom/templates/mail/
+systemctl restart gitea
+```
+
+## 프리뷰
+
+```bash
+go run ./tools/build-preview.go
+```
+그런 다음 `preview/index.html` 열기.
+
+## 호환성
+
+- **Gitea 1.21+**, 100% 호환, 내장 함수만 사용
+
+## 라이선스
+
+MIT — [LICENSE](../LICENSE).

docs/README.ru.md

@@ -0,0 +1,50 @@
+# Gitea Mail Templates — Шаблоны писем Gitea
+
+Коллекция шаблонов писем для [Gitea](https://about.gitea.com).
+
+> **110 файлов — 10 стилей, по 11 типов писем**
+
+---
+
+## Галерея стилей
+
+| Превью | Стиль | Аудитория | Характер |
+|---|---|---|---|
+| ![Horizon](images/horizon.png) | **Horizon** | Корпоративный | Синий акцент, slate, centred cards |
+| ![Terminal](images/terminal.png) | **Terminal** | Разработчики | Тёмная тема, monospace, зелёный CLI |
+| ![Ember](images/ember.png) | **Ember** | Open Source | Тёплый янтарь, rounded, инклюзивный |
+| ![Bloom](images/bloom.png) | **Bloom** | Креатив / Стартапы | Матовое стекло, мягкий синий свет |
+| ![Heritage](images/heritage.png) | **Heritage** | Образование | Navy и золото, serif, классика |
+| ![Neon](images/neon.png) | **Neon** | Игры / Web3 / Креатив | Киберпанк-неон, розовый и циан |
+| ![Mono](images/mono.png) | **Mono** | Дизайн / Редакция | Швейцарский брутализм, чёрный-белый-красный |
+| ![Terra](images/terra.png) | **Terra** | Устойчивость / Здоровье | Тёплые земляные тона, органические текстуры |
+| ![Ink](images/ink.png) | **Ink** | Издательство / Новости | Редакционная печать, navy и золото |
+| ![Aurora](images/aurora.png) | **Aurora** | Премиум SaaS | Эфирные градиенты, пурпур и бирюза |
+
+> Изображения шириной 600px из [предпросмотра](../preview/index.html). Инструкции по созданию скриншотов: [images/README.md](images/README.md).
+
+[**Галерея предпросмотра**](../preview/index.html)
+
+---
+
+## Установка
+
+```bash
+cp -r themes/horizon/mail/* /var/lib/gitea/custom/templates/mail/
+systemctl restart gitea
+```
+
+## Предпросмотр
+
+```bash
+go run ./tools/build-preview.go
+```
+Затем откройте `preview/index.html`.
+
+## Совместимость
+
+- **Gitea 1.21+**, 100% совместимость, только встроенные функции
+
+## Лицензия
+
+MIT — [LICENSE](../LICENSE).

docs/README.zh-CN.md

@@ -0,0 +1,66 @@
+# Gitea 邮件模板
+
+为自托管 [Gitea](https://about.gitea.com) 实例精心设计、面向不同受众的邮件模板集合。
+
+> **110 个模板文件 — 10 种视觉风格，每种 11 种邮件类型**
+
+---
+
+## 设计理念
+
+大多数自托管 Gitea 实例使用默认的纯文本邮件模板。本项目提供了**开箱即用、视觉精美的替代方案**——每种方案都针对特定社区或受众设计，您可以选择最适合您用户的风格。
+
+每个模板都是直接替换。所有 Go 模板变量、翻译键和 Gitea 数据上下文完全兼容。**无需补丁、无需插件、无需 fork。**
+
+---
+
+## 风格画廊
+
+| 预览 | 风格 | 受众 | 特点 |
+|---|---|---|---|
+| ![Horizon](images/horizon.png) | **Horizon** | 企业/公司 | 蓝色强调色、石板灰排版、居中卡片 |
+| ![Terminal](images/terminal.png) | **Terminal** | 开发者/技术 | 暗色模式、等宽字体、绿色命令行风格 |
+| ![Ember](images/ember.png) | **Ember** | 社区/开源 | 暖琥珀色、圆角、人文主义、包容 |
+| ![Bloom](images/bloom.png) | **Bloom** | 创意/初创 | 磨砂玻璃、柔和蓝色光线、虹彩点缀 |
+| ![Heritage](images/heritage.png) | **Heritage** | 教育/研究 | 海军蓝与金色、衬线字体、经典、权威 |
+| ![Neon](images/neon.png) | **Neon** | 游戏/Web3/创意科技 | 赛博朋克霓虹、粉红与青色、合成波能量 |
+| ![Mono](images/mono.png) | **Mono** | 设计工作室/编辑 | 瑞士粗野主义、黑白红强调、零圆角 |
+| ![Terra](images/terra.png) | **Terra** | 可持续/健康 | 温暖大地色调、有机质感、人文衬线 |
+| ![Ink](images/ink.png) | **Ink** | 出版/新闻/文学 | 编辑印刷、深蓝与金色、报纸排版 |
+| ![Aurora](images/aurora.png) | **Aurora** | 高端SaaS/正念 | 空灵光效渐变、深紫与青绿、大气光晕 |
+
+> 图片为 600px 宽截图，来自[在线预览](../preview/index.html)。截图方法参见 [images/README.md](images/README.md)。
+
+[**在线预览画廊**](../preview/index.html)
+
+---
+
+## 安装
+
+选择一种风格，将 `mail/` 目录复制到 Gitea 自定义模板路径：
+
+```bash
+cp -r themes/horizon/mail/* /var/lib/gitea/custom/templates/mail/
+systemctl restart gitea
+```
+
+切换风格只需覆盖文件，无需更改配置。
+
+---
+
+## 预览
+
+```bash
+go run ./tools/build-preview.go
+```
+然后打开 `preview/index.html`。
+
+---
+
+## 兼容性
+
+- **Gitea 1.21+**，100% 变量兼容，仅使用内置函数和官方翻译键
+
+## 许可证
+
+MIT — 详见 [LICENSE](../LICENSE)。

docs/README.zh-TW.md

@@ -0,0 +1,66 @@
+# Gitea 郵件模板
+
+為自託管 [Gitea](https://about.gitea.com) 實例精心設計、面向不同受眾的郵件模板集合。
+
+> **110 個模板檔案 — 10 種視覺風格，每種 11 種郵件類型**
+
+---
+
+## 設計理念
+
+大多數自託管 Gitea 實例使用預設的純文字郵件模板。本專案提供了**開箱即用、視覺精美的替代方案**——每種方案都針對特定社群或受眾設計，您可以選擇最適合您使用者的風格。
+
+每個模板都是直接替換。所有 Go 模板變數、翻譯鍵和 Gitea 資料上下文完全相容。**無需修補程式、無需外掛、無需 fork。**
+
+---
+
+## 風格展示
+
+| 預覽 | 風格 | 受眾 | 特點 |
+|---|---|---|---|
+| ![Horizon](images/horizon.png) | **Horizon** | 企業/公司 | 藍色強調色、石板灰排版、居中卡片 |
+| ![Terminal](images/terminal.png) | **Terminal** | 開發者/技術 | 暗色模式、等寬字型、綠色命令列風格 |
+| ![Ember](images/ember.png) | **Ember** | 社群/開源 | 暖琥珀色、圓角、人文主義、包容 |
+| ![Bloom](images/bloom.png) | **Bloom** | 創意/新創 | 磨砂玻璃、柔和藍色光線、虹彩點綴 |
+| ![Heritage](images/heritage.png) | **Heritage** | 教育/研究 | 海軍藍與金色、襯線字型、經典、權威 |
+| ![Neon](images/neon.png) | **Neon** | 遊戲/Web3/創意科技 | 賽博龐克霓虹、粉紅與青色、合成波能量 |
+| ![Mono](images/mono.png) | **Mono** | 設計工作室/編輯 | 瑞士粗野主義、黑白紅強調、零圓角 |
+| ![Terra](images/terra.png) | **Terra** | 永續/健康 | 溫暖大地色調、有機質感、人文襯線 |
+| ![Ink](images/ink.png) | **Ink** | 出版/新聞/文學 | 編輯印刷、深藍與金色、報紙排版 |
+| ![Aurora](images/aurora.png) | **Aurora** | 高端SaaS/正念 | 空靈光效漸變、深紫與青綠、大氣光暈 |
+
+> 圖片為 600px 寬截圖，來自[線上預覽](../preview/index.html)。截圖方法參見 [images/README.md](images/README.md)。
+
+[**線上預覽展示**](../preview/index.html)
+
+---
+
+## 安裝
+
+選擇一種風格，將 `mail/` 目錄複製到 Gitea 自訂模板路徑：
+
+```bash
+cp -r themes/horizon/mail/* /var/lib/gitea/custom/templates/mail/
+systemctl restart gitea
+```
+
+切換風格只需覆蓋檔案，無需更改設定。
+
+---
+
+## 預覽
+
+```bash
+go run ./tools/build-preview.go
+```
+然後開啟 `preview/index.html`。
+
+---
+
+## 相容性
+
+- **Gitea 1.21+**，100% 變數相容，僅使用內建函式和官方翻譯鍵
+
+## 授權
+
+MIT — 詳見 [LICENSE](../LICENSE)。

docs/images/README.md

@@ -0,0 +1,18 @@
+# Style Preview Images
+
+Place 600px-wide PNG screenshots here, captured from the [live preview](../preview/index.html).
+
+## Naming Convention
+
+```
+horizon.png    terminal.png    ember.png    bloom.png    heritage.png
+neon.png       mono.png        terra.png    ink.png      aurora.png
+```
+
+## How to Capture
+
+1. Run `go run ./tools/build-preview.go` from the project root
+2. Open `preview/index.html` in a browser
+3. For each style, select the "Activate Account" template and "Modern" client mode
+4. Take a screenshot of the rendered email (600px width recommended)
+5. Save as `<style-name>.png` in this directory