Debian と Ubuntu にインストール¶

ハードウェア要件¶

Weblate should run on any contemporary hardware without problems, the following is the minimal configuration required to run Weblate on a single host (Weblate, database and web server):

3 GB の RAM
2 CPU コア
1 GB の記憶容量（HDD or SSD）

注釈

実際に必要な Weblate のインストールの要件は、Weblate で管理する翻訳のサイズによって大きく変化します。

Memory usage¶

The more memory the better - it is used for caching on all levels (file system, database and Weblate). For hundreds of translation components, at least 4 GB of RAM is recommended.

ヒント

メモリが推奨よりも少ないシステムの場合は、シングルプロセス Celery の設定を推奨します。

CPU usage¶

Many concurrent users increase the amount of needed CPU cores.

Storage usage¶

The typical database storage usage is around 300 MB per 1 million hosted words.

Storage space needed for cloned repositories varies, but Weblate tries to keep their size minimal by doing shallow clones.

Nodes¶

For small and medium-sized sites (millions of hosted words), all Weblate components (see アーキテクチャの概要) can be run on a single node.

When you grow to hundreds of millions of hosted words, it is recommended to have a dedicated node for database (see Weblate のデータベース設定).

インストール¶

システム要件¶

Python モジュールのビルドの依存関係をインストールする（参照: ソフトウェア要件）:

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 gir1.2-rsvg-2.0 libgirepository1.0-dev \
   libacl1-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev python3-pip python3-virtualenv virtualenv git

使用する機能に応じて、必要なオプションの依存関係をインストールする（参照: Python の依存関係）:

apt install -y \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

必要に応じて、運用サーバーを実行するためのソフトウェアをインストールします（参照: 実行サーバー、Weblate のデータベース設定、Celery を使用するバックグラウンドタスク）。インストールの規模によっては、これらのコンポーネントを専用サーバーで実行することが必要となります。

ローカルへのインストール手順:

# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3

# Caching backend: Redis
apt install -y redis-server

# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib

# SMTP server
apt install -y exim4

# Gettext for the msgmerge add-on
apt install -y gettext

Python モジュール¶

ヒント

Weblate をシステムから独立した環境にインストールするために、virtualenv を使用します。使い慣れていない場合は、virtualenv User Guide を確認してください。

Weblate 用の virtualenv を作成する:
```
virtualenv ~/weblate-env
```
Weblate 用の virtualenv を有効にする:
```
. ~/weblate-env/bin/activate
```
オプションの依存関係も含めて Weblate をインストールする:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
オプションの依存関係の詳細設定については、Python の依存関係を確認してください。
注釈

一部の Linux ディストリビューションで Weblate を実行すると libffi のエラーで失敗します:
```
ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)
```
これは、PyPI を介して配布されるバイナリパッケージとディストリビューションとの互換性がないことが原因です。これに対処するために必要な、システムでのパッケージの再構築方法:
```
pip install --force-reinstall --no-binary :all: cffi
```

Weblate の設定¶

注釈

以下の手順は、Weblate で使用する virtualenv が有効であることを前提としています（. ~/weblate-env/bin/activate を実行した結果）。無効の場合は、weblate コマンドへのフルパス（~/weblate-env/bin/weblate）の指定が必要です。

~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py を ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py にコピーする。
新しい settings.py ファイルの設定値を、必要に応じて変更する。少なくともデータベースの資格情報と Django 秘密鍵の設定が必要ですが、運用環境の初期設定には、さらに多くの変更が必要です。参照: 詳細設定。
Weblate 用のデータベースと構造を作成する（設定例では、PostgreSQL を使用する。Weblate のデータベース設定で運用環境に対応した初期設定を確認する）:
```
weblate migrate
```
参考

migrate
管理者ユーザーアカウント admin を作成し、そのパスワードを生成してクリップボードにコピーし、後で使用するために忘れずに保存:
```
weblate createadmin
```
ヒント

以前に管理者パスワードを見逃したり失くしたりした場合、新しいパスワードを生成するコマンド:
```
weblate createadmin --update
```
参考

createadmin
Web サーバーの静的ファイルを収集する（参照: 実行サーバー、静的ファイルの提供）:
```
weblate collectstatic
```
JavaScript ファイルと CSS ファイルを圧縮する（省略可能、参照: クライアントアセットの圧縮）:
```
weblate compress
```
Celery ワーカーを起動する。開発目的であれば必要ないが、運用サーバーであれば必ず起動すること。詳細については、 Celery を使用するバックグラウンドタスクを確認:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
開発サーバーを起動する（運用サーバーの設定については、実行サーバーを確認）:
```
weblate runserver
```

インストール後¶

おめでとうございます。Weblate サーバーは稼働したので、使用を開始してください。

http://localhost:8000/ から、Weblate にアクセスできます。
インストール時に取得した管理者としてサインインするか、新規ユーザーとして登録します。
Weblate virtualenv が有効な場合は、weblate コマンドを使用して Weblate コマンドを実行できるように変更されました。
Ctrl+C を使用してテストサーバーを停止できます。
/manage/performance/ URL（参照: 性能レポート）または weblate check --deploy を使用して、インストールの潜在的な問題を確認してください。参照: 運用環境の設定。

翻訳を追加する¶

管理画面（http://localhost:8000/create/project/）から、翻訳するプロジェクトを作成します。詳細についはプロジェクトの設定を確認してください。

ここで必要な指定は、プロジェクト名とその Web サイトだけです。
実際の翻訳用のオブジェクトであるコンポーネントを作成します。コンポーネントは VCS リポジトリの場所を特定し、翻訳するファイルを選択します。詳細は、コンポーネント構成を確認してください。

ここで重要な項目はコンポーネント名、ソースコードのリポジトリ、および翻訳可能なファイルを検索するためのファイルマスクです。Weblate は、GNU gettext PO (Portable Object)、Android 文字列リソース、Apple iOS 文字列、Java プロパティ、Stringsdict 形式、Fluent 形式など、幅広い形式に対応しています。詳細については、対応するファイル形式を確認してください。
上記の作業が完了したら（VCS リポジトリのサイズや翻訳するメッセージの数により、処理に時間がかかります)、翻訳を開始できます。