3.7 KiB
3.7 KiB
Gitea 兼容性
此文件描述了 Gitea Mail Templates 与 Gitea 不同版本之间的兼容性。
兼容性表
根据所运行的 Gitea 版本选择对应推荐的模板版本。[PASS] 表示已记录为兼容的组合，[PENDING] 表示尚未完成验证。
Note
历史条目仅反映项目已有的兼容性评估，不代表每次发布都重新测试了每一个补丁版本。
| Gitea 版本 | 推荐模板版本 | 状态 | 说明 |
|---|---|---|---|
| 28.1.0 | — | [PENDING] | 等待兼容性验证 |
| 28.0.0 | v28.0.0 | [PASS] | Gitea 将邮件函数 FileSize 替换为 FormatByteSize |
| 1.27.3 | v1.27.3 | [PASS] | 全部主题已修复拉取请求推送通知的提交链接 |
| 1.27.2 | v1.27.3 | [PASS] | 同号 v1.27.2 模板的 Bloom、Ember、Heritage 存在推送通知缺陷 |
| 1.27.1 | v1.27.3 | [PASS] | 较早 v1.0.x 模板使用过时的推送提交字段 |
| 1.27.0 | — | [PENDING] | Gitea 使用了新的提交数据结构；v1.27.3 可能适用，但未在此版本上验证 |
| 1.26.4 | v1.0.1 | [PASS] | — |
| 1.26.3 | v1.0.1 | [PASS] | — |
| 1.26.2 | v1.0.1 | [PASS] | — |
| 1.26.1 | v1.0.1 | [PASS] | — |
| 1.26.0 | v1.0.1 | [PASS] | — |
| 1.25.5 | v1.0.1 | [PASS] | — |
| 1.25.0 | v1.0.1 | [PASS] | — |
Note
Gitea 1.24.x 及更早版本使用不同的邮件模板布局，属于
[UNSUPPORTED]，Gitea Mail Templates 不再另外支持。v1.0.0 模板标签已由 v1.0.1 替代，不再单独推荐。
Gitea 历版本对邮件模板影响
此表描述 Gitea 的变化，不是本模板仓库的修复记录。“无”表示该 Gitea 版本没有新增相关邮件模板影响；推荐归档见上方兼容性表。
| Gitea | 发布日期 | 邮件模板变化 | 影响 |
|---|---|---|---|
| 28.1.0 | 2026-10-06 | [PENDING] | [PENDING] |
| 28.0.0 | 2026-09-29 | 邮件函数 FileSize 改为 FormatByteSize （PR） |
不兼容变更： 旧的发布附件模板失效 |
| 引入 templates/mail/base/ （PR） | **不兼容变更：**旧版本 Gitea 无法直接使用新版本邮件模板 | ||
| 1.27.3 | 2026-08-29 | 无 | 无 |
| 1.27.2 | 2026-08-14 | 无 | 无 |
| 1.27.1 | 2026-07-27 | 内置推送模板改用 .UserCommit.GitCommit（PR） |
不兼容变更：存在既有未修复缺陷 旧的自定义拉取请求推送模板可能失效 |
| 1.27.0 | 2026-07-13 | 推送提交数据移至 .UserCommit.GitCommit（ISSUE） |
不兼容变更： 旧的拉取请求推送模板失效 |
| 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） | 不兼容变更： 不支持更早的模板布局 |
| ≤ 1.24.x | — | 旧的自定义邮件布局 | [UNSUPPORTED] |
模板变量参考
各类邮件上下文由官方模板定义。开发时具体的邮件模板和函数和变量请参考官方邮件模板文档 1。
翻译键
官方模板引用 mail.* 和 actions.runs.attempt。基于 AST 的检查覆盖 .locale.Tr、$.locale.Tr 和 TrN 的两个复数键，包括嵌套管道。所有引用键必须存在于锁定的英文目录。