發佈 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.

The Docker container includes an additional version component to track changes in the container itself, such as dependencies. Fixed Docker image tags include the patch component together with this build component, even when the Weblate version omits a 0 patch component. These updates may include security updates.

也參考

發佈計劃¶

到來的版本的特性使用 Github 里程碑來收集，可以在 <https://github.com/WeblateOrg/weblate/milestones> 看到路線圖。

發佈過程¶

發佈前要檢查的事情：

Check newly translated languages by ./scripts/list-translated-languages.py.
由 ./scripts/prepare-release 來設定最終版本。
Make sure screenshots are up to date make -j 12 -C docs update-screenshots.
合併任何可能掛起的翻譯 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.

執行發佈：

建立一個發佈 ./scripts/create-release --tag （需求請參閱下面）。

張貼發佈手動步驟：

管理 GitHub 里程碑。
一旦檢測到 Docker 圖像，則新增標籤並推送。
在 .github/workflows/migrations.yml 中包含新的版本，從而在合併監測中覆寫它。
由 ./scripts/set-version.py 在儲存庫中增加版本。
Check that readthedocs.org did build all translations of the documentation using ./scripts/rtd-projects.py.

要使用 ./scripts/create-release 指令碼來建立標記的話，需要後面的：

推送存取 Weblate git 儲存庫（它推送標記）