Files
GiteaMailTemplates/docs/CONTRIBUTING.ko.md
T
KenanZhuandClaude 0ad7db124a refactor(preview): remove juice/Node.js, simplify to pure Go dev server with SSE
- Delete tools/server/ (Node.js, juice, inliner.mjs, server.mjs, node_modules)
- Create tools/preview/server.go — pure Go dev server with SSE + file polling
- Rewrite tools/cli/dev.go — start Go server in-process, no Node.js required
- Simplify preview/index.html — View dropdown (Modern/Source), remove Client
  Simulation panel, remove Gmail/Outlook logic, WebSocket → SSE
- Update all 14 documentation files (README, CONTRIBUTING, AGENTS + translations)
  to reflect pure Go dev server and simplified preview

Co-Authored-By: Claude <noreply@anthropic.com>
2026-06-23 09:48:04 +08:00

1.7 KiB
Raw Blame History

기여 가이드 — Gitea 메일 템플릿

기여 방법

새 스타일 추가하기

  1. 도구로 스캐폴드: cd tools && go run . create <style-name> — 11개 이메일 유형 모두에 대한 플레이스홀더 .tmpl 파일이 포함된 완전한 디렉토리 구조를 생성합니다
  2. themes/<style-name>/에서 각 .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을 브라우저에서 열기

개발 서버 (실시간 리로드)

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

.tmpl 파일 수정 시 자동 재빌드되어 브라우저에 반영됩니다.