发布 Weblate

发行周期

Weblate uses calendar versioning with monthly releases. The version format is <YEAR>.<MONTH>.<PATCH> with a numeric, non-zero-padded month. The <PATCH> part is omitted for the first release in a month when it would be 0, for example 2026.5. Patch releases use the full version number, for example 2026.5.1.

Monthly releases are usually published at the beginning of the month. Patch releases include bug fixes, security fixes, and dependency updates which should not wait for the next monthly release.

Direct upgrades are supported from releases in the current or previous calendar year. The first release in a new year drops direct upgrade support for releases from the year before the previous year.

Docker 容器包含额外的版本部件来跟踪容器本身变化，比如依赖项。即便在 Weblate 版本省略 0 补丁部件时，固定的 Docker 映像标签仍同时包含补丁部件和这个构建部件。这些更新可能包含安全更新。

参见

发布计划

即将发布版本的功能是通过 GitHub 里程碑收集的，可以在 <https://github.com/WeblateOrg/weblate/milestones> 上查看路线图。

发布过程

发布前要检查的事情：

  1. 通过 ./scripts/list-translated-languages.py 来检查新翻译的语言。

  2. 由 ./scripts/prepare-release 来设置最终版本。

  3. 确保屏幕截图是最新的 make -j 12 -C docs update-screenshots。

  4. 合并任何可能挂起的翻译 wlc push; git remote update; git merge origin/weblate

When building distribution packages locally, start from a clean checkout or remove ignored packaging artifacts such as build/, dist/, weblate.egg-info/, and generated weblate/locale/**/*.mo files.

执行发布：

  1. 创建一个发布 ./scripts/create-release --tag（要求请参见下面）。

手动发布步骤：

  1. 关闭 GitHub 里程碑。

  2. 一旦检测到 Docker 镜像，则添加标签并推送。

  3. 在 .github/workflows/migrations.yml 中包含新版本，以便在迁移测试中涵盖它。

  4. 通过 ./scripts/set-version.py 在仓库中增加版本。

  5. 检查 readthedocs.org 是否使用 ./scripts/rtd-projects.py。构建了文档的所有翻译。

要使用 ./scripts/create-release 脚本创建标签，需要：

  • 推送访问 Weblate git 仓库（它推送标签）