chore: refresh docs and adapt workflows for Gitea

2026-10-09 22:02:33 +08:00
1 parent fec3ace600
commit f4d96de79e
@@ -1,22 +1,16 @@
-> **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.
+# v1.27.2

-FEATURES
+> **Correction (2026-09-23):** The push-notification fix in this release is incomplete. Bloom, Ember and Heritage still use the old commit ID path and can fail to render push notifications on Gitea 1.27.1+. Use v1.27.3 for the complete fix; see the [compatibility matrix](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/src/branch/main/COMPATIBILITY.md#compatibility-matrix).

- THEMES (Aurora)
-    - Add `email-text` class to release template paragraphs for consistent typography with the rest of the theme
+## Changes

-BUGFIXES
+- Add the `email-text` class to Aurora release paragraphs for consistent typography.
+- Update push commit paths in seven themes for Gitea 1.27.1 compatibility (`.ID` → `.UserCommit.GitCommit.ID`). The three remaining themes are covered by the correction above.
+- Replace `rgba()` colors with `#RRGGBBAA` notation across all ten themes.

- 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
+## Documentation

-DOCS
+- Record compatibility for Gitea 1.27.0, 1.27.1 and 1.27.2.
+- Maintain English and Simplified Chinese README and contributor guides.

- 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://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/compare/v1.0.1...v1.27.2)
+[Full changelog: v1.0.1…v1.27.2](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/compare/v1.0.1...v1.27.2)
@@ -1,22 +1,20 @@
-FEATURES
+# v1.27.3

- RELEASE
-    - Include English and Simplified Chinese README and CONTRIBUTING files in the release archives
-    - Use reviewed release notes in the publishing workflow
+This release completes the push-notification fix for Gitea 1.27.1–1.27.3. See the [compatibility matrix](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/src/branch/main/COMPATIBILITY.md#compatibility-matrix) for recommended release combinations.

-BUGFIXES
+## Fixes

- 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
+- Fix pull request push-notification links and abbreviated hashes in Bloom, Ember and Heritage by reading `.UserCommit.GitCommit.ID`.
+- Add a push-notification regression test covering all ten themes and run Go tests before packaging.

-DOCS
+## Packaging

- 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
+- Include English and Simplified Chinese README and contributor guides in release archives.
+- Use reviewed release notes in the publishing workflow.

+## Documentation

---
+- Record compatibility with Gitea 1.27.3, whose mail templates, mailer and locale files are unchanged from 1.27.2.
+- Distinguish the affected v1.27.2 archive from the complete fix in this release.

-**Full Changelog:** [v1.27.2...v1.27.3](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/compare/v1.27.2...v1.27.3)
+[Full changelog: v1.27.2…v1.27.3](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/compare/v1.27.2...v1.27.3)
@@ -1,21 +1,18 @@
-FEATURES
+# v28.0.0

- COMPATIBILITY
-    - Add a Gitea 28.0.0-aligned release of all 10 themes and 11 mail types per theme
+This release targets Gitea 28.0.0 and includes ten themes with eleven mail types each. For earlier Gitea versions, use the packages listed in the [compatibility matrix](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/src/branch/main/COMPATIBILITY.md#compatibility-matrix).

-BUGFIXES
+## Fixes

- THEMES (All 10)
-    - Replace the removed `FileSize` function with `FormatByteSize` in release-attachment emails, preventing Gitea 28.0.0 template rendering errors
- PREVIEW AND TESTS
-    - Match the preview's file-size function to Gitea 28.0.0 and render release attachments in the example data
-    - Add an all-theme regression test for release attachments and the removed function
+- Replace the removed `FileSize` function with `FormatByteSize` in release-attachment emails across all ten themes.
+- Update the preview's file-size function for Gitea 28.0.0 and include release attachments in the example data.
+- Add an all-theme regression test for release attachments and the removed function.

-DOCS
+## Documentation

- Update the English and Simplified Chinese READMEs and compatibility matrix for Gitea 28.0.0
- Clarify that v28.0.0 requires Gitea 28.0.0; use v1.27.3 for Gitea 1.25.0–1.27.3
+- Update both READMEs and the compatibility matrix for Gitea 28.0.0.
+- Document the Gitea 28.0.0 requirement and direct users of earlier versions to the compatibility matrix.

---
+The snapshot-based source architecture now on `main` is separate, unreleased work. It is not included in the existing v28.0.0 archives.

-**Full Changelog:** [v1.27.3...v28.0.0](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/compare/v1.27.3...v28.0.0)
+[Full changelog: v1.27.3…v28.0.0](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/compare/v1.27.3...v28.0.0)