KenanZhuandClaude Opus 4.8
0bf982ffb9
- 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>
1.9 KiB
1.9 KiB
기여 가이드 — Gitea 메일 템플릿
기여 방법
새 스타일 추가하기
- 도구로 스캐폴드:
cd tools && go run . create <style-name>— 11개 이메일 유형 모두에 대한 플레이스홀더.tmpl파일이 포함된 완전한 디렉토리 구조를 생성합니다 themes/<style-name>/에서 각.tmpl파일을 고유한 디자인으로 편집- 프리뷰 재생성:
cd tools && go run . preview all(빌드 스크립트가themes/아래의 모든 테마 디렉토리를 자동으로 찾고 테마 선택기도 자동 생성합니다) - 스크린샷과 함께 PR 제출
스타일 가이드라인
- 각 스타일에 11개 템플릿 유형 모두 포함
- Gitea 내장 함수만 사용
- 번역 키는 Gitea 공식 로케일 (
mail.*) 사용 .DisplayName사용 금지 (collaborator, transfer, release, workflow_run, assigned, default)- 600px 너비의 이메일 클라이언트에 맞게 디자인
- Gmail, Outlook, Apple Mail에서 테스트
버그 리포트
- Go 변수가 올바른지 확인
- 번역 키가 Gitea 로케일과 일치하는지 확인
.DisplayName이 오용되지 않았는지 확인- 프리뷰 재생성:
cd tools && go run . preview all - 스타일 이름과 메일 유형을 명시하여 이슈 생성
개발 설정
로컬 프리뷰
- 데이터 생성:
cd tools && go run . preview all preview/index.html을 브라우저에서 열기- Modern, Gmail, Outlook, Raw source 모드 전환 확인
통합 테스트
Gitea에 배포: Site Administration > Configuration > Mailer > Send Test Email
커밋 규칙
style(<name>):— 스타일 템플릿 변경preview:— 프리뷰 도구 변경tools:— Go 빌드 스크립트 변경docs:— 문서 및 번역fix:— 버그 수정project:— README, LICENSE, 메타 파일
라이선스
기여함으로써 MIT 라이선스에 동의하게 됩니다.