chore: sync Gitea 28.3.0 inputs and compatibility docs
Validate / Validate (push) Successful in 3m44s
Validate / Validate (push) Successful in 3m44s
This commit is contained in:
KenanZhu committed
1 parent
16b3141e09
commit
e6925fb721
8 files changed
+36
-38
No files matched your search
@@ -13,7 +13,8 @@
|
||||
|
||||
| Gitea 版本 | 推荐模板版本 | 状态 | 说明 |
|
||||
|---|---|---|---|
|
||||
| 28.2.0 | [**v28.1.0**](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/tag/v28.1.0) | [PASS] | 邮件模板、模板函数注册及邮件翻译键与 28.1.0 一致 |
|
||||
| 28.3.0 | [**v28.1.0**](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/tag/v28.1.0) | [PASS] | 官方修复邮件外部间距；本项目主题自行设置间距，不受影响 |
|
||||
| 28.2.0 | [**v28.1.0**](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/tag/v28.1.0) | [PASS] | - |
|
||||
| 28.1.0 | [**v28.1.0**](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/tag/v28.1.0) | [PASS] | - |
|
||||
| 28.0.0 | [**v28.1.0**](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/tag/v28.1.0) | [PASS] | Gitea 将邮件函数 `FileSize` 替换为 `FormatByteSize` |
|
||||
| 1.27.3 | [**v1.27.3**](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/tag/v1.27.3) | [PASS] | 全部主题已修复拉取请求推送通知的提交链接 |
|
||||
@@ -37,28 +38,26 @@
|
||||
|
||||
| Gitea | 发布日期 | 邮件模板变化 | 影响 |
|
||||
|---|---|---|---|
|
||||
| **28.2.0** | 2026-10-18 | 无模板接口变更 | 自定义关注的通知收件规则及入站回复令牌校验调整，不影响现有模板 |
|
||||
| **28.3.0** | 2026-11-01 | 修复通知邮件外部间距丢失问题 （[PR #40104](https://github.com/go-gitea/gitea/pull/40104)）（[PR #40111](https://github.com/go-gitea/gitea/pull/40111)） | 无 |
|
||||
| **28.2.0** | 2026-10-18 | 自定义关注的通知收件规则及入站回复令牌校验调整，不影响现有模板 | 无 |
|
||||
| **28.1.0** | 2026-10-06 | 无 | 无 |
|
||||
| **28.0.0** | 2026-09-29 | 邮件函数 `FileSize` 改为 `FormatByteSize` （[PR](https://github.com/go-gitea/gitea/pull/39083)） | **不兼容变更：** 旧的发布附件模板失效 |
|
||||
|||引入 templates/mail/base/ （[PR](https://github.com/go-gitea/gitea/pull/38396)）| **不兼容变更：** 旧版本 Gitea 无法直接使用新版本邮件模板 |
|
||||
| **28.0.0** | 2026-09-29 | 邮件函数 `FileSize` 改为 `FormatByteSize` （[PR #39083](https://github.com/go-gitea/gitea/pull/39083)） | **不兼容变更：** 旧的发布附件模板失效 |
|
||||
|||引入 templates/mail/base/ （[PR #38396](https://github.com/go-gitea/gitea/pull/38396)）| **不兼容变更：** 旧版本 Gitea 无法直接使用新版本邮件模板 |
|
||||
| **1.27.3** | 2026-08-29 | 无 | 无 |
|
||||
| **1.27.2** | 2026-08-14 | 无 | 无 |
|
||||
| **1.27.1** | 2026-07-27 | 内置推送模板改用 `.UserCommit.GitCommit`（[PR](https://github.com/go-gitea/gitea/pull/38467)） | **不兼容变更：存在既有未修复缺陷** 旧的自定义拉取请求推送模板可能失效 |
|
||||
| **1.27.0** | 2026-07-13 | 推送提交数据移至 `.UserCommit.GitCommit`（[ISSUE](https://github.com/go-gitea/gitea/issues/38469)） | **不兼容变更：** 旧的拉取请求推送模板失效 |
|
||||
| **1.27.1** | 2026-07-27 | 内置推送模板改用 `.UserCommit.GitCommit`（[PR #38467](https://github.com/go-gitea/gitea/pull/38467)） | **不兼容变更：存在既有未修复缺陷** 旧的自定义拉取请求推送模板可能失效 |
|
||||
| **1.27.0** | 2026-07-13 | 推送提交数据移至 `.UserCommit.GitCommit`（[ISSUE #38469](https://github.com/go-gitea/gitea/issues/38469)） | **不兼容变更：** 旧的拉取请求推送模板失效 |
|
||||
| **1.26.4** | 2026-06-21 | 无 | 无 |
|
||||
| **1.26.3** | 2026-06-20 | 无 | 无 |
|
||||
| **1.26.2** | 2026-05-20 | 无 | 无 |
|
||||
| **1.26.1** | 2026-04-22 | 无 | 无 |
|
||||
| **1.26.0** | 2026-04-19 | 无 | 无 |
|
||||
| **1.25.5** | 2026-03-10 | 无 | 无 |
|
||||
| **1.25.0** | 2025 | 自定义邮件路径及主题和正文格式变化（[PR](https://github.com/go-gitea/gitea/pull/35150)） | **不兼容变更：** 不支持更早的模板布局 |
|
||||
| **1.25.0** | 2025 | 自定义邮件路径及主题和正文格式变化（[PR #35150](https://github.com/go-gitea/gitea/pull/35150)） | **不兼容变更：** 不支持更早的模板布局 |
|
||||
| **≤ 1.24.x** | — | 旧的自定义邮件布局 | [UNSUPPORTED] |
|
||||
|
||||
## 模板变量参考
|
||||
|
||||
> [!NOTE]
|
||||
> 已对照 [Gitea 28.1.0 与 28.2.0 的源码差异](https://github.com/go-gitea/gitea/compare/v28.1.0...v28.2.0)检查邮件模板、上下文构造、模板函数和翻译键。28.2.0 调整了[自定义关注的邮件通知规则](https://github.com/go-gitea/gitea/pull/39837)和[入站邮件令牌校验](https://github.com/go-gitea/gitea/pull/39841)，未改变现有邮件模板所需的变量、函数或翻译键。源码构建输入锁定为 v28.2.0，已发布的 v28.1.0 模板仍可使用。
|
||||
|
||||
各类邮件上下文由官方模板定义。开发时具体的邮件模板和函数和变量请参考官方邮件模板文档 [1](#注释)。
|
||||
|
||||
## 翻译键
|
||||
|
||||
@@ -69,10 +69,10 @@ go run . upstream verify --root "C:\Projects\GiteaMailTemplates"
|
||||
|
||||
#### 更新官方版本
|
||||
|
||||
只有需要评审新的官方版本时才使用 `sync`。例如，明确同步到 `v28.2.0`：
|
||||
只有需要评审新的官方版本时才使用 `sync`。例如，明确同步到 `v28.3.0`：
|
||||
|
||||
```bash
|
||||
go run . upstream sync --tag v28.2.0
|
||||
go run . upstream sync --tag v28.3.0
|
||||
go run . upstream verify
|
||||
go test ./...
|
||||
go run . preview all
|
||||
@@ -347,7 +347,7 @@ python -B -m unittest discover -s .github/scripts -p 'test_*.py'
|
||||
发行标签必须与锁定的 Gitea 标签一致。版本标记、徽章和兼容性记录由维护者手动更新；修改官方输入不会自动触发版本维护。历史发行附件应保留，文档和兼容性记录应在打标签前检查。完成验证并生成全部预览后，可在仓库根目录手动打包：
|
||||
|
||||
```bash
|
||||
python .github/scripts/package_release.py --version v28.2.0 --output build/release-review
|
||||
python .github/scripts/package_release.py --version v28.3.0 --output build/release-review
|
||||
```
|
||||
|
||||
将示例版本替换为根锁文件中的标签，并使用没有同名发行压缩包的输出目录。脚本检查源码与产物的校验值，打包主题、预览、文档、官方许可证和来源信息，排除残留的旧主题构建。
|
||||
|
||||
@@ -126,11 +126,11 @@ cd ..
|
||||
|
||||
## 兼容性
|
||||
|
||||
- **最新测试：** Gitea 28.2.0
|
||||
- **源码构建基线：** Gitea 28.2.0
|
||||
- **最新测试：** Gitea 28.3.0
|
||||
- **源码构建基线：** Gitea 28.3.0
|
||||
- **最新发布版：** [v28.1.0](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/latest)
|
||||
|
||||
Gitea 28.2.0 未引入邮件模板接口变更，已发布的 v28.1.0 模板仍兼容；源码构建使用锁定的 v28.2.0 官方输入，详见[兼容性记录](COMPATIBILITY.zh-CN.md)。
|
||||
Gitea 28.3.0 未引入邮件模板接口变更，已发布的 v28.1.0 模板仍兼容；源码构建使用锁定的 v28.3.0 官方输入，详见[兼容性记录](COMPATIBILITY.zh-CN.md)。
|
||||
|
||||
## 项目目录结构
|
||||
|
||||
|
||||
Reference in new issue
Block a user