1 Fork 0

Files

T

KenanZhuandClaude Opus 4.8 7724b4806c docs: update all docs with dev server, live reload, Juice inlining

- README.md: restructure Preview section into Static + Dev modes
  with feature comparison table; mention juice inlining and live reload
- CONTRIBUTING.md: update Development Setup with Go/Node.js
  requirements, static vs dev preview workflows, Juice reference
- AGENTS.md: add dev command to subcommand list, document
  tools/server/ directory, update Build Tool section
- docs/CONTRIBUTING.*.md (5 languages): add dev server section,
  Node.js requirement, live reload description
- docs/README.*.md (5 languages): add dev mode to Preview section
- docs/images/README.md: update capture instructions for dev server

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

2026-06-04 13:58:15 +08:00

3.4 KiB

Raw Blame History

Участие в разработке — Gitea Mail Templates

Способы участия

Добавление нового стиля

Создайте каркас через инструмент: cd tools && go run . create <имя-стиля> — создаёт полную структуру директорий с файлами-заготовками .tmpl для всех 11 типов писем
Отредактируйте каждый .tmpl файл в themes/<имя-стиля>/ с вашим уникальным дизайном
Перегенерируйте превью: cd tools && go run . preview all (скрипт автоматически находит все темы в themes/ и динамически генерирует селектор тем)
Отправьте PR со скриншотами

Баг-репорты

Проверьте переменные Go в шаблонах
Сверьте ключи перевода с локалью Gitea
Убедитесь что .DisplayName не используется где не надо
Перегенерируйте превью: cd tools && go run . preview all
Создайте issue с указанием стиля и типа письма

Настройка разработки

Go 1.21+ для рендеринга шаблонов и CLI
Node.js 18+ (опционально) для сервера разработки с Juice CSS

Локальный предпросмотр (статический)

Сгенерируйте данные: cd tools && go run . preview all
Откройте preview/index.html в браузере — сервер не нужен

Статическая симуляция Gmail/Outlook приблизительна. Используйте dev-режим для точного рендеринга.

Сервер разработки (live reload + CSS инлайн)

cd tools && go run . dev
# → http://localhost:3456

При изменении .tmpl файлов автоматически пересобирает и обновляет браузер.

Интеграционное тестирование

Разверните на Gitea: Site Administration > Configuration > Mailer > Send Test Email

Соглашение о коммитах

style(<имя>): — изменения шаблонов стиля
preview: — инструменты предпросмотра
tools: — Go-скрипт сборки
docs: — документация и переводы
fix: — исправления
project: — README, LICENSE, мета-файлы

Лицензия

Участвуя, вы соглашаетесь с лицензией MIT.

3.4 KiB Raw Blame History