Установка из исходников

  1. Пожалуйста, прежде чем установить Weblate, следуйте инструкциям по установке для вашей системы:

  2. Получите из Git’а последние исходные коды Weblate’а (или скачайте архив и распакуйте его):

    git clone https://github.com/WeblateOrg/weblate.git weblate-src

    В качестве альтернативы вы можете использовать архивы выпусков. Вы можете скачать их с нашего сайта <https://weblate.org/>. Эти файлы подписаны криптографической подписью, пожалуйста, смотрите раздел Проверка артефактов выпуска.

  3. Установите текущий код Weblate в виртуальное окружение Python:

    . ~/weblate-env/bin/activate
uv pip install -e 'weblate-src[all]'

    Если вы намерены запускать набор тестов из исходной рабочей копии, установите зависимости разработки, как описано в Локальное тестирование Weblate.

  4. Скопируйте файл weblate/settings_example.py в weblate/settings.py.

  5. По своему усмотрению подкорректируйте значения в новом файле settings.py. Вам нужно будет предоставить как минимум учётные данные базы данных и секретный ключ Django, но для установки на рабочей системе вам понадобится больше изменений, смотрите больше в разделе Изменение конфигурации под свои нужды.

  6. Создайте используемую Weblate’ом базу данных, подробности смотрите в разделе Настройка базы данных для Weblate.

  7. Создайте Django’вские таблицы, соберите статические файлы и заполните исходные данные (смотрите разделы Наполнение базы данных и Обслуживание статических файлов):

    weblate migrate
weblate collectstatic

    Примечание

    Этот шаг следует повторять при обновлении репозитория.

Упаковка Weblate для дистрибутивов

Версии зависимостей в pyproject.toml описывают среду выполнения, протестированную проектом Weblate. Они намеренно строги для установок из PyPI и для процесса выпуска Weblate, поскольку Weblate не может проверять каждую комбинацию версий зависимостей, покрываемую более широкими диапазонами версий.

Пакеты дистрибутивов могут заменять эти пакеты Python на версии из набора пакетов дистрибутива. При этом запустите набор тестов Weblate против упакованного набора зависимостей и считайте успешное прохождение тестов сигналом совместимости для пакета дистрибутива.

Поддерживайте тесно связанные сопутствующие пакеты Weblate в синхронизации с выпуском Weblate:

Несовпадающие версии этих пакетов с большей вероятностью приведут к сбоям во время выполнения или при тестировании, чем другие замены зависимостей Python.

См. также

См. Локальное тестирование Weblate для настройки тестов и Цикл выпуска для периодичности выпусков Weblate.