在 macOS 中安裝¶

硬體需求¶

Weblate 應該可以在任何現代硬體上正常執行，以下是在單一主機（Weblate、資料庫和 Web 伺服器）上執行 Weblate 所需的最低設定：

3 GB 記憶體
2 個 CPU 核心
1 GB 儲存空間

備註

根據 Weblate 中管理的翻譯大小，安裝 Weblate 的實際需求差異很大。

記憶體使用¶

記憶體越多越好——用於所有層級的快取（檔案系統，資料庫和 Weblate）。如果有幾百個翻譯元件，那麼建議的最小記憶體為 4 GB。

提示

對於記憶體低於建議值的系統，建議使用單行程 Celery 設定。

CPU 使用¶

大量並行使用者會提高需要的 CPU 核心數。

儲存空間使用¶

典型的資料庫儲存用量為大約 300 MB/每 100 萬託管字詞。

複製儲存庫所需的儲存空間會因情況而異，但 Weblate 會透過淺層複製來盡量降低所需空間。

節點¶

對中小網站（幾百萬託管字詞），所有的 Weblate 元件（見架構概覽）可以執行在單一節點上。

當託管字詞數增長到數以億計時，建議使用專門的資料庫節點（見適用於 Weblate 的資料庫設定）。

安裝¶

系統需求¶

安裝所需的相依套件以建立 Python 模組（請參閱軟體需求）：

brew install python libyaml pkgconf zstd lz4 xxhash libxmlsec1 uv

選用地安裝生產伺服器執行所需要的軟體，參閱執行伺服器、適用於 Weblate 的資料庫設定、使用 Celery 的背景工作。根據於您的安裝所佔的空間，您會想要在特定的伺服器上執行這些元件。

本機安裝說明：

# Web server option 1: NGINX and uWSGI
brew install nginx uwsgi

# Web server option 2: Apache with ``mod_wsgi``
brew install httpd

# Caching backend: Valkey
brew install valkey

# Database server: PostgreSQL
brew install postgresql

# Gettext tools for gettext POT/PO update add-ons
brew install gettext

Python 模組¶

提示

我們正在單獨的 Python 環境中安裝 Weblate。

為 Weblate 建立 Python 環境：
```
uv venv ~/weblate-env
```
為 Weblate 啟動 Python 環境：
```
. ~/weblate-env/bin/activate
```
安裝 Weblate，包括所有選用相依套件：
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
請檢視 Python 相依套件以瞭解對選用依賴關係的微調情況。

也參考

設定 Weblate¶

備註

以下內容假設 Weblate 使用的 Python 環境已經啟用（可以透過 . ~/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
```
提示

如果您之前丟失了 admin 密碼，可以使用以下指令產生一個新的 admin 密碼：
```
weblate createadmin --update
```
也參考

createadmin
為您的收集 Web 伺服器用的靜態檔案（請參閱執行伺服器和提供靜態檔案）：
```
weblate collectstatic
```
啟動 Celery 工作程序。這對開發來說是不必要的，但強烈建議在其他場景這樣做。更多資訊請參閱使用 Celery 的背景工作：
```
celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup
```
啟動開發伺服器（生產設定請參閱執行伺服器）：
```
weblate runserver
```

安裝後¶

恭喜，您的 Weblate 服務現在已上線了，您可以開始使用它。

您可以在 http://localhost:8000/ 存取 Weblate。
使用安裝期間獲得的管理憑證登入或註冊新使用者。
現在當 Weblate 的 Python 環境啟用時，您可以使用 weblate 來執行 Weblate 指令，請參閱管理指令。
您可以使用 Ctrl+C 停止測試的伺服器。
要檢查您安裝的潛在問題，有兩個途徑。一是 /manage/performance/ URL (參閱效能報告)，二是使用 weblate check --deploy，參閱生產設定。

新增翻譯¶

開啟管理介面（ http://localhost:8000/create/project/ ），並新增您想要翻譯的專案。更多細節請參閱專案設定。

這裡所有需要您指定的只是專案名稱及其網站。
建立一個元件，該元件是要翻譯的實際物件——它指向版本控制系統儲存庫，並選擇要翻譯的檔案。更多詳細資訊請參閱元件設定。

此處的重要欄位為：元件名稱、原始碼儲存庫及用於尋找可翻譯檔案的檔案遮罩。Weblate 支援多種格式，包括 GNU gettext PO (Portable Object)、Android 字串資源、蘋果 iOS 字串、Java properties、Stringsdict 格式或 Fluent 格式，更多細節見在地化檔案格式。
一旦完成上面的工作（根據您的版本控制系統 VCS 儲存庫的大小，以及需要翻譯的資訊數量，這可能是個漫長的過程），您就可以開始翻譯了。