Установлення з початкового коду

  1. Будь ласка, для встановлення Weblate спочатку виконайте настанови зі встановлення для вашої системи:

  2. Отримайте найсвіжіший код Weblate за допомогою Git (або отримайте архів з кодом і розпакуйте його):

    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]'
    

    If you intend to run the testsuite from the source checkout, install the development dependencies as described in Локальне тестування Weblate.

  4. Скопіюйте weblate/settings_example.py до weblate/settings.py.

  5. Скоригуйте значення у новому файлі settings.py відповідно до ваших уподобань. Вам доведеться надати принаймні реєстраційні дані для доступу до бази даних та закритий ключ Django, а також вам варто внести додаткові зміни для вашої промислової конфігурації, див. Коригування налаштувань.

  6. Створіть базу даних, яка використовуватиметься Weblate, див. Налаштування бази даних для Weblate.

  7. Побудуйте таблиці Django, статичні файли та початкові дані (див. Заповнення бази даних і Обслуговування статичних файлів):

    weblate migrate
    weblate collectstatic
    weblate compress
    

    Примітка

    Цей крок слід повторювати кожного разу, коли ви оновлюватимете сховище.

Packaging Weblate for distributions

The dependency versions in pyproject.toml describe the runtime environment tested by the Weblate project. They are intentionally strict for installs from PyPI and for the Weblate release process, because Weblate cannot validate every dependency-version combination covered by wider version ranges.

Distribution packages can replace those Python packages with versions from the distribution package set. When doing so, run Weblate’s test suite against the packaged dependency set and treat passing tests as the compatibility signal for the distribution package.

Keep Weblate’s tightly coupled companion packages in sync with the Weblate release:

Mismatched versions of these packages are more likely to break at runtime or during tests than other Python dependency substitutions.

Дивись також

See Локальне тестування Weblate for test setup and Цикл випуску for Weblate’s release cadence.