வலைபெயர்ப்பு கிளையன்ட்

நிறுவல்

The Weblate Client is shipped separately and includes the Python module. The source code is maintained in the WeblateOrg/wlc repository. To use the commands below, you need to install wlc using pip:

pip install wlc

நீங்கள் அதை நேரடியாக uvx பயன்படுத்தி இயக்கலாம்:

uvx wlc --help

Hint

நீங்கள் இந்த wlc ஐ பைதான் தொகுதியாகவும் பயன்படுத்தலாம், பார்க்க wlc.

கப்பல்துறை பயன்பாடு

வலைபெயர்ப்பு வாங்கி ஒரு கப்பல்துறை படமாகவும் கிடைக்கிறது.

Images are published on Docker Hub and the GitHub Container Registry. The examples below use the Docker Hub image name.

நிறுவுகிறது:

docker pull weblate/wlc

The following tags are available:

latest

Latest stable release.

Full version, for example 2.2.0

A specific stable release.

Major version, for example 2

Latest stable release in that major series.

edge

Current development version from the main branch.

edge-YYYY-MM-DD-COMMIT

A specific development snapshot.

To build an image from the source checkout:

docker build -t weblate/wlc .

The Docker container uses Weblate Client defaults and connects to the API deployed on localhost. Configure the API URL and API key using the normal wlc arguments or environment variables, for example --url, --key, WLC_URL, and WLC_KEY. API keys are rejected over non-local http:// URLs by default; use HTTPS, loopback HTTP for local development, or explicitly opt in to insecure HTTP.

கொள்கலனைத் தொடங்குவதற்கான கட்டளை பின்வரும் தொடரியல் பயன்படுத்துகிறது:

docker run --rm weblate/wlc [WLC_ARGS]

உதாரணமாக:

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

நீங்கள் உங்கள் உள்ளமைவு கோப்புகள் ஐ கப்பல்துறை கொள்கலனுக்கு அனுப்ப விரும்பலாம். உங்கள் களஞ்சியத்தில் .weblate போன்ற திட்ட கட்டமைப்பு இருந்தால், உங்கள் தற்போதைய கோப்பகத்தை /home/weblate தொகுதியாக சேர்ப்பதே எளிதான வழி:

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

When the mounted repository provides the API URL in project configuration and you pass an unscoped API key to the container, also pin the URL explicitly: WLC_KEY requires WLC_URL, and --key requires --url. The same pairing is required for the --allow-insecure-http and --allow-insecure-ssl overrides.

If the configured API URL uses non-local http:// and an API key is provided, the container refuses to send the key unless insecure HTTP is explicitly enabled. Prefer HTTPS; for legacy deployments, pass --allow-insecure-http or set WLC_ALLOW_INSECURE_HTTP. TLS certificates are always verified by default, including for loopback URLs. Use --allow-insecure-ssl or WLC_ALLOW_INSECURE_SSL only when certificate verification can not be enabled.

தொடங்குதல்

தொடங்குவதற்கான எளிதான வழி, தனிப்பட்ட wlc உள்ளமைவை ~/.config/weblate இல் உருவாக்குவது (முழு கண்டுபிடிப்பு விதிகள் மற்றும் பிற இடங்களுக்கு உள்ளமைவு கோப்புகள் ஐப் பார்க்கவும்):

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

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

இயல்புநிலை சேவையகத்தில் கட்டளைகளை நீங்கள் அழைக்கலாம்:

wlc ls
wlc commit sandbox/hello-world

See also

உள்ளமைவு கோப்புகள்

மரபு கட்டமைப்பு

Changed in version 1.17: வரம்பிடாத திறவுகோல் யைப் பயன்படுத்தும் மரபு உள்ளமைவு இனி ஆதரிக்கப்படாது.

Changed in version 2.2.0: Global allow_insecure_http configuration is no longer supported. Configure an origin in the [insecure_http] section instead.

மரபு உள்ளமைவை நகர்த்தவும்:

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

பநிஇ முகவரி க்கு விசையைக் கொண்டுள்ள கட்டமைப்பிற்கு:

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

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

சுருக்கம்

wlc [arguments] <command> [options]

கட்டளைகள் உண்மையில் எந்த செயல்பாட்டைச் செய்ய வேண்டும் என்பதைக் குறிக்கின்றன.

விளக்கம்

Weblate Client is a Python library and command-line utility to manage Weblate remotely using வலைபெயர்ப்பு ரெச்ட் பநிஇ. Invoke the command-line utility as wlc; see wlc for the Python API.

வாதங்கள்

வெளியீட்டு வடிவமைப்பை வரையறுக்கும் அல்லது பயன்படுத்த வேண்டிய வலைபெயர்ப்பு உதாரணத்தை நிரல் பின்வரும் வாதங்களை ஏற்றுக்கொள்கிறது. எந்தவொரு கட்டளைக்கும் முன் இவை உள்ளிடப்பட வேண்டும்.

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

Specify the output format. The default is text.

--version

Print the program version and exit. The version command supports output formatting and can print only the version number.

--debug

Print verbose HTTP communication. Authorization header values are redacted and request bodies are not logged, but query parameters are; do not put secrets in query parameters.

--url URL

பநிஇ முகவரி ஐக் குறிப்பிடவும். உள்ளமைவு கோப்பில் காணப்படும் எந்த மதிப்பையும் மேலெழுதுகிறது, பார்க்கவும் உள்ளமைவு கோப்புகள். முகவரி ஆனது /api/ உடன் முடிவடைய வேண்டும், எடுத்துக்காட்டாக https://hosted.weblate.org/api/.

--key KEY

Specify the API user key to use. Overrides any value found in the configuration file, see உள்ளமைவு கோப்புகள். You can find your key in your profile on Weblate. When the API URL is loaded from automatically discovered project configuration, --key must be used together with --url. API keys are rejected over non-local http:// URLs by default.

--allow-insecure-http

Allow sending API keys over non-local http:// URLs. Prefer HTTPS or loopback HTTP instead; this option is intended only for legacy deployments where HTTPS is not available. This option only enables insecure HTTP for the current run. When the API URL comes from automatically discovered project configuration, this option requires --url.

--allow-insecure-ssl

Disable TLS certificate verification for the current run. Certificates are verified by default for every HTTPS URL, including loopback URLs. When the API URL comes from automatically discovered project configuration, this option requires --url.

--config PATH

கண்டறியப்பட்ட உலகளாவிய மற்றும் திட்ட உள்ளமைவு கோப்புகளுக்குப் பதிலாக PATH இலிருந்து மட்டுமே உள்ளமைவை ஏற்றவும், பார்க்கவும் உள்ளமைவு கோப்புகள்.

--config-section SECTION

Selects the configuration file section to use instead of [weblate], see உள்ளமைவு கோப்புகள்.

Object paths

Commands that operate on an object accept one of these paths:

PROJECT

Project slug.

PROJECT/COMPONENT

Component slug, including its project.

PROJECT/COMPONENT/LANGUAGE

Translation language, including its project and component.

UNIT_ID

Numeric translation unit ID. Only commands that explicitly support units accept this form.

Commands that require an object use the translation setting from உள்ளமைவு கோப்புகள் when the path is omitted. The ls and download commands also use this setting before falling back to their no-object behavior. For list-components and list-translations, an omitted object always requests an instance-wide list.

கட்டளைகள்

பின்வரும் கட்டளைகள் கிடைக்கின்றன:

version

தற்போதைய பதிப்பை அச்சிடுகிறது.

--bare

Prints only the version number.

list-languages

Lists all languages in Weblate.

list-projects

Lists all projects in Weblate.

list-components

Lists all components in Weblate, or components in the specified project.

list-translations

Lists all translations in Weblate, or translations in the specified component.

list-units

Lists units in the specified translation.

--query QUERY

Filters units using the search query syntax.

show

Shows a project, component, translation, or unit.

delete

Deletes a project, component, translation, or unit without a confirmation prompt.

ls

Lists all projects when no object is specified, components in a project, or translations in a component.

commit

வலைபெயர்ப்பு பொருளில் (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) செய்யப்பட்ட மாற்றங்களைச் செய்கிறது.

pull

தொலை களஞ்சிய மாற்றங்களை வலைபெயர்ப்பு பொருளாக (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) இழுக்கிறது.

push

வலைபெயர்ப்பு பொருள் மாற்றங்களை தொலை களஞ்சியத்தில் (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) தள்ளுகிறது.

reset

தொலைநிலை களஞ்சியத்தை (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) பொருத்த வலைபெயர்ப்பு பொருளின் மாற்றங்களை மீட்டமைக்கிறது.

cleanup

தொலைதூர களஞ்சியத்தை (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) பொருத்த ஒரு வலைபெயர்ப்பு பொருளின் தடையற்ற மாற்றங்களை நீக்குகிறது.

repo

கொடுக்கப்பட்ட வலைபெயர்ப்பு பொருளுக்கான களஞ்சிய நிலையைக் காட்டுகிறது (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்).

stats

கொடுக்கப்பட்ட வலைபெயர்ப்பு பொருளுக்கான விரிவான புள்ளிவிவரங்களைக் காட்டுகிறது (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்).

lock-status

Displays the lock status of a component.

lock

வலைபெயர்ப்பில் மேலும் மொழிபெயர்ப்பிலிருந்து கூறு பூட்டுகிறது.

unlock

வலைபெயர்ப்பு கூறுகளின் மொழிபெயர்ப்பைத் திறக்கும்.

changes

Displays changes for a project, component, or translation.

download

Downloads translation files. For a translation, wlc writes the file to --output or to redirected standard output. It refuses to write raw file content to an interactive terminal.

For a component or project, --output is required and is treated as a directory. wlc writes one ZIP archive per component. With no object, it downloads every component in the Weblate instance in the same way.

--convert FORMAT

Requests conversion to FORMAT on the server. If unspecified, no conversion happens.

--output PATH

Specifies the output file for a translation or output directory for a component, project, or instance-wide download. Use - to write a translation to standard output.

--no-glossary

Excludes glossary components from component, project, and instance-wide downloads.

upload

மொழிபெயர்ப்பு கோப்பை பதிவேற்றுகிறது.

--overwrite

Overwrites existing translated strings. This is equivalent to --conflicts replace-translated.

--conflicts {ignore,replace-translated,replace-approved}

Selects how conflicts with existing translations are handled.

--input PATH

Reads content from PATH. If unspecified or -, content is read from standard input.

--method {translate,approve,suggest,fuzzy,replace,source,add}

Upload method to use, see இறக்குமதி முறைகள். The default is translate.

--fuzzy {process,approve}

Selects processing of fuzzy strings (marked for edit).

--author-name NAME

ஆசிரியரின் பெயர், தற்போது அங்கீகரிக்கப்பட்ட பயனரை மீறுவதற்கு

--author-email EMAIL

தற்போது அங்கீகரிக்கப்பட்ட பயனரை மேலெழுத ஆசிரியர் மின்னஞ்சல்

edit-unit

Updates a translation unit. At least one update option is required.

--target TARGET [TARGET ...]

Sets one or more translated strings.

--state STATE

Sets the unit state: 0 for empty, 10 for fuzzy, 20 for translated, or 30 for approved.

--explanation EXPLANATION

Sets the string explanation.

--extra-flags FLAGS

Sets additional string flags.

Hint

--help ஐக் கடப்பதன் மூலம் தனிப்பட்ட கட்டளைகளை செயல்படுத்துவது பற்றிய விரிவான தகவல்களைப் பெறலாம், எடுத்துக்காட்டாக: wlc ls --help.

உள்ளமைவு கோப்புகள்

--config வழங்கப்பட்டால், wlc அந்தக் கோப்பை மட்டும் ஏற்றுகிறது.

--config இல்லாமல், wlc கண்டறியப்பட்ட உலகளாவிய உள்ளமைவு கோப்பை முதலில் நிலையான இயங்குதளம் சார்ந்த இடங்களிலிருந்து ஏற்றுகிறது:

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

ரோம் செய்யப்பட்ட சுயவிவரத்தில் சாளரங்களில் உலகளாவிய உள்ளமைவு கோப்பு.

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

உள்ளக சுயவிவரத்தில் சாளரங்கள் இல் உலகளாவிய கட்டமைப்பு கோப்பு.

~/.config/weblate

யூனிக்ச் போன்ற கணினிகளில் உலகளாவிய கட்டமைப்பு கோப்பு.

~/.config/weblate.ini

Alternative global configuration filename on Unix-like systems.

/etc/xdg/weblate

சிச்டம் முழுவதும் ஃபால்பேக் உள்ளமைவு கோப்பு.

/etc/xdg/weblate.ini

Alternative system-wide fallback filename.

நிரல் XDG விவரக்குறிப்பைப் பின்பற்றுகிறது, எனவே நீங்கள் சூழல் மாறிகள் XDG_CONFIG_HOME அல்லது XDG_CONFIG_DIRS மூலம் கட்டமைப்பு கோப்புகளின் இடத்தை சரிசெய்யலாம்.

சாளரங்கள் இல் APPDATA மற்றும் LOCALAPPDATA கோப்பகங்கள் உள்ளமைவு கோப்பிற்கான விருப்பமான இடங்களாகும்.

உலகளாவிய உள்ளமைவை ஏற்றிய பிறகு, wlc தற்போதைய கோப்பகத்திலிருந்து அல்லது அதன் பெற்றோரிடமிருந்து அருகிலுள்ள திட்ட கட்டமைப்பு கோப்பை ஏற்றுகிறது:

.weblate, .weblate.ini, weblate.ini

திட்ட கட்டமைப்பு கோப்பு களஞ்சியத்தில் வைக்கப்பட்டுள்ளது.

Project configuration is loaded after global configuration and overrides matching settings. It can select the API URL, default object, request settings, and a matching URL-scoped API key, allowing a cloned repository to automatically select its Weblate server and translation.

மிக நெருக்கமான திட்ட கட்டமைப்பு கோப்பு மட்டுமே ஏற்றப்பட்டது. தொலைதூர பெற்றோர் கோப்பகங்களில் உள்ள கட்டமைப்பு கோப்புகள் புறக்கணிக்கப்படுகின்றன.

பின்வரும் அமைப்புகளை [weblate] பிரிவில் உள்ளமைக்க முடியும் (இதை நீங்கள் --config-section மூலம் தனிப்பயனாக்கலாம்):

key

Removed in version 1.17: தனிப்பட்ட பநிஇ URLகளுக்கான விசைகளைக் குறிப்பிட [விசைகள்] பிரிவைப் பயன்படுத்தவும், பார்க்கவும் மரபு கட்டமைப்பு.

url

பநிஇ சர்வர் URL, இயல்புநிலையாக http://127.0.0.1:8000/api/.

translation

Default object path for commands that accept one: a project, component, translation, or numeric unit ID.

retries, timeout, allowed_methods, backoff_factor, status_forcelist

HTTP request retry and timeout settings. retries defaults to 0 and backoff_factor to 0. status_forcelist is a comma-separated list of HTTP status codes that trigger retries and is empty by default.

allowed_methods lists methods that may be retried, separated by commas or whitespace. It defaults to HEAD, DELETE, OPTIONS, PUT, and GET. These retry settings are passed to urllib3.util.Retry.

timeout is the request timeout in seconds and defaults to 300. Current wlc releases use allowed_methods in place of the older method_whitelist option.

உள்ளமைவு கோப்பு ஒரு இனி கோப்பு, எடுத்துக்காட்டாக:

[weblate]
url = https://hosted.weblate.org/api/
translation = weblate/application
retries = 3
allowed_methods = PUT,POST,GET
backoff_factor = 0.2
status_forcelist = 429,500,502,503,504
timeout = 30

பநிஇ விசைகள் [விசைகள்] பிரிவில் சேமிக்கப்படுகின்றன:

[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. The [keys] lookup is scoped to the complete configured API URL, not merely its network origin.

Project configuration can also supply or replace a matching entry in [keys]. Do not commit valuable API keys to version control; normally keep keys in personal configuration and only the API URL and default object in project configuration.

Insecure transport exceptions are stored in origin-scoped sections in trusted user configuration:

[insecure_http]
http://legacy.example.com:80 = true

[insecure_ssl]
https://legacy.example.com:443 = true

An origin consists of the scheme, normalized hostname, and effective port. The API path is ignored, while different schemes and ports remain isolated. The [insecure_http] section allows API keys over non-local HTTP for matching origins. The [insecure_ssl] section disables TLS certificate verification for matching origins.

Changed in version 2.2.0: TLS certificates are verified for all hosts by default. Insecure HTTP and TLS configuration is scoped to origins. Automatically discovered project configuration can neither add entries to these sections nor enable the removed global settings. User configuration and explicitly selected --config files are trusted.

In CI, unscoped keys must pin the API URL explicitly: set both WLC_URL and WLC_KEY, or use --url together with --key.

சுற்றுச்சூழல் மாறிகள்

Added in version 1.18.0.

Changed in version 2.0.1: Unscoped API keys require an explicit API URL when project configuration is discovered automatically. API keys are rejected over non-local http:// URLs unless insecure HTTP is explicitly enabled.

Changed in version 2.2.0: Insecure HTTP and TLS environment overrides require WLC_URL when the API URL would otherwise come from automatically discovered project configuration.

The API URL and key can also be configured using environment variables. This is especially useful for CI workflows where WLC_URL pins the destination and WLC_KEY is injected as a secret:

WLC_URL

பநிஇ முகவரி

WLC_KEY

API key. When the API URL would otherwise come from automatically discovered project configuration, WLC_KEY is accepted only together with WLC_URL. API keys are rejected over non-local http:// URLs by default.

WLC_ALLOW_INSECURE_HTTP

Set to 1, true, yes, or on to allow API keys over non-local http:// URLs. Prefer HTTPS or loopback HTTP instead. Other values, such as 0 or false, are treated as unset. When the API URL would otherwise come from automatically discovered project configuration, this variable is accepted only together with WLC_URL.

WLC_ALLOW_INSECURE_SSL

Set to 1, true, yes, or on to disable TLS certificate verification. Other values, such as 0 or false, are treated as unset. When the API URL would otherwise come from automatically discovered project configuration, this variable is accepted only together with WLC_URL.

The same protection applies to command-line arguments: --key, --allow-insecure-http, and --allow-insecure-ssl are accepted with automatically discovered project configuration only when --url is provided.

The API URL and key configuration precedence (highest to lowest) is:

1. கட்டளை வரி வாதங்கள் (--url, --key).

2. சுற்றுச்சூழல் மாறிகள் (WLC_URL, WLC_KEY).

3. உள்ளமைவு --config இலிருந்து ஏற்றப்பட்டது, அல்லது கண்டுபிடிக்கப்பட்ட உலகளாவிய உள்ளமைவிலிருந்து மற்றும் --config பயன்படுத்தப்படாதபோது அருகிலுள்ள திட்ட உள்ளமைவு.

The insecure transport opt-ins are enable-only rather than normal precedence settings. They are enabled by a command-line or environment override, or by a matching origin in the trusted [insecure_http] or [insecure_ssl] section. Automatically discovered project configuration cannot add trusted origins.

Security model

Project configuration is part of the repository workflow and is intentionally trusted to select the API endpoint, default object, request settings, and a matching URL-scoped API key. Running wlc inside a repository authorizes its nearest project configuration to select the server that receives commands and uploads and supplies displayed or downloaded content. Use an explicit trusted --config file when this is not desired.

The command-line client accepts API keys from --key, WLC_KEY, or the [keys] section. It does not load HTTP authentication from .netrc or the file named by NETRC. Credentials embedded in API URLs are rejected; use an API key instead. Other Requests environment integration, including proxy and CA-bundle variables, remains enabled.

The wlc threat model documents the complete trust boundaries, security properties, non-goals, and downstream responsibilities. A version-matched copy is included in source and wheel distributions. Report security issues using the Weblate vulnerability reporting process.

எடுத்துக்காட்டுகள்

தற்போதைய நிரல் பதிப்பை அச்சிடுக:

$ wlc version

அனைத்து திட்டங்களையும் பட்டியலிடுங்கள்:

$ 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

நீங்கள் எந்த திட்டத்தில் wlc வேலை செய்ய வேண்டும் என்பதையும் குறிப்பிடலாம்:

$ 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