chore: prepare v1.27.3 release and guard template publishing

.github/release-notes/v1.27.2.md

@@ -0,0 +1,22 @@
+> **Correction (2026-09-23):** v1.27.2 did not fix every push notification template. Bloom, Ember, and Heritage still used the old commit ID path and can fail to render push notifications on Gitea 1.27.1+. Use v1.27.3 for the fix.
+
+FEATURES
+
+- THEMES (Aurora)
+    - Add `email-text` class to release template paragraphs for consistent typography with the rest of the theme
+
+BUGFIXES
+
+- THEMES
+    - Update push commit data paths in seven themes for Gitea 1.27.1 compatibility (`.ID` → `.UserCommit.GitCommit.ID`); see the correction above for the three remaining themes
+    - Replace `rgba()` colors with `#RRGGBBAA` hex notation across all 10 themes
+
+DOCS
+
+- Track Gitea 1.27.0, 1.27.1, and 1.27.2 compatibility
+- Keep English and Simplified Chinese README and CONTRIBUTING files
+
+
+---
+
+**Full Changelog:** [v1.0.1...v1.27.2](https://github.com/KenanZhu/GiteaMailTemplates/compare/v1.0.1...v1.27.2)

.github/release-notes/v1.27.3.md

@@ -0,0 +1,22 @@
+FEATURES
+
+- RELEASE
+    - Include English and Simplified Chinese README and CONTRIBUTING files in the release archives
+    - Use reviewed release notes in the publishing workflow
+
+BUGFIXES
+
+- THEMES (Bloom, Ember, Heritage)
+    - Fix pull request push notification commit links and abbreviated hashes for Gitea 1.27.1–1.27.3 by reading `.UserCommit.GitCommit.ID`
+- CI
+    - Add a push notification regression test covering all 10 themes and run Go tests before packaging a release
+
+DOCS
+
+- Verify compatibility with Gitea 1.27.3; its mail templates, mailer, and locale files are unchanged from 1.27.2
+- Correct the compatibility matrix to distinguish the affected v1.27.2 archive from this fixed release
+
+
+---
+
+**Full Changelog:** [v1.27.2...v1.27.3](https://github.com/KenanZhu/GiteaMailTemplates/compare/v1.27.2...v1.27.3)

.github/workflows/gitea-tracker.yml

@@ -106,14 +106,16 @@ jobs:
             - [ ] Check [Gitea changelog](https://github.com/go-gitea/gitea/blob/main/CHANGELOG.md) for mail template changes
             - [ ] Review diff of official templates: `git diff v${{ steps.version.outputs.current_version }}..v${{ steps.version.outputs.new_version }} -- templates/mail/ services/mailer/`
             - [ ] Run `cd tools && go run . preview all` to confirm templates still render
+            - [ ] Run `cd tools && go test ./...` to verify push-notification data paths
             - [ ] Update status from ⏳ to ✅ (compatible) or ❌ (breaking) in COMPATIBILITY.md
             - [ ] Update the `Mail Template Changes` and `Breaking?` columns with accurate notes
             - [ ] After verification, update `TRACKER:LATEST-VERIFIED` and the English/Chinese `TRACKER:LATEST-TESTED` lines; switch the README badge from pending to tested
 
             ## Semantic tracking
             Once verified, update the tracked Gitea version:
-            - [ ] Keep the top **Template Release** row as `Unreleased` until its fixes are tagged; never label a released archive compatible with unshipped changes
+            - [ ] If templates changed, mark the top **Template Release** row `Unreleased` until the fix is tagged; if no change is needed, retain the verified release tag
             - [ ] Update the README release status and compatibility matrix to distinguish source fixes from published packages
+            - [ ] Write `.github/release-notes/vX.Y.Z.md` before tagging; the release workflow uses this file for the published notes
             - [ ] Tag a new release when shipping template fixes — `git tag vX.Y.Z && git push origin vX.Y.Z` (the release workflow packages automatically)
           labels: compatibility, automated
         env:

.github/workflows/release.yml

@@ -16,6 +16,10 @@ jobs:
         with:
           go-version: '1.21'
 
+      - name: Test — mail template data contexts
+        working-directory: tools
+        run: go test ./...
+
       - name: Lint — render all templates
         working-directory: tools
         run: go run . preview all
@@ -30,20 +34,25 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Verify release notes
+        run: test -s ".github/release-notes/${GITHUB_REF_NAME}.md"
+
       - name: Package themes/
         run: |
           VERSION=${GITHUB_REF#refs/tags/}
           ARCHIVE="gitea-mail-templates-${VERSION}"
-          mkdir -p "dist/${ARCHIVE}"
-          cp -r themes LICENSE README.md COMPATIBILITY.md "dist/${ARCHIVE}/"
+          mkdir -p "dist/${ARCHIVE}/docs"
+          cp -r themes LICENSE README.md CONTRIBUTING.md COMPATIBILITY.md "dist/${ARCHIVE}/"
+          cp docs/README.zh-CN.md docs/CONTRIBUTING.zh-CN.md "dist/${ARCHIVE}/docs/"
           cd dist
           zip -r "${ARCHIVE}.zip" "${ARCHIVE}"
           tar -czf "${ARCHIVE}.tar.gz" "${ARCHIVE}"
 
       - name: Create Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           files: dist/*.zip,dist/*.tar.gz
-          generate_release_notes: true
+          fail_on_unmatched_files: true
+          body_path: .github/release-notes/${{ github.ref_name }}.md
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}