Выпуск новых версий Weblate

Цикл выпуска

Weblate использует календарное версионирование с ежемесячными выпусками. Формат версии — <ГОД>.<МЕСЯЦ>.<ПАТЧ> с числовым месяцем без ведущих нулей. Часть <ПАТЧ> опускается для первого выпуска в месяце, когда она была бы 0, например 2026.5. Патч-выпуски используют полный номер версии, например 2026.5.1.

Ежемесячные выпуски обычно публикуются в начале месяца. Патч-выпуски включают исправления ошибок, исправления безопасности и обновления зависимостей, которые не должны ждать следующего ежемесячного выпуска.

Прямые обновления поддерживаются для выпусков текущего или предыдущего календарного года. Первый выпуск в новом году прекращает прямую поддержку обновлений для выпусков года, предшествующего предыдущему.

Docker-контейнер включает дополнительный компонент версии для отслеживания изменений в самом контейнере, таких как зависимости. Фиксированные теги образов Docker включают компонент патча вместе с этим компонентом сборки, даже если версия Weblate опускает компонент патча 0. Эти обновления могут включать обновления безопасности.

Планирование выпусков

Список исправленных ошибок и новых возможностей для предстоящего выпуска собирается с помощью целей выпуска (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. Закрыть целевую версию (milestone) на GitHub.

  2. Как только образ докер будет проверен, добавить метку и загрузить его.

  3. Добавить новую версию в .github/workflows/migrations.yml, чтобы миграция на неё покрывалась тестами.

  4. Повысьте версию в репозитории с помощью ./scripts/set-version.py.

  5. Убедитесь, что readthedocs.org выполнил все переводы документации, используя ./scripts/rtd-projects.py.

Чтобы создать метки с помощью скрипта ./scripts/create-release. Вам понадобится:

  • Доступ на отправку изменений в git-репозиторий Weblate (он отправляет метки)