Weblate 用戶端

安裝

The Weblate Client is shipped separately and includes the Python module. To use the commands below, you need to install wlc using pip:

pip install wlc

You can also execute it directly using uvx:

uvx wlc --help

提示

You can also use this wlc as a Python module, see wlc.

Docker 使用

The Weblate Client is also available as a Docker image.

該圖像在Docker Hub上發佈：https://hub.docker.com/r/weblate/wlc

安裝中：

docker pull weblate/wlc

Docker 容器使用 Weblate 的預設設定並連線到位於 localhost 中部署的 API。API URL 和 API_KEY 可以通過 Weblate 接受的參數配置。

啟動容器的指令使用以下語法：

docker run --rm weblate/wlc [WLC_ARGS]

範例：

docker run --rm weblate/wlc --url https://hosted.weblate.org/api/ list-projects

You might want to pass your 配置檔案 to the Docker container, the easiest approach is to add your current directory as /home/weblate volume:

docker run --volume $PWD:/home/weblate --rm weblate/wlc show

開始使用

The wlc configuration is stored in ~/.config/weblate (see 配置檔案 for other locations), please create it to match your environment:

[weblate]
url = https://hosted.weblate.org/api/

[keys]
https://hosted.weblate.org/api/ = APIKEY

然後，您可以在預設伺服器上呼叫指令：

wlc ls
wlc commit sandbox/hello-world

也參考

配置檔案

舊式配置

在 1.17 版的變更: The legacy configuration using unscoped key is no longer supported.

遷移舊式配置：

[weblate]
url = https://hosted.weblate.org/api
key = YOUR_KEY_HERE

To a configuration with key scoped to an API URL:

[weblate]
url = https://hosted.weblate.org/api

[keys]
https://hosted.weblate.org/api = YOUR_KEY_HERE

概要

wlc [arguments] <command> [options]

指令實際上指示應該執行哪個操作。

描述

Weblate 用戶端是一個 Python 庫和命令列實用程式，可使用 Weblate 的 REST API 遠端管理 Weblate。命令列實用程式可以作為 wlc 呼叫，並且內建在 wlc 上。

參數

程式接受以下參數來定義輸出格式或使用哪個Weblate實例。這些參數必須位於任何指令之前。

--format {csv,json,text,html}

指定輸出格式。

--url URL

指定 API URL。覆寫在配置檔案中找到的任何值，請參見 配置檔案。該網址應以 /api/ 結尾，例如 https://hosted.weblate.org/api/。

--key KEY

指定要使用的 API 使用者金鑰。覆寫在配置檔案中找到的任何值，請參見 配置檔案。您可以在 Weblate 的個人資料中找到金鑰。

--config PATH

覆寫配置檔案路徑，請參見 配置檔案。

--config-section SECTION

覆寫正在使用的配置檔案部分，請參見 配置檔案。

指令

以下指令可用：

version

列印目前版本。

list-languages

列出 Weblate 中使用的語言。

list-projects

列出 Weblate 中的專案。

list-components

列出 Weblate 中的組件。

list-translations

列出 Weblate 中的翻譯。

show

顯示 Weblate 物件（翻譯、組件或專案）。

ls

列出 Weblate 物件（翻譯，組件或專案）。

commit

提交在 Weblate 物件（翻譯，組件或專案）中所做的變更。

pull

拉取遠端儲存庫的變更到 Weblate 對像中（翻譯，組件或專案）。

push

將 Weblate 物件變更推送到遠端儲存庫（翻譯，組件或專案）。

reset

重設 Weblate 物件中的變更以比對遠端儲存庫（翻譯、組件或專案）。

cleanup

刪除 Weblate 對像中所有未追蹤的變更以匹配遠端儲存庫（翻譯，組件或專案）。

repo

顯示給定 Weblate 物件（翻譯，組件或專案）的儲存庫狀態。

stats

顯示給定 Weblate 物件（翻譯，組件或專案）的詳細統計資料。

lock-status

顯示鎖定狀態。

lock

鎖定組件以防止在 Weblate 中進一步翻譯。

unlock

解鎖 Weblate 組件的翻譯。

changes

顯示給定物件的變更。

download

下載翻譯檔案。

--convert

轉換文件格式，如果未指定，則在伺服器上不進行任何轉換，並且將文件原樣下載到儲存庫中。

--output

指定要儲存輸出的文件，如果未指定，則將其列印到 stdout。

upload

上傳翻譯檔案。

--overwrite

上傳時覆寫現有翻譯。

--input

從中讀取內容的文件，如果未指定，則從 stdin 中讀取。

--method

Upload method to use, see 匯入方法.

--fuzzy

模糊 （標記為需要編輯）的字串處理（empty, process, approve）

--author-name

Author name, to override currently authenticated user

--author-email

Author e-mail, to override currently authenticated user

提示

You can get more detailed information on invoking individual commands by passing --help, for example: wlc ls --help.

配置檔案

.weblate, .weblate.ini, weblate.ini

Configuration file placed in the project directory.

C:\Users\NAME\AppData\Roaming\weblate.ini

User configuration file on Windows in the roamed profile.

C:\Users\NAME\AppData\Local\weblate.ini

User configuration file on Windows in the local profile.

~/.config/weblate

使用者配置檔案。

/etc/xdg/weblate

系統範圍配置檔案。

The program follows the XDG specification, so you can adjust the placement of config files by environment variables XDG_CONFIG_HOME or XDG_CONFIG_DIRS.

On Windows APPDATA and LOCALAPPDATA directories are the preferred locations for the configuration file.

可以在 [weblate] 部分中配置以下設定（您可以通過 --config-section 進行自訂）：

key

在 1.17 版被移除: Use the [keys] section to specify keys scoped for individual API URLs, see 舊式配置.

url

API 伺服器網址，預設為 http://127.0.0.1:8000/api/。

translation

預設翻譯的路徑 —— 組件或專案。

配置檔案是一個 INI 檔案，例如：

[weblate]
url = https://hosted.weblate.org/api/
translation = weblate/application

The API keys are stored in the [keys] section:

[keys]
https://hosted.weblate.org/api/ = APIKEY

This allows you to store keys in your personal settings, while using the .weblate configuration in the VCS repository so that wlc knows which server it should talk to.

環境變數

在 1.18.0 版被加入.

The API URL and key can also be configured using environment variables. This is especially useful for CI workflows:

WLC_URL

API URL

WLC_KEY

API 金鑰

The configuration precedence (highest to lowest) is:

1. Command-line arguments (--url, --key).

2. Environment variables (WLC_URL, WLC_KEY).

3. 配置檔案（請參見 配置檔案）。

範例

列印當前程式版本：

$ wlc version
version: 0.1

列出所有專案：

$ wlc list-projects
name: Hello
slug: hello
url: http://example.com/api/projects/hello/
web: https://weblate.org/
web_url: http://example.com/projects/hello/

上傳翻譯檔案：

$ wlc upload project/component/language --input /tmp/hello.po

You can also designate what project wlc should work on:

$ cat .weblate
[weblate]
url = https://hosted.weblate.org/api/
translation = weblate/application

$ wlc show
branch: main
file_format: po
source_language: en
filemask: weblate/locale/*/LC_MESSAGES/django.po
git_export: https://hosted.weblate.org/git/weblate/application/
license: GPL-3.0+
license_url: https://spdx.org/licenses/GPL-3.0+
name: Application
new_base: weblate/locale/django.pot
project: weblate
repo: git://github.com/WeblateOrg/weblate.git
slug: application
template:
url: https://hosted.weblate.org/api/components/weblate/application/
vcs: git
web_url: https://hosted.weblate.org/projects/weblate/application/

通過此設定，可以輕鬆地提交目前專案中待定的變更：

$ wlc commit