ソースからインストール

  1. Weblate をインストールする前に、事前準備を行ってください。各システム用のインストール方法:

  2. Git で最新の Weblate のソースを取得(または tarball をダウンロードして解凍)する:

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

    あるいは、リリースしたアーカイブを使用します。Web サイト <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.pyweblate/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.