Створення випусків 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.

Дивись також

Планування випусків

Можливості нових випусків збираються у етапах (milestones) 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 вам знадобиться:

  • Доступ до запису змін до сховищ git Weblate (скрипт записує мітки)