diff --git a/.github/workflows/gitea-tracker.yml b/.github/workflows/gitea-tracker.yml index aa6aea5..eecb16f 100644 --- a/.github/workflows/gitea-tracker.yml +++ b/.github/workflows/gitea-tracker.yml @@ -101,7 +101,7 @@ jobs: if: steps.version.outputs.skip != 'true' run: | NEW="${{ steps.version.outputs.new_version }}" - for f in docs/README.{ja,ko,ru,zh-CN,zh-TW}.md; do + for f in docs/README.zh-CN.md; do sed -i "/TRACKER:LATEST-TESTED/s/Gitea [0-9.]*/Gitea ${NEW}/" "$f" done diff --git a/AGENTS.md b/AGENTS.md index 8b0ec92..26b53cb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,7 +28,7 @@ tools/ # Go CLI tooling (modular, zero dependencies) preview/ # Browser-based live preview index.html # SPA with style/template/client/viewport switching rendered.js # Pre-rendered HTML (generated, committed for clone-and-preview) -docs/ # Multi-language documentation +docs/ # Bilingual documentation (English + Simplified Chinese only) ``` ## Working With Templates diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d6be3ce..bfa4af1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -90,12 +90,10 @@ Any readable commit message in semantic format is welcome. Such as: ## Translations +Only English and Simplified Chinese are maintained: + - English -- [Simplified Chinese](docs/CONTRIBUTING.zh-CN.md) -- [Traditional Chinese](docs/CONTRIBUTING.zh-TW.md) -- [Russian](docs/CONTRIBUTING.ru.md) -- [Japanese](docs/CONTRIBUTING.ja.md) -- [Korean](docs/CONTRIBUTING.ko.md) +- [简体中文](docs/CONTRIBUTING.zh-CN.md) --- diff --git a/README.md b/README.md index 5324a9a..b579163 100644 --- a/README.md +++ b/README.md @@ -135,7 +135,7 @@ gitea-mail-templates/ │ ├── data/ # templates_config.json — single source of truth │ ├── preview/ # Template rendering engine │ └── go.mod -├── docs/ # Multi-language documentation +├── docs/ # Bilingual documentation (English + Simplified Chinese) ├── AGENTS.md # AI agent guidance ├── CONTRIBUTING.md ├── LICENSE @@ -185,17 +185,13 @@ gitea-mail-templates/ ## Documentation - [English](README.md) -- [Simplified Chinese](docs/README.zh-CN.md) -- [Traditional Chinese](docs/README.zh-TW.md) -- [Russian](docs/README.ru.md) -- [Japanese](docs/README.ja.md) -- [Korean](docs/README.ko.md) +- [简体中文](docs/README.zh-CN.md) --- ## Contributing -See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Multi-language versions available in [docs/](docs/). +See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. A Simplified Chinese translation is available in [docs/](docs/). ## License diff --git a/docs/CONTRIBUTING.ja.md b/docs/CONTRIBUTING.ja.md deleted file mode 100644 index 31c7e4f..0000000 --- a/docs/CONTRIBUTING.ja.md +++ /dev/null @@ -1,76 +0,0 @@ -# コントリビューション — Gitea メールテンプレート - -## 参加方法 - -### 新しいスタイルの追加 - -1. ツールでスキャフォールド: `cd tools && go run . create ` — 全11種類のメールタイプ用のプレースホルダ `.tmpl` ファイルを含む完全なディレクトリ構造を作成します -2. `themes//` 内の各 `.tmpl` ファイルを独自デザインで編集 -3. プレビューを再生成: `cd tools && go run . preview all`（ビルドスクリプトが `themes/` 以下の全テーマを自動検出し、テーマセレクターも自動生成されます） -4. スクリーンショット付きで PR を提出（1枚あたり 50 KiB 以下、10–20 KiB 推奨） - -### スタイルガイドライン - -- 各スタイルに **全11種類のテンプレート** を含める -- Gitea 組み込み関数のみ使用 -- 翻訳キーは Gitea 公式ロケール (`mail.*`) から -- **`.DisplayName` を使用しない** (collaborator, transfer, release, workflow_run, assigned, default) -- 600px 幅のメールクライアント向けにデザイン -- Gmail, Outlook, Apple Mail でテスト - -### バグレポート - -1. Go 変数が正しいか確認 -2. 翻訳キーが Gitea ロケールと一致するか確認 -3. `.DisplayName` が誤用されていないか確認 -4. プレビューを再生成: `cd tools && go run . preview all` -5. スタイル名とメールタイプを明記して issue を作成 - ---- - -## 開発セットアップ - -- **Go 1.21+** テンプレートレンダリングとCLI用 - -### ローカルプレビュー（静的） - -1. データを生成: `cd tools && go run . preview all` -2. `preview/index.html` をブラウザで開く - - -### 開発サーバー（ライブリロード） - -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - -`.tmpl` ファイルを編集すると自動的に再構築されブラウザに反映されます。 - - -### 結合テスト - -Gitea にデプロイ後、実際のトランザクションメールで検証してください。管理画面のテストメール -（**Site Administration > Configuration > Mailer > Send Test Email**）はカスタム -メールテンプレートを使用しません——組み込みのコードパスを通ります。 - -最も確実な方法は実際の通知をトリガーすることです。例えば、パスワードリセットフロー： - -1. ログアウトし、ログインページで **"Forgot password"** をクリック -2. アカウントのメールアドレスを入力して送信 -3. パスワードリセットメールを確認——カスタムメールテンプレートでレンダリングされます - ---- - -## コミット規約 - -- `style():` — スタイルのテンプレート変更 -- `preview:` — プレビューツールの変更 -- `tools:` — Go ビルドスクリプトの変更 -- `docs:` — ドキュメントと翻訳 -- `fix:` — バグ修正 -- `project:` — README, LICENSE, メタファイル - -## ライセンス - -貢献により、MIT ライセンスに同意したものとみなします。 diff --git a/docs/CONTRIBUTING.ko.md b/docs/CONTRIBUTING.ko.md deleted file mode 100644 index 57fe9c4..0000000 --- a/docs/CONTRIBUTING.ko.md +++ /dev/null @@ -1,49 +0,0 @@ -# 기여 가이드 — Gitea 메일 템플릿 - -## 기여 방법 - -### 새 스타일 추가하기 - -1. 도구로 스캐폴드: `cd tools && go run . create ` — 11개 이메일 유형 모두에 대한 플레이스홀더 `.tmpl` 파일이 포함된 완전한 디렉토리 구조를 생성합니다 -2. `themes//`에서 각 `.tmpl` 파일을 고유한 디자인으로 편집 -3. 프리뷰 재생성: `cd tools && go run . preview all` (빌드 스크립트가 `themes/` 아래의 모든 테마 디렉토리를 자동으로 찾고 테마 선택기도 자동 생성합니다) -4. 스크린샷과 함께 PR 제출 (이미지당 50 KiB 이하, 10–20 KiB 권장) - -### 스타일 가이드라인 - -- 각 스타일에 **11개 템플릿 유형 모두** 포함 -- Gitea 내장 함수만 사용 -- 번역 키는 Gitea 공식 로케일 (`mail.*`) 사용 -- **`.DisplayName` 사용 금지** (collaborator, transfer, release, workflow_run, assigned, default) -- 600px 너비의 이메일 클라이언트에 맞게 디자인 -- Gmail, Outlook, Apple Mail에서 테스트 - -### 버그 리포트 - -1. Go 변수가 올바른지 확인 -2. 번역 키가 Gitea 로케일과 일치하는지 확인 -3. `.DisplayName`이 오용되지 않았는지 확인 -4. 프리뷰 재생성: `cd tools && go run . preview all` -5. 스타일 이름과 메일 유형을 명시하여 이슈 생성 - ---- - -## 개발 설정 - -- **Go 1.21+** 템플릿 렌더링 및 CLI 도구 - -### 로컬 프리뷰 (정적) - -1. 데이터 생성: `cd tools && go run . preview all` -2. `preview/index.html`을 브라우저에서 열기 - - -### 개발 서버 (실시간 리로드) - -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - -`.tmpl` 파일 수정 시 자동 재빌드되어 브라우저에 반영됩니다. - diff --git a/docs/CONTRIBUTING.ru.md b/docs/CONTRIBUTING.ru.md deleted file mode 100644 index cf248b2..0000000 --- a/docs/CONTRIBUTING.ru.md +++ /dev/null @@ -1,77 +0,0 @@ -# Участие в разработке — Gitea Mail Templates - -## Способы участия - -### Добавление нового стиля - -1. Создайте каркас через инструмент: `cd tools && go run . create <имя-стиля>` — создаёт полную структуру директорий с файлами-заготовками `.tmpl` для всех 11 типов писем -2. Отредактируйте каждый `.tmpl` файл в `themes/<имя-стиля>/` с вашим уникальным дизайном -3. Перегенерируйте превью: `cd tools && go run . preview all` (скрипт автоматически находит все темы в `themes/` и динамически генерирует селектор тем) -4. Отправьте PR со скриншотами (≤ 50 КиБ каждый, рекомендуется 10–20 КиБ) - -### Рекомендации по стилю - -- Каждый стиль должен включать **все 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. Перегенерируйте превью: `cd tools && go run . preview all` -5. Создайте issue с указанием стиля и типа письма - ---- - -## Настройка разработки - -- **Go 1.21+** для рендеринга шаблонов и CLI - -### Локальный предпросмотр (статический) - -1. Сгенерируйте данные: `cd tools && go run . preview all` -2. Откройте `preview/index.html` в браузере — сервер не нужен - - -### Сервер разработки (live reload) - -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - -При изменении `.tmpl` файлов автоматически пересобирает и обновляет браузер. - - -### Интеграционное тестирование - -Разверните шаблоны на Gitea и проверяйте с реальными транзакционными письмами. -Тестовое письмо администратора (**Site Administration > Configuration > Mailer > -Send Test Email**) не использует пользовательские шаблоны — оно идет по -встроенному пути. - -Самый надежный способ — вызвать реальное уведомление. Например, сброс пароля: - -1. Выйдите из системы и нажмите **"Forgot password"** на странице входа -2. Введите email вашей учетной записи и отправьте -3. Проверьте письмо для сброса пароля — оно будет отрендерено с вашими шаблонами - ---- - -## Соглашение о коммитах - -- `style(<имя>):` — изменения шаблонов стиля -- `preview:` — инструменты предпросмотра -- `tools:` — Go-скрипт сборки -- `docs:` — документация и переводы -- `fix:` — исправления -- `project:` — README, LICENSE, мета-файлы - -## Лицензия - -Участвуя, вы соглашаетесь с лицензией MIT. diff --git a/docs/CONTRIBUTING.zh-TW.md b/docs/CONTRIBUTING.zh-TW.md deleted file mode 100644 index 10197f8..0000000 --- a/docs/CONTRIBUTING.zh-TW.md +++ /dev/null @@ -1,80 +0,0 @@ -# 貢獻指南 — Gitea 郵件模板 - -## 參與方式 - -### 新增風格 - -1. 使用工具腳手架：`cd tools && go run . create <風格名稱>` — 這會建立完整的目錄結構和全部 11 種郵件類型的佔位 `.tmpl` 檔案 -2. 在 `themes/<風格名稱>/` 中編寫每個 `.tmpl` 檔案，套用獨特的視覺設計 -3. 重新產生預覽：`cd tools && go run . preview all`（建置腳本會自動發現 `themes/` 下的所有主題目錄並動態生成主題選擇器） -4. 提交包含螢幕截圖的 PR（單張圖片 ≤ 50 KiB，建議 10–20 KiB） - -### 風格指南 - -- 每個風格必須包含全部 **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. 重新產生預覽：`cd tools && go run . preview all` -5. 提交 issue，註明風格名稱、郵件類型及錯誤描述 - -### 改善文件 - -文件改進、預覽螢幕截圖、安裝指南和翻譯始終歡迎。 - ---- - -## 開發環境 - -- **Go 1.21+** 用於模板渲染與 CLI 工具 - -### 本機預覽（靜態） - -1. 先生成預覽資料：`cd tools && go run . preview all` -2. 在瀏覽器中開啟 `preview/index.html` — 無需伺服器 - - -### 開發伺服器（即時重載） - -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - -修改 `.tmpl` 檔案後自動重建並推送至瀏覽器。 - - -### 整合測試 - -將模板部署至 Gitea 實例後，請透過真實的郵件通知進行驗證。管理後台的測試郵件 -（**Site Administration > Configuration > Mailer > Send Test Email**）不會使用 -自訂郵件模板——它走的是內置程式碼路徑。 - -最可靠的驗證方式是觸發一次真實的郵件通知，推薦使用密碼重設流程： - -1. 登出帳號，點擊登入頁的**"忘記密碼"** -2. 輸入帳戶郵箱並提交 -3. 查看密碼重設郵件——它將使用你的自訂郵件模板渲染 - ---- - -## 提交規範 - -- `style(<名稱>):` — 特定風格的模板變更 -- `preview:` — 預覽工具變更 -- `tools:` — Go 建置腳本變更 -- `docs:` — 文件與翻譯 -- `fix:` — Bug 修復 -- `project:` — README、LICENSE、中繼資料檔案 - -## 授權條款 - -參與貢獻即表示您同意將您的貢獻以 MIT 授權條款授權。 diff --git a/docs/README.ja.md b/docs/README.ja.md deleted file mode 100644 index 7a08d73..0000000 --- a/docs/README.ja.md +++ /dev/null @@ -1,66 +0,0 @@ -# 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 -``` - -### 動作確認 - -管理画面のテストメールはカスタムテンプレートを使用しません。テンプレートが -有効であることを確認するには、実際のメール通知をトリガーしてください。最も -簡単な方法はパスワードリセットです：ログアウトし、ログインページで -**"Forgot password"** をクリックし、リセットメールを確認してください。 - -## プレビュー - -**静的モード:** -```bash -cd tools && go run . preview all -``` -その後 `preview/index.html` を開く。 - -**開発サーバー（ライブリロード）:** -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - -## 互換性 - -- **Gitea 1.25+** — v1.25で導入されたメールテンプレートディレクトリ構造 -- **最新テスト:** Gitea 1.27.1 -- Gitea公式テンプレートと100%互換 — 詳細は [COMPATIBILITY.md](COMPATIBILITY.md)を参照 - -## ライセンス - -MIT — [LICENSE](../LICENSE). diff --git a/docs/README.ko.md b/docs/README.ko.md deleted file mode 100644 index 9712cd4..0000000 --- a/docs/README.ko.md +++ /dev/null @@ -1,66 +0,0 @@ -# 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 -``` - -### 작동 확인 - -관리자 테스트 이메일은 커스텀 템플릿을 사용하지 않습니다. 템플릿이 활성화 -되었는지 확인하려면 실제 이메일 알림을 트리거하세요. 가장 빠른 방법은 비밀번호 -재설정입니다: 로그아웃 후 로그인 페이지에서 **"Forgot password"** 를 클릭하고 -재설정 이메일을 확인하세요. - -## 프리뷰 - -**정적 모드:** -```bash -cd tools && go run . preview all -``` -그런 다음 `preview/index.html` 열기. - -**개발 서버 (실시간 리로드):** -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - -## 호환성 - -- **Gitea 1.25+** — v1.25에서 도입된 메일 템플릿 디렉토리 구조 사용 -- **최신 테스트:** Gitea 1.27.1 -- Gitea 공식 템플릿과 100% 호환 — 자세한 내용은 [COMPATIBILITY.md](../COMPATIBILITY.md) 참조 - -## 라이선스 - -MIT — [LICENSE](../LICENSE). diff --git a/docs/README.ru.md b/docs/README.ru.md deleted file mode 100644 index 4b040d5..0000000 --- a/docs/README.ru.md +++ /dev/null @@ -1,66 +0,0 @@ -# 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 -``` - -### Проверка работы - -Тестовое письмо администратора не использует пользовательские шаблоны. Чтобы -убедиться, что шаблоны активны, вызовите реальное уведомление. Самый быстрый -способ — сброс пароля: выйдите из системы, нажмите **"Forgot password"** на -странице входа и проверьте письмо для сброса. - -## Предпросмотр - -**Статический режим:** -```bash -cd tools && go run . preview all -``` -Затем откройте `preview/index.html`. - -**Dev-сервер (live reload):** -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - -## Совместимость - -- **Gitea 1.25+** — структура директорий из v1.25 -- **Последняя проверка:** Gitea 1.27.1 -- 100% совместимость с официальными шаблонами Gitea — см. [COMPATIBILITY.md](COMPATIBILITY.md) - -## Лицензия - -MIT — [LICENSE](../LICENSE). diff --git a/docs/README.zh-TW.md b/docs/README.zh-TW.md deleted file mode 100644 index 664b984..0000000 --- a/docs/README.zh-TW.md +++ /dev/null @@ -1,82 +0,0 @@ -# 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 -cd tools && go run . preview all -``` -然後開啟 `preview/index.html`。 - -**開發伺服器（即時重載）：** -```bash -cd tools && go run . dev -# → http://localhost:3456 -``` - - ---- - -## 相容性 - -- **Gitea 1.25+** — v1.25 引入的郵件模板目錄結構 -- **最新測試：** Gitea 1.27.1 -- 與 Gitea 官方模板 100% 相容 — 詳見 [COMPATIBILITY.md](COMPATIBILITY.md) - -## 授權 - -MIT — 詳見 [LICENSE](../LICENSE)。