refactor(tools): modularize CLI with urfave/cli/v2, externalise template metadata
- Split monolithic build-preview.go into modular packages: tools.go (entry), cli/ (list/create/delete/preview commands), config/ (JSON loading), preview/ (rendering engine, funcs, locale) - Extract all template metadata into data/templates_config.json as single source of truth — no hardcoded template data in Go - Replace hand-rolled CLI parsing with github.com/urfave/cli/v2 - Add sensible defaults for --folder (../themes) and --config (./data/templates_config.json) — most commands now run bare - Add type-coercing gt/lt/ge/le template funcs for JSON float64 - Fix AppUrl to gitea.com matching official template convention - rendered.js now exports __REGISTRY__ and __PARAMS__ alongside __RENDERED__ — preview/index.html reads all from single source - Cross-validate all 11 template data contexts against official Gitea source (services/mailer/*.go + templates/mail/*.tmpl) - Update all docs (README, AGENTS, CONTRIBUTING, 5 languages) to reflect new CLI workflow with create scaffolding command Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
1 parent
77854ee0ed
commit
0bf982ffb9
30 files changed
+1274
-540
No files matched your search
@@ -4,12 +4,10 @@
|
||||
|
||||
### Добавление нового стиля
|
||||
|
||||
1. Создайте директорию стиля: `themes/<имя-стиля>/`
|
||||
2. Скопируйте структуру из существующего стиля
|
||||
3. Реализуйте все 11 `.tmpl` файлов с уникальным дизайном
|
||||
4. Перегенерируйте превью: `go run ./tools/build-preview.go` (скрипт автоматически находит все темы в `themes/`)
|
||||
5. Добавьте тему в `<select id="sel-theme">` в `preview/index.html`
|
||||
6. Отправьте PR со скриншотами
|
||||
1. Создайте каркас через инструмент: `cd tools && go run . create <имя-стиля>` — создаёт полную структуру директорий с файлами-заготовками `.tmpl` для всех 11 типов писем
|
||||
2. Отредактируйте каждый `.tmpl` файл в `themes/<имя-стиля>/` с вашим уникальным дизайном
|
||||
3. Перегенерируйте превью: `cd tools && go run . preview all` (скрипт автоматически находит все темы в `themes/` и динамически генерирует селектор тем)
|
||||
4. Отправьте PR со скриншотами
|
||||
|
||||
### Рекомендации по стилю
|
||||
|
||||
@@ -25,7 +23,7 @@
|
||||
1. Проверьте переменные Go в шаблонах
|
||||
2. Сверьте ключи перевода с локалью Gitea
|
||||
3. Убедитесь что `.DisplayName` не используется где не надо
|
||||
4. Перегенерируйте превью: `go run ./tools/build-preview.go`
|
||||
4. Перегенерируйте превью: `cd tools && go run . preview all`
|
||||
5. Создайте issue с указанием стиля и типа письма
|
||||
|
||||
---
|
||||
@@ -34,7 +32,7 @@
|
||||
|
||||
### Локальный предпросмотр
|
||||
|
||||
1. Сгенерируйте данные: `go run ./tools/build-preview.go`
|
||||
1. Сгенерируйте данные: `cd tools && go run . preview all`
|
||||
2. Откройте `preview/index.html` в браузере
|
||||
3. Переключайте Modern, Gmail, Outlook, Raw source для проверки
|
||||
|
||||
|
||||
Reference in new issue
Block a user